CC Switch CLI
CC Switch 的 CLI 封装，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 提供者配置（list、get、set-current） |
proxy | 管理本地 HTTP 代理服务器（status、config） |
mcp | 管理 MCP（模型上下文协议）服务器（list、enable） |
skills | 管理已安装的技能（list、repos） |
usage | 查看 API 使用量和成本统计（stats、logs） |
settings | 查看和管理 CC Switch 设置（list、get、set） |
sessions | 浏览和搜索 AI 对话会话（list） |
全局选项
--json— 以机器可读的 JSON 格式输出（推荐 AI 代理使用）--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）会直接修改数据库。