Claude Code 세션이 사용량 제한에 걸려 중단되는 것을 방지하는 로컬 프록시 구축
요약
Claude Code 사용 중 발생하는 사용량 제한 문제를 해결하기 위해 개발된 로컬 HTTP 프록시 'TeamCodex'를 소개합니다. 여러 계정의 할당량을 지능적으로 관리하여 끊김 없는 개발 환경을 제공합니다.
핵심 포인트
- 여러 Claude 계정의 할당량을 자동으로 라우팅하여 사용량 제한 방지
- Rate-limit 헤더를 분석해 가장 효율적인 계정을 우선 사용
- 응답 중단 시 깔끔한 이벤트 경계에서 재시도를 지원하여 세션 유지
- 계정 상태를 관리할 수 있는 터미널 대시보드(TUI) 제공
- MIT 라이선스로 제공되며 로컬 기기 내에서만 작동
여러 Claude 구독(또는 구독과 API 키)을 사용하고 있다면 아마 이 상황을 겪어보셨을 겁니다. 작업을 진행하던 도중에 Claude Code가 사용량 제한 오류를 발생시키고, 이제는 멈추고 로그아웃한 다음 다른 계정으로 다시 로그인해서 터미널이 중단된 지점부터 재개되기를 바랄 수밖에 없습니다. 저는 이 상황에 너무 짜증을 느껴 TeamCodex라는 것을 만들었습니다. 이것은 Claude Code(그리고 별도로 Codex CLI)와 실제 API 사이에 위치하는 작은 로컬 HTTP 프록시로, 각 요청을 사용 가능한 할당량이 남아 있는 사용자 본인의 계정으로 자동으로 라우팅합니다. 작동 방식에 대해 몇 가지 말씀드리자면: 이는 순환 방식으로 동작하지 않습니다. 각 계정의 실제 rate-limit 헤더를 읽고, 가장 빨리 주간 할당량이 초기화되는 계정을 사용하여 고갈시키므로, 이미 비용을 지불하여 얻은 할당량을 사용하지 못하고 만료시키는 일이 없습니다. Claude Code와 Codex CLI는 완전히 분리된 계정 풀(자체 포트, 자체 설정)을 가지므로, 서로 영향을 주지 않고 동시에 실행할 수 있습니다. 스트림이 응답 도중에 끊기면, 프록시는 재시도 가능한 오류를 발생시키며 깔끔한 이벤트 경계에서 이를 종료하므로, 클라이언트의 자동 재시도가 단순한 'Connection closed mid-response'가 아닌 다른 계정으로 연결됩니다. 계정별 할당량을 보여주고 우선순위를 재배열하거나 계정을 수동으로 비활성화할 수 있는 터미널 대시보드(TUI)도 있습니다. 런타임 종속성은 없고, MIT 라이선스이며, 테스트는 291개입니다. 누군가 물어보기 전에 말씀드리자면 — 이는 사용자가 이미 소유한 계정만 라우팅하며, 본인의 기기에서만 작동하고, 여러 사람이 하나의 좌석을 공유하도록 허용하지 않습니다. 아무도 할당량을 늘려주지 않습니다. 단지 사용자 본인의 계정에 있는 이미 지불된 할당량이 낭비되는 것을 막아줄 뿐입니다. 더 자세한 내용은 README 섹션에 있습니다. 이는 KarpelesLab/teamclaude를 기반으로 구축되었으며, 이 프로젝트는 Claude 측면을 자체적으로 매우 잘 처리합니다 — 저는 Codex/ChatGPT 계정 풀링, 모델 폴백 체인(model fallback chain), 그리고 해당 프로젝트가 갖지 못한 네트워크 레벨 장애 조치 기능을 추가하기 위해 포크했습니다. 설치 방법: npm install -g teamcodex teamcodex import # 또는 새 계정의 경우 teamcodex login을 사용합니다. MIT 라이선스이며, 저장소는 아래에 있습니다.
저는 주로 Claude Max/Pro 및 API 키 계정을 대상으로 테스트했으므로, 만약 다른 조합을 사용하시거나 오류를 발견하신다면 댓글이나 이슈(issue)를 통해 알려주시면 진심으로 감사하겠습니다. https://github.com/sangrokjung/teamclaude /u/Nice_Operation4587 님이 제출함 [link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기