팀이 처음 Claude Code를 공유하려 할 때, 누군가 공유 API key를 만들어 Slack에 올립니다. 일주일은 잘 됩니다. 그러다 누가 얼마를 썼는지 알 수 없는 청구서가 도착하고, 팀원이 떠나면서 key를 곳곳에서 교체해야 하고, rate limit은 모두가 함께 소진하는 하나의 버킷이 됩니다.
대안은 “협업 없음”이 아닙니다. 함께 묶여 버린 두 가지, 즉 공유 워크스페이스와 모델 자격 증명을 분리하는 것입니다. 워크스페이스는 공유해야 하고, 자격 증명은 개인으로 남아야 합니다.
공유 API key가 팀에 실패하는 이유
- 귀속이 사라집니다. 모든 요청이 같은 계정으로 보이므로 누가 예산을 태우는지, 어떤 프로젝트가 비싼지 알 수 없습니다.
- 오프보딩이 소동이 됩니다. 한 사람이 떠나면 모든 머신, CI job, 스크립트에서 key를 찾아 교체해야 합니다.
- rate limit이 공유됩니다. 폭주하는 에이전트 하나가 남은 기간 동안 팀 전체를 막을 수 있습니다.
- 보안이 전부 아니면 전무입니다. key를 가진 사람은 어디서든 쓸 수 있고, 유출은 추적하기 어렵습니다.
- 청구가 일하는 사람과 분리됩니다. 카드 소유자는 이번 달 비용을 설명할 수 없습니다.
공유 Claude 로그인도 같은 모양의 문제에 session 충돌이 더해집니다. 같은 계정을 쓰는 두 사람이 서로의 인증을 무효화하거나 같은 사용량 구간을 두고 다툴 수 있습니다.
자격 증명이 아니라 워크스페이스를 공유하세요
좋은 팀 설정에는 네 가지 속성이 있습니다. 각 팀원이 자기 identity와 자기 모델 구독을 가집니다. 팀은 프로젝트, worktree, session을 공유합니다. 접근 권한은 사람별로 부여하고 사람별로 회수할 수 있습니다. 그리고 작업은 vendor의 블랙박스가 아니라 팀이 통제하는 호스트에서 실행됩니다.
Nethür는 이 분리를 중심으로 만들어졌습니다. 워크스페이스 서버와 client 구조입니다. 서버가 프로젝트, worktree, terminal, 에이전트, 채팅, 노트, 콘텐츠를 소유하고 desktop app, browser, phone은 client입니다. 모델 접근은 각자가 이미 내는 구독에 남습니다.
Claude Code 팀 워크스페이스 설정하기
- 호스트를 고릅니다. VPS, 홈 서버, 사무실 Mac mini, 팀원의 상시 켜진 머신 모두 됩니다. 호스트에는 git, 에이전트 CLI, 모델 제공자에 대한 네트워크 접근이 필요합니다. Nethür 실행 방법을 참고하세요.
- 그 호스트에 Nethür를 설치하고 서버를 시작합니다. 작은 팀이라면 desktop app이 백그라운드에서 서버를 실행할 수 있고, 상시 운영이라면 전용 호스트를 쓰고 browser에서 접속하세요.
- 워크스페이스를 만들고 팀이 공유하는 저장소를 가져옵니다. 프로젝트가 접근의 단위입니다. 멤버는 초대받은 프로젝트만 보고, 머신의 모든 checkout을 보지는 않습니다.
- 팀원을 이메일로 초대하고 프로젝트에 배정합니다. seat는 초대된 멤버입니다. 청구는 서버나 동시 session이 아니라 seat 기준입니다.
- 각자가 호스트에서 자기 Claude 계정으로 로그인하게 하거나, 앱을 통해 자기 계정을 연결합니다. Nethür는 기존
~/.claude설정을 읽고 계정별 사용량을 추적합니다. 공유 key는 만들어지지 않습니다. - 작업마다 worktree를 만들고 그 안에서 Claude Code를 실행합니다. 에이전트는 호스트에서 실행되고, 팀원은 browser나 desktop app에서 같은 worktree를 열 수 있습니다.
- 팀 규칙을 정합니다. branch 이름 규칙, 누가 어떤 worktree를 리뷰하는지, 언제 session을 인계하는지, 어떤 프로젝트에서 자율 에이전트를 허용하는지.
정확한 메뉴는 팀 채팅 문서와 원격 서버 문서에 있습니다. 중요한 점은 4단계와 5단계가 분리되어 있다는 것입니다. 멤버십은 워크스페이스 결정이고, 모델 접근은 개인 결정입니다.
일상의 협업은 어떻게 보이는가
- 팀 채팅이 작업 옆에 있고 서버 단위로 범위가 정해집니다. 메시지, 파일, 타임스탬프, 읽지 않음 수가 별도 Slack 채널이 아니라 프로젝트에 남습니다.
- @mention은 팀원에게 작업이 있는 곳을 알립니다. 피드 속 메시지가 아니라 worktree와 session을 가리킵니다.
- 실시간 초안은 팀원이 입력 중인 내용을 보여 줍니다. 선택한 모델과 sub-agent까지 보입니다. 같은 작업을 중복하기 전에 누군가 이미 하고 있음을 알 수 있습니다.
- Takeover를 쓰면 팀원이 같은 session을 열어 같은 context, provider, 계정으로 이어 갈 수 있습니다. transcript에 누가 무엇을 요청했는지 남아 나중에도 인계가 보입니다.
- Notes와 Contents는 worktree가 아니라 프로젝트에 속합니다. 결정, runbook, 보고서, 파일은 워크스페이스가 삭제된 뒤에도 남습니다.
- Activity와 알림은 완료, 막힌 에이전트, worktree 생성을 팀 전체에서 한곳에서 보게 합니다.
실질적인 효과는 스크린샷과 프롬프트를 주고받는 일을 멈춘다는 것입니다. 팀원이 worktree를 열고 transcript를 읽고 에이전트에 후속 질문을 남겨, 처음보다 나은 상태로 session을 마칩니다.
Claude Code를 공유하는 세 가지 방법
| 공유 API key | 하나의 공유 로그인 | 개인 구독 + 워크스페이스 | |
|---|---|---|---|
| 비용 부담 | key 소유자 | 로그인 소유자 | 각자 자신의 요금제 |
| 사용량 귀속 | 사람별 없음 | 사람별 없음 | 계정별, session별 |
| 오프보딩 | 곳곳에서 교체 | 비밀번호 변경 | 멤버 제거 |
| Rate limit | 하나의 공유 버킷 | 하나의 공유 버킷 | 계정별 분리 |
| Session 충돌 | 가능 | 높음 | 계정과 worktree로 격리 |
| 팀 가시성 | 채팅만 | 채팅만 | 공유 프로젝트, session, 채팅 |
중요한 운영 세부 사항
각자가 자기 계정을 가지면 지루한 질문들이 관리 가능해집니다. Nethür는 Claude와 Codex 계정별 사용량을 추적하고, 실행 중인 session을 재시작하지 않고 계정을 hot-swap하며, 구독을 우선순위로 정렬하게 합니다. 한 provider가 한도에 닿으면 채팅이 대화를 그대로 유지한 채 다음 provider로 넘어가고, 모든 계정이 소진되면 가장 이른 reset에 재개할 수 있습니다.
비싼 습관이 있는 팀에 유용한 작은 기능도 둘 있습니다. Usage warming은 가장 저렴한 모델로 아주 작은 요청을 보내 Claude나 Codex 계정의 5시간 window를 일찍 시작해, 팀이 실제로 필요할 때 reset이 오게 합니다. Stop threshold는 계정이 5시간 또는 주간 비율을 넘으면 채팅을 일시 중지해 에이전트가 예산의 마지막을 태우지 않게 합니다.
코드와 자격 증명은 어디에 있는가
실행 호스트가 작업을 소유합니다. 저장소, worktree, 에이전트 프로세스, 계정 자격 증명은 당신이 고른 머신에 있고 client는 session을 렌더링합니다. 호스트가 VPS라면 그 VPS가, 팀원의 노트북이라면 그 머신이 오프라인이 될 때 접근이 끝납니다. Nethür는 협업을 위해 저장소를 호스팅 서비스에 업로드하라고 요구하지 않습니다.
이 모델에는 trade-off가 있습니다. 누군가는 호스트를 패치하고 백업해야 합니다. 동시 에이전트 수에 맞는 CPU와 디스크가 필요합니다. 호스트가 사라지면 다시 돌아올 때까지 팀이 접근을 잃습니다. 공유 개발 서버와 같은 일입니다. 작은 팀에서는 운영 비용이 key 배포 시스템을 관리하는 것보다 보통 낮지만, 0은 아닙니다.
비용
자기 컴퓨터에서 혼자 쓰는 것은 무료입니다. 팀 워크스페이스는 seat당 월 $3.99, 또는 seat당 연 $35.99로 월 $2.99에 해당합니다. 모델 provider에는 별도로 비용을 냅니다. 분당 클라우드 요금도, 토큰 마크업도 없습니다.
공유 key의 숨은 비용과 비교해 보세요. 한 사람이 청구서를 소유하고, 아무도 귀속할 수 없고, 오프보딩마다 작은 보안 프로젝트가 됩니다. seat 가격은 모델이 아니라 워크스페이스를 사는 것입니다.
이 설정이 맞는 경우
이 모델은 팀원이 이미 Claude Pro, Max 또는 다른 구독을 가지고 있고, 계정을 합치지 않고 같은 프로젝트에서 일하고 싶은 팀에 맞습니다. 코드가 자기 머신이나 VPS에 남아야 하는 팀에도 맞습니다.
조직 전체의 API 계약을 대체하지는 않습니다. 재무팀이 하나의 통합 Anthropic 청구서와 중앙화된 API key 관리를 원한다면 Anthropic의 API와 console을 쓰세요. Nethür는 일상적인 에이전트 워크스페이스를 위한 것이며, 모델 provider인 척하지 않습니다.
프로젝트 하나, 사람 둘로 시작하기
첫날 회사 전체를 이전하지 마세요. 작은 호스트에 공유 프로젝트 하나를 두고, 팀원 하나를 초대하고, 평범한 작업을 돌려 보세요. worktree를 만들고, Claude Code를 실행하고, diff를 리뷰하고, session을 인계합니다. 이게 지루하고 안전하게 느껴지면 나머지 팀을 추가하세요.
목표는 회사 곳곳의 API key를 없애는 것이 아닙니다. 하나의 key를 워크스페이스 대신 쓰는 일을 멈추는 것입니다. 서로 다른 문제이고, 그중 하나만 공유 secret이 필요합니다.



