用途:cli-anything-ccswitch 是桌面应用 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 查看和管理设置(list、get、set);sessions 浏览和搜索 AI 对话会话(list)。
全局选项:--json 输出机器可读 JSON(建议智能体使用,需放在子命令前);--db PATH 覆盖数据库路径。
用法示例:cli-anything-ccswitch --json providers list;cli-anything-ccswitch providers set-current <provider-id> --app claude;cli-anything-ccswitch proxy status --app claude;cli-anything-ccswitch usage stats --days 7;cli-anything-ccswitch mcp enable <server-id> --app claude --on;cli-anything-ccswitch settings set <key> <value>;cli-anything-ccswitch sessions list --app claude --limit 10。
限制与注意:API 令牌、密钥等敏感值在所有输出中被掩码显示(如 sk-bc089...5cbb)。退出码 0 表示成功,1 表示错误(如资源未找到、无效 app 类型),智能体应先检查退出码再解析输出。有效 app 类型:claude、codex、gemini、opencode、openclaw、hermes。CLI 读取实时 SQLite 数据库,读操作安全不改动数据库;写操作(providers set-current、proxy config、mcp enable、settings set)会直接修改数据库。