KarpelesLab/teamclaude

해결하는 문제

TeamClaude(TeamRouter라고도 함)는 여러 AI 코딩 에이전트를 동시에 실행할 때 사용량 제한에 도달하는 문제를 해결합니다. 이 프로젝트는 자체 구독 계정 풀을 관리하는 로컬 프록시로, 계정이 세션 또는 주간 할당량에 도달하면 자동으로 계정 간에 로테이션하여 장시간 실행되는 에이전트 작업이 중단 없이 계속될 수 있도록 합니다.

작동 방식

이 프로젝트는 코딩 에이전트(Claude Code 또는 Codex CLI 등)와 제공업체 API 사이에 위치합니다. 응답 헤더를 모니터링하여 풀에 있는 각 계정의 할당량 사용량을 추적합니다. 계정이 한도에 가까워지면 프록시는 다음 사용 가능한 계정으로 투명하게 전환합니다. OAuth 토큰 갱신을 처리하고, 계정별 네트워크 라우팅을 관리하며, 사용량 모니터링, 재설정 카운트다운, 계정 우선순위 관리를 위한 터미널 기반 인터페이스(TUI)를 제공합니다.

대상 사용자

이 도구는 여러 개의 동시 AI 코딩 세션을 실행하고 여러 구독 계정을 보유한 개인 파워 유저를 위해 설계되었습니다. 개인이 자체 자격 증명을 관리하기 위한 용도로, 계정 공유나 재판매 서비스가 아닙니다.

주요 기능

• 여러 계정을 자동으로 로테이션하여 429 속도 제한 오류를 우회합니다.
• 서로 다른 모델 및 시간 창(5시간/7일)에 대한 별도의 할당량 버킷을 추적합니다.
• 할당량, 활동 로그, 프록시 상태를 모니터링하는 라이브 TUI를 포함합니다.
• 개별 계정에 대한 계정별 네트워크 라우팅(예: SOCKS5 프록시)을 지원합니다.
• 할당량이 재설정될 때까지 요청을 "보류"하여 무인 장시간 작업을 허용합니다.
• 에이전트가 프록시 플릿을 직접 쿼리하거나 관리할 수 있는 선택적 MCP 엔드포인트를 제공합니다.