CC Switch CLI
CC Switch 的命令列包裝工具，CC Switch 是一款桌面應用程式，用於管理多種 AI 編碼工具（Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes）的設定。採用 Click 與 CLI-Anything 方法論建構。
前置需求
- Python 3.10+
- 已安裝 CC Switch，並在
~/.cc-switch/cc-switch.db擁有作用中的資料庫
安裝
pip install -e .
安裝完成後，即可使用 cli-anything-ccswitch 指令。
指令群組
| 群組 | 說明 |
|---|---|
status | 顯示資料庫概覽 |
providers | 管理 AI 提供者設定（列出、取得、設定目前使用） |
proxy | 管理本機 HTTP 代理伺服器（狀態、設定） |
mcp | 管理 MCP（模型上下文協定）伺服器（列出、啟用） |
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）會直接修改資料庫。