手把手安装并配置 CC Switch

CC Switch 是一个桌面工具用来集中管理 Claude Code、Codex 等工具的配置一键切换地址、Key 和模型。一、安装前准备安装 Node.js 22 LTS 或更高版本。安装 Claude Code 和 Codexnpm install -g anthropic-ai/claude-code npm install -g openai/codex准备一个 API Key。使用官方订阅可以不填切换后按提示登录。二、安装 CC SwitchWindows 10 及以上按 CPU 架构下载Intel/AMD 选x64ARM 选arm64.msi安装版或Portable.zip便携版均可。便携版解压后双击cc-switch.exe。第一次启动会读取现有配置并在改写前自动备份。图 1便携版解压后双击cc-switch.exe。macOS 12 及以上可执行brew install --cask cc-switch。三、接入 DeepSeek以 Codex 为例打开 DeepSeek 开放平台 →「API keys」→「创建 API key」复制保存。在 CC Switch 左侧选中Codex点「 添加供应商」选择 DeepSeek。填写名称API Key粘贴刚创建的密钥API 请求地址填https://api.deepseek.com再点「获取模型列表」。保存后点卡片右侧三角形启用彻底重启 Codex。图 2红框处填 API Key 和请求地址。重启后输入/model选择刚添加的模型发一句话测试。图 3红框处选择模型能正常回复即配置成功。Claude Code 支持热切换启用后不用重启如果服务不是 Anthropic 格式在顶部「路由」里点「开始路由」。四、配置中转 APIAICodeMirror Codex先注册 AICodeMirror再按下面步骤操作。进入左侧「API密钥」点「创建API密钥」。图 4左侧「API密钥」→「创建API密钥」。填一个名称点「创建」复制密钥只显示一次。图 5名称随意填。图 6复制后点「完成」。回到 CC Switch左侧选Codex点「 添加供应商」搜索 aicodemirror并选中。图 7搜索框输入 aicodemirror。粘贴API Key地址保持https://api.aicodemirror.ai/api/codex/backend-api/codex点「获取模型列表」。图 8API Key 只填这一处下方会自动填充。点「添加」再点卡片右侧三角形启用彻底重启 Codex输入/model选模型测试。Claude Code 接入同一平台时地址填https://api.aicodemirror.com/api/claudecode模型填claude-sonnet-4-20250514启用后不用重启。五、切换与备份主界面点配置卡片的启用按钮或右键托盘图标切换数据在C:\Users\用户名\.cc-switch默认每 24 小时备份一次保留 10 份。六、常见问题检测连通通过但请求失败检测只验证地址Key、模型 ID、接口格式仍需正确。切换后模型没变模型保存在配置里在 CC Switch 中修改后才会固定。Codex 看不到新模型重启 Codex 及其后台守护进程。小结先跑通一条链路再添加其他配置每加一个测试一次即可。