CC Switch CLI
CC Switch용 CLI 하네스 — AI 코딩 도구(Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes) 구성을 관리하는 데스크톱 앱입니다. Click 및 CLI-Anything 방법론을 기반으로 구축되었습니다.
사전 요구 사항
- Python 3.10+
~/.cc-switch/cc-switch.db에 활성 데이터베이스가 있는 CC Switch 설치
설치
pip install -e .
설치 후 cli-anything-ccswitch 명령어를 사용할 수 있습니다.
명령 그룹
| 그룹 | 설명 |
|---|---|
status | 빠른 데이터베이스 개요 표시 |
providers | AI 공급자 구성 관리 (목록, 보기, 현재 설정) |
proxy | 로컬 HTTP 프록시 서버 관리 (상태, 구성) |
mcp | MCP(Model Context Protocol) 서버 관리 (목록, 활성화) |
skills | 설치된 스킬 관리 (목록, 저장소) |
usage | API 사용량 및 비용 통계 조회 (통계, 로그) |
settings | CC Switch 설정 조회 및 관리 (목록, 보기, 설정) |
sessions | AI 대화 세션 탐색 및 검색 (목록) |
전역 옵션
--json— 기계가 읽을 수 있는 JSON 형식으로 출력 (에이전트 사용 권장)--db PATH— 데이터베이스 경로 재정의
에이전트별 지침
JSON 출력
프로그램적 소비를 위해 항상 --json을 사용하십시오. 서브 명령어 앞에 배치하세요:
cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude
민감한 값
API 토큰, 키, 시크릿은 모든 출력에서 마스킹됩니다. 공급자 세부 정보의 settings_config 필드는 마스킹된 값(예: sk-bc089...5cbb)을 표시합니다.
종료 코드
0— 성공1— 오류 (예: 리소스를 찾을 수 없음, 잘못된 앱 유형)
앱 유형
유효한 앱 유형: claude, codex, gemini, opencode, openclaw, hermes.
예제
모든 공급자 목록
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
활성 공급자 전환
cli-anything-ccswitch providers set-current <provider-id> --app claude
프록시 상태 확인
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
사용량 통계 보기
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
스킬 목록
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
MCP 서버
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
설정
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <key>
cli-anything-ccswitch settings set <key> <value>
세션
cli-anything-ccswitch sessions list --app claude --limit 10
상태 개요
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
오류 처리
리소스를 찾을 수 없는 경우 CLI는 stderr에 오류 메시지를 출력하고 코드 1로 종료합니다. 에이전트는 출력을 파싱하기 전에 종료 코드를 확인해야 합니다.
데이터베이스
CLI는 라이브 CC Switch SQLite 데이터베이스에서 읽습니다. 모든 읽기 작업은 안전하며 데이터베이스를 수정하지 않습니다. 쓰기 작업(providers set-current, proxy config, mcp enable, settings set)은 데이터베이스를 직접 수정합니다.