realiti4/claude-swap

해결하는 문제

claude-swap는 Claude Code (CLI 및 VS Code 확장 프로그램)용 다중 계정 관리자입니다. 사용자가 로그아웃하지 않고 여러 Claude 계정을 쉽게 전환하거나, 남은 할당량에 따라 계정을 자동으로 전환함으로써 레이트 제한에 도달하는 문제를 해결합니다.

작동 방식

이 도구는 추가된 각 계정의 OAuth 토큰과 설정을 백업합니다. 각 계정의 자격 증명을 플랫폼별 방법(예: macOS Keychain)을 사용하여 안전하게 관리하고, 사용자가 계정을 전환할 때 활성 로그인을 교체합니다.

주요 기능:

• 자동 전환: 백그라운드 프로세스가 사용량을 모니터링하고, 임계값(예: 90%)에 도달하면 남은 할당량이 가장 많은 계정으로 자동 전환합니다.
• 세션 모드: 다른 터미널이나 VS Code 확장 프로그램에 영향을 주지 않고, 단일 터미널 세션에서 특정 계정으로 Claude Code를 실행할 수 있습니다.
• 디렉터리 매핑: 특정 디렉터리를 특정 계정에 연결할 수 있어, cswap run을 실행하면 리포지토리에 따라 올바른 계정을 자동으로 선택합니다.
• 사용량 추적: Anthropic의 사용량 API를 주기적으로 확인하여 5시간 및 7일 기준 할당량의 실시간 대시보드를 제공합니다.

대상 사용자

레이트 제한을 피하거나 업무 및 개인 환경을 분리하기 위해 여러 계정을 관리하는 개발자.

주요 특징

• 실시간 대시보드: TUI(Terminal User Interface)와 macOS 메뉴바 앱(옵션)을 통해 사용량을 추적하고 계정을 전환할 수 있습니다.
• 스마트한 전환 전략: best(남은 할당량이 가장 많은 계정) 및 consume-first(즉시 리셋되는 계정 우선) 전략을 포함합니다.
• 병렬 실행: 여러 계정을 서로 다른 터미널 세션에서 동시에 실행할 수 있습니다.
• 안전한 통합: Claude Code와 동일한 자격 증명 잠금을 사용하여 토큰 갱신 중 충돌을 방지합니다.
• 스크립트 지원: list, status, switch 명령어의 JSON 출력을 제공하여 자동화가 가능합니다.