원문: soulduse/team-ai · 수집일: 2026-10-05 · v0.1.0(릴리스 없음) · Stars 20 · MIT · TypeScript · Node.js 20+, macOS/Linux
한눈에 보기
Claude Code와 공식 Codex CLI 앞에 놓는 로컬 다중 계정 릴레이다. 제공자별로 계정 풀을 따로 두고, 선택된 구독 계정이 쓸 수 없거나 한도가 다 찼으면 다른 계정으로 요청을 다시 보낸다. 전체 화면 TUI 대시보드가 계정별 남은 한도를 보여 준다. 2026-10-05-github-soulduse-ai-token-monitor를 만든 soulduse의 프로젝트다.
- 계정 선택·재시도·프록시·Anthropic OAuth 설계 일부는 TeamClaude에서, Codex OAuth·Responses 릴레이 설계는 codex-multi-auth에서 가져왔다(NOTICE). TeamClaude 설정에서 계정을 그대로 가져올 수 있다.
- 범위는 좁게 잡았다. 공개 OpenAI 호환 API, Claude↔Codex 요청 변환, Codex Desktop, 다른 사람과의 계정 공유는 지원하지 않는다. 제공자 약관 준수는 사용자 책임이며, 상업 워크로드는 공식 API 과금을 쓰라고 README가 명시한다.
쓰는 법
./scripts/install.sh # 의존성·빌드·teamai/tai/tac/tax 명령 링크, 셸 블록 추가(재실행하면 업그레이드)
teamai login # [1] Claude 또는 [2] Codex 계정 추가, 계정마다 반복
tai # 릴레이 시작 + 대시보드. 1은 Claude Code, 2는 Codex 실행
tac --resume # Claude Code를 계정 풀 경유로 바로 실행(인자는 공식 CLI로 그대로 전달)
tax # Codex를 계정 풀 경유로 실행릴레이는 127.0.0.1에만 묶이고(Claude 3456, Codex 3457, 제어 3556), 자동 생성된 로컬 클라이언트 토큰이 있어야 붙을 수 있다. 셸 블록은 전역에 박힌 ANTHROPIC_BASE_URL을 해제한다. 세션마다 자기 포트를 지정하므로, 남은 전역 값은 이미 꺼진 프록시로 트래픽을 보낼 수 있기 때문이다. Codex는 격리된 별도 홈을 쓰므로 원래 ~/.codex는 건드리지 않는다.
계정 선택 방식
- 덜 쓴 계정 먼저 — 남은 한도가 많은 순으로 정렬하며, 대시보드 맨 윗줄이 다음 요청이 갈 계정이다. 사용률이
switchThreshold(기본 0.98)를 넘으면 선택에서 빠진다. 모두 소진되면 가장 빨리 리셋되는 계정 순이 된다. 측정 안 된 계정은 맨 뒤로 간다. - 모델 인식 라우팅 — Claude의 최상위 모델(Fable 등급)만 모델별 주간 한도를 쓴다. 그래서 Opus·Sonnet·Haiku 요청은 Fable 한도가 이미 바닥난 계정(
fableReserveThreshold0.8 이상)으로 보내고, Fable 예산이 남은 계정은 Fable 요청용으로 아껴 둔다. - 부분 차단 — Fable 주간 한도만 막힌 429면 그 계정의 Fable 창만 쉬게 하고 다른 모델은 계속 받는다. 공용 5시간·7일 창이 막히면 계정 전체를 쉬게 한다.
- 한도 측정 — 별도 API를 폴링하지 않고 실제 응답의 rate-limit 헤더에서 배운다.
R은 실제로 성공한 요청 형태를 유휴 계정 전체에 재생해 다시 측정한다. 서버는 5분마다 리셋된 창을 정리하고, 미측정 계정만 측정하고, 만료가 가까운 토큰을 하나씩 갱신한다(한꺼번에 갱신하면 토큰 엔드포인트가 rate limit에 걸리기 때문이다). - 과부하 처리 — 계정당 동시 요청 한도(기본 16)를 넘는 요청은 본문을 읽기 전에 429로 거절한다. 헤더
x-teamai-429-reason으로 바쁜 상태(concurrency_saturated)와 소진 상태(quota_exhausted)를 구분한다. - 일시 오류 — 원래 상태 코드와 Retry-After를 유지하고, 계정 전환 뒤 최대 두 번(총 20초 이내) 재시도한다. 성공한 스트림은 다시 보내지 않는다.
대시보드
Claude 행은 5시간 세션, 7일 전체, 7일 Fable 창을 따로 보여 주고, Codex 행은 1차·2차 창을 보여 준다. 학습한 한도는 디스크에 저장돼 재시작해도 남지만, 쿨다운이나 오류 상태는 일부러 버린다. 오래된 429 때문에 계정이 다시 묶이지 않게 하려는 것이다. p나 teamai capture는 대시보드를 텍스트와 PNG로 저장하며, 계정 주소는 기본으로 가린다. 구독 만료일 ~D-N은 Anthropic이 결제 주기 끝을 알려 주지 않아 다음 월 결제일을 추정한 값이다.
비슷한 도구와 비교
2026-04-10-claude-code-multi-account-proxy의 9Router·CliGate·CLIProxyAPI는 OpenAI 호환 엔드포인트와 여러 제공자·모델 간 폴백을 넓게 묶는다. TeamAI는 반대로 Claude Code와 Codex의 구독 OAuth 계정 풀링 하나에 집중한다. 대신 Fable 한도를 아끼는 라우팅, 헤더 기반 한도 학습, 계정별 창 단위 차단처럼 구독 한도 관리를 더 세밀하게 다룬다. 2026-07-12-cliproxyapi-gpt-in-claude-code처럼 모델을 바꿔 끼우는 용도는 지원하지 않는다.
관련 노트
- moc-claude-code · codex
- 2026-10-05-github-soulduse-ai-token-monitor — 같은 개발자의 토큰·비용 메뉴바 앱