必须用cc switch统一配置管理工具切换ai agent,否则易出错且终端重启后模型不识别;它自动扫描本地agent路径、预设50+模型供应商,并支持codex重启切换与claude code热切换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Agent Space中快速切换正在使用的AI Agent,比如从Codex换成Claude Code或Gemini CLI,不能靠手动改配置文件——那样容易填错API Key、漏写Base URL,还可能让MCP服务断连。必须用统一配置管理工具完成切换,否则终端重启后模型仍不识别。
启用CC Switch桌面工具
下载并安装CC Switch(支持Windows便携版/安装版、macOS、Linux),启动后自动扫描本地Agent安装路径:【~/.codex、~/.claude-code、~/.gemini-cli等标准目录】。若某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修改,否则可能丢失临时注册状态。
方法二:复用已有配置快速克隆
选中一个已验证成功的Codex配置→点击「复制」→修改API Key和模型名→保存为新配置→切换时无需重登,直接应用即可。
对Claude Code实现热切换(不关终端)
第一步:在CC Switch中为Claude Code添加至少两个供应商,例如Kimi + DeepSeek。
第二步:启动Claude Code终端会话(claudel --interactive)。
第三步:保持终端运行,回到CC Switch界面,点击目标供应商→点击「立即切换」按钮。
第四步:回到终端,输入任意指令(如 /help),观察响应头是否显示新模型名称——若显示kimi-v3或deepseek-coder-v2,则切换成功。











