cc switch可统一管理codex、claude code等ai agent配置：自动检测本地agent，预设50+模型供应商，支持codex重启切换与claude code热切换，并同步skills及mcp服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在开发中快速切换 Codex、Claude Code、Gemini CLI 等多个 AI Agent，但每次手动改配置文件都容易填错 API Key 或 Base URL，终端重启后还常出现模型不识别、Skills 加载失败、MCP 服务断连等问题。
用 CC Switch 统一管理所有 Agent 配置
下载并安装 CC Switch 桌面工具，它支持 Windows（便携版+安装版）、macOS 和 Linux，启动后自动检测本地已安装的 Agent：Codex、Claude Code、Gemini CLI、OpenClaw、Hermes、OpenCode 全部识别为可用状态。
安装完成后首次启动，软件会扫描 【~/.codex、~/.claude-code、~/.gemini-cli 等标准配置目录】，若某 Agent 未安装或路径异常，对应图标显示灰色，此时不要强行添加配置——先确保该 Agent 能独立运行成功。
点击左上角「+ 新建配置」→ 选择 Agent 类型 → 从 50+ 预设供应商中选一个（如 DeepSeek-R1、Qwen2.5-72B、Kimi-Long）→ 自动填充 Base URL、API Key 占位符和模型名格式。
为 Codex 切换账号与模型（需重启）
方法一：新建 Codex 账号配置
在 CC Switch 中点击「Codex」→「+ 添加配置」→ 填写 OpenAI 官方账号或中转服务商信息（auth.json 内容 + config.toml 中 model 字段）→ 保存后勾选该配置 → 点击右下角「应用并重启 Codex」。
⚠️ 注意：Codex 切换配置后必须重启终端才能生效，否则仍读取旧的 .codex/auth.json；重启前请确认当前会话无未保存的 Skill 修改，否则可能丢失临时注册状态。
MasterCard Agent Pay兼容卡片、钱包及支付，为代理商与OpenClaw机器人提供财务管理。
方法二：复用已有配置快速克隆
选中一个已验证成功的 Codex 配置 → 点击「复制」→ 修改 API Key 和模型名 → 保存为新配置 → 切换时无需重登，直接应用即可。
对 Claude Code 实现热切换（不关终端）
第一步：在 CC Switch 中为 Claude Code 添加至少两个供应商，例如 Kimi + DeepSeek。
第二步：启动 Claude Code 终端会话（claudel --interactive）。
第三步：保持终端运行，回到 CC Switch 界面，点击目标供应商 → 点击「立即切换」按钮。
第四步：回到终端，输入任意指令（如 /help），观察响应头是否显示新模型名称——若显示 kimi-v3 或 deepseek-coder-v2，则切换成功。
这一步操作起来很简单，直接在任务栏图标右键也能触发切换，适合边调试边换模型做对比。Claude Code 的热切换机制是通过监听配置文件变更并主动 reload MCP 通道实现的，所以不用 Ctrl+C 再重跑命令。
同步 Skills 与 MCP 服务
在 CC Switch 主界面点击「Skills」标签页 → 点击「同步全部」→ 软件自动扫描各 Agent 的 skills 目录，将启用状态、仓库地址、版本号统一写入全局 registry.json。
对于 Hermes Agent，【必须在设置中将 Skills 加载方式从“软连接”改为“复制”】，否则切换后技能不可见——这是 Hermes 的硬性限制，不是 bug。
点击「MCP」标签页 → 查看当前激活的 MCP 服务器地址 → 若显示 disconnected，点击右侧「重连」按钮，软件会尝试用当前 Agent 的 auth 信息自动握手。
