CC-Switch快速配置（推荐）

CC-Switch 是一款跨平台桌面应用，用于统一管理并一键切换 Claude Code、Codex 等 AI 编程工具的 API 供应商配置。

以往切换 API 供应商需要手动编辑 Claude 的 settings.json、Codex 的 config.toml / auth.json 等不同格式的文件，容易出错。CC-Switch 把这些配置收拢到一个界面里，填好后一键切换，底层自动写入各工具真正读取的配置文件。

本文以「魔芋AI」平台为例，讲解如何用 CC-Switch 配置 Claude Code 与 Codex，以及如何路由到其他模型。

1. 安装 CC-Switch

前往官方发布页下载对应系统的安装包：

下载地址：https://ccswitch.lovable.app/

macOS（Homebrew）：

前置条件：需要已经安装好 Claude Code（@anthropic-ai/claude-code）和 / 或 Codex（@openai/codex）。安装方法见各自的安装教程。

安装后打开 CC-Switch，界面顶部通过标签页在 Claude Code 和 Codex 之间切换，每个标签页下管理各自的供应商列表。

2. 魔芋AI平台快速导入

2.1 快捷导入

1.如下图所示，进入魔芋AI控制台，点击令牌管理菜单，选择令牌行快速导入按钮。

2.如下图所示，在快速导入弹窗中选择Claude Code、Codex、Gemini等页签，页面中完成模型配置后点击"导入CC Switch"按钮，自动将魔芋平台配置导入CC Switch，在CC Switch中启用导入后的配置即可。

2.2 验证

打开一个新终端（让配置生效），进入任意项目目录后运行：

能正常对话即配置成功。

3. 切换供应商

配置好多个供应商后，切换非常简单：

在 CC-Switch 主界面的对应标签页（Claude Code / Codex）中，点击目标供应商即可切换，配置会即时写入对应工具的配置文件。

也可以从系统托盘菜单快速切换，无需打开主窗口。

切换后：

Claude Code：新开的 claude 会话即用新供应商。

Codex：需重启 codex 生效。

4. 模型路由配置（切换 / 指定其他模型）

「模型路由」指让 Claude Code / Codex 使用平台上的其他模型，而不局限于默认模型。

4.1 Claude Code 配置模型路由

1.如下图所示，在Claude Code中配置MiniMax/MiniMax-M3模型，该模型不支持Anthropic Message协议，需要开启路由；API格式选项中选择OpenAI Chat Completions，完成以上配置，点击保存。

2.在CC Switch设置中开启路由，如下图所示：

3.启用配置即可使用。

注意：Claude Code中使用GPT模型时API格式选择OpenAI Response API，使用Gemini模型选择Gemini Nativa generateContent，并且需要开启路由；Claude、Deepseek、GLM模型使用Anthropic Messages即可，无需开启路由。

4.2 Codex 的模型路由

注意：Codex配置请求地址需要添加/v1，即API请求地址为https://www.moyu.cn/v1

1.如下图所示，在Codex中配置Claude模型，上游格式选择Anthropic Messages，点击保存。

2.在CC Switch设置中开启路由，如下图所示：

3.启用配置即可使用。

注意：Codex中使用GPT模型上游格式配置Responses，Claude选择Anthropic Messages，其他模型使用Chat Completions。

5. 常见问题

Q：切换后 Claude Code 没变化？
A：Claude Code 在启动时读取配置，请新开终端再启动 claude。

Q：Codex 报错或模型没切换？
A：Codex 启动时才读取模型目录，改完配置后必须重启 codex。同时检查 Base URL 是否带了 /v1。

Q：Codex 请求报格式 / 端点错误？
A：确认平台是否支持 Responses API。若平台只支持 Chat Completions，需在 CC-Switch 里开启本地路由。

Q：Base URL 到底带不带 /v1？
A：Claude Code 不带（https://www.moyu.cn），Codex 带（https://www.moyu.cn/v1）。这是两者最常见的配置差异。

Q：提示密钥无效？
A：检查 API Key 是否填写正确、是否有多余空格；Codex 还需确认 auth.json 的 OPENAI_API_KEY 为 null（密钥走环境变量注入）。

1. 安装 CC-Switch#

2. 魔芋AI平台快速导入#

2.1 快捷导入#

2.2 验证#

3. 切换供应商#

4. 模型路由配置（切换 / 指定其他模型）#

4.1 Claude Code 配置模型路由#

4.2 Codex 的模型路由#

5. 常见问题#