KarpelesLab/teamclaude

해결하는 문제

TeamClaude는 Claude Code 및 Codex와 같은 코드 생성 에이전트가 API 할당량 제한으로 인해 중단되는 것을 방지하기 위해 설계된 멀티 계정 프록시입니다. Claude Max, ChatGPT/Codex, API 키 기반 계정 등을 포함한 여러 계정을 풀링하고, 한 계정이 세션(5시간) 또는 주간(7일) 제한에 도달하면 자동으로 다음 유효한 계정으로 전환하여 장시간의 코드 작업이 중단되지 않도록 보장합니다.

작동 방식

이 도구는 코드 에이전트와 제공자 API 사이에 위치하는 로컬 프록시로 작동합니다. 요청을 가로채고 풀링된 계정의 인증 토큰을 관리합니다.

1. 계정 전환: 응답 헤더를 모니터링하여 세션(5시간) 및 주간(7일) 할당량을 추적합니다. 계정이 사전 정의된 임계값(기본값 98%)에 도달하면 다음 유효한 계정으로 전환합니다.
2. 요청 라우팅: 올바른 계정 토큰을 삽입하고 요청 본문의 account_uuid를 활성 계정과 일치하도록 재작성합니다.
3. 지능형 처리: 분 단위 레이트 제한(요청 속도 조절)과 소진된 할당량(계정 전환)을 구분하여 처리합니다.
4. MITM 프록시: 로컬 MITM 포워드 프록시를 통해 하드코딩된 엔드포인트(예: Claude Design MCP)를 캐치하여 모든 트래픽이 프록시를 통해 전달되도록 보장합니다.

대상 사용자

Claude Code 및 Codex CLI를 자주 사용하면서 사용량 제한에 자주 도달하는 개발자. 수동으로 여러 구독 또는 API 키를 전환하지 않고도 원활하게 관리하고 싶은 사람들을 위한 도구입니다.

주요 기능

• 자동 할당량 전환: 세션 및 주간 버킷 기반으로 계정을 전환하며, 할당량이 가장 빨리 리셋되는 계정을 우선합니다.
• 모델별 추적: 각 계정에 대해 Opus, Sonnet, Fable 등 다양한 모델의 할당량을 별도로 추적합니다.
• TUI 인터페이스: 할당량 바, 리셋 카운트다운, 활동 로그를 포함한 터미널 사용자 인터페이스 제공.
• 백업 지원: DeepSeek 또는 GLM과 같은 제3자 Anthropic 호환 API를 저우선 순위 백업으로 지원합니다.
• 의존성 없음: Node.js 내장 모듈만 사용하여 구축.
• 요청 보류: 할당량이 리셋될 때까지 요청을 보류하여 429 에러를 반환하지 않고 대기 가능.