2026 TeamClaude 가이드: AI 코딩 계정이 멈춰도 작업 세션을 이어가는 로컬 프록시 운영법

AI 코딩 계정이 멈춰도 작업 세션까지 멈출 필요는 없습니다. 한도에 닿을 때마다 터미널과 계정을 수동으로 바꾸는 대신, 로컬 프록시가 적절한 계정을 선택하게 만들면 됩니다.

TeamClaude · TeamCodex란: Claude Code와 OpenAI Codex CLI의 여러 본인 소유 계정을 독립된 풀로 관리하고 상태에 따라 요청을 전환하는 로컬 프록시입니다.

여러 계정보다 어려운 것은 전환입니다

장시간 AI 코딩 작업에서는 계정의 사용량 제한이나 일시적인 upstream 오류를 만날 수 있습니다. 이때 사람이 직접 상태를 확인하고 계정을 바꾸면 작업 흐름이 끊깁니다.

TeamClaude · TeamCodex는 Claude Code와 OpenAI Codex CLI의 여러 본인 소유 계정을 각각 독립된 풀로 관리하는 로컬 프록시입니다. 클라이언트가 연결하는 로컬 주소는 유지하고, 실제 요청을 처리할 계정은 상태에 따라 선택합니다.

이 도구의 목적은 계정을 공유하거나 서비스 약관을 우회하는 것이 아닙니다. 사용자가 정당하게 소유하고 관리하는 계정을 서비스 약관 범위 안에서 운영하는 데 초점을 둡니다.

단순 round-robin이 아닌 use-or-lose 라우팅

계정을 차례대로 돌리는 것만으로는 각 계정의 한도 초기화 시점을 활용하기 어렵습니다. TeamClaude · TeamCodex는 주간 한도 초기화가 가까운 계정을 우선하는 use-or-lose 라우팅을 제공합니다.

요청 중 사용량 429가 발생하면 다른 계정으로 전환합니다. 네트워크 오류와 upstream 529에는 제한된 재시도를 수행합니다. 모든 계정이 잠시 제한된 상황에서는 초기화 시점까지 기다리는 continuity mode도 제공합니다.

핵심은 “계정을 많이 연결한다”가 아닙니다. “지금 어떤 계정을 써야 작업 흐름을 유지할 수 있는가”를 자동으로 판단하는 것입니다.

같은 연결은 같은 계정에 유지합니다

요청마다 계정을 무작위로 바꾸면 작업 맥락과 prompt cache 활용에 불리할 수 있습니다. 그래서 동일 연결을 같은 계정에 유지하는 session affinity를 지원합니다.

동시에 계정별 동시 요청도 분산합니다. 자동 전환이 필요할 때는 전환하고, 연결을 유지하는 편이 나을 때는 그대로 두는 구조입니다.

Claude와 Codex는 독립적으로 운영합니다

Claude Code와 OpenAI Codex CLI는 설정 파일, 계정 풀, 포트를 각각 분리합니다. 두 프록시를 동시에 실행해도 서로의 계정 상태와 설정을 섞지 않습니다.

구분	기본 포트
Claude 프록시	`3456`
Codex 프록시	`3457`

Codex CLI나 Hermes Agent처럼 고정된 로컬 주소가 필요한 클라이언트를 연결할 때도 이 구성이 유용합니다.

자동화와 수동 통제를 함께 제공합니다

자동 라우팅만 있으면 현재 어떤 계정이 선택됐는지 확인하기 어렵습니다. TeamClaude · TeamCodex의 TUI에서는 다음 작업을 수행할 수 있습니다.

계정별 사용량 확인
활성 계정 전환
계정 활성화·비활성화
계정 우선순위 변경
CPU·RAM 상태 확인

운영자는 평소에는 자동 라우팅을 사용하고, 필요할 때 TUI에서 직접 개입할 수 있습니다.

공개 저장소에서 확인한 기준

2026년 7월 24일 기준 커밋에서 확인한 정보는 다음과 같습니다.

테스트 200/200 통과
런타임 dependencies 0
Node.js 18 이상 필요
package version 1.2.3-qjc.1
MIT License

테스트 수와 version은 이후 커밋에서 달라질 수 있습니다. 설치 전에는 저장소의 최신 README와 package 정보를 다시 확인하세요.

설치와 실행 흐름

Node.js 18 이상 환경에서 다음과 같이 설치합니다.

npm install -g github:sangrokjung/teamclaude

Claude 계정은 다음 명령으로 추가합니다.

teamclaude login

Codex 계정은 이름을 지정해 추가합니다.

teamclaude codex login --name <name>

로컬 프록시와 TUI는 각각 다음 명령으로 시작합니다.

teamclaude server
teamclaude codex server

다른 터미널에서는 전용 run 명령으로 클라이언트를 실행합니다.

teamclaude run
teamclaude codex run

일반 claude 명령만 실행하면 프록시가 자동 적용되지 않습니다. 반드시 TeamClaude의 전용 run 명령을 사용하세요.

사용 전 확인할 점

연결하는 계정은 모두 본인이 정당하게 소유하고 관리해야 합니다. 계정 공유, 재판매, 서비스 약관 우회를 위한 사용은 권장하지 않습니다.

인증 정보가 담긴 실제 설정 파일도 Git에 커밋하지 마세요. 원격 클라이언트를 연결한다면 인증 방식과 네트워크 노출 범위를 별도로 점검해야 합니다.

자주 묻는 질문

계정을 연결하면 Claude와 Codex 설정이 섞이나요?

아닙니다. Claude와 Codex는 설정 파일, 계정 풀, 기본 포트를 각각 분리합니다.

일반 claude 명령으로도 프록시가 적용되나요?

아닙니다. README에 안내된 teamclaude run 또는 teamclaude codex run 전용 명령을 사용해야 합니다.

다른 사람의 계정도 함께 연결해도 되나요?

계정 공유를 권장하지 않습니다. 본인이 정당하게 소유하고 관리하는 계정을 각 서비스 약관 범위 안에서 사용하세요.

마무리

작업 흐름을 오래 유지하려면 더 많은 계정보다 더 나은 전환 방식이 필요합니다. TeamClaude · TeamCodex는 그 전환을 로컬에서 자동화하면서, TUI를 통한 운영 통제도 남겨둡니다.

GitHub에서 README와 설치 방법 확인하기

공식 출처

모든 URL은 2026년 7월 24일 KST에 확인했습니다.

2026 TeamClaude 가이드: AI 코딩 계정이 멈춰도 작업 세션을 이어가는 로컬 프록시 운영법