1. API快速配置
魔芋AI开发文档
  • API快速配置
    • CC-Switch快速配置(推荐)
    • Claude Code 与 Codex 安装配置
    • 智能体集成魔芋Skills
  • 魔芋SDK
    • SDK接口规范文档
    • SDK 完整示例
  • 模型
    • 获取可用模型列表
      GET
  • 文本对话
    • OpenAI 对话补全
      POST
    • OpenAI Responses
      POST
    • Anthropic 消息接口
      POST
    • Gemini 内容生成
      POST
  • 图片生成
    • 图片生成
      POST
  • 视频生成
    • 提交视频生成任务
      POST
    • 查询视频生成任务
      GET
    • 查询豆包视频任务状态
      GET
    • 按令牌获取视频任务列表
      GET
  • 素材库
    • 创建素材 / 批量上传
      POST
    • 查询素材列表
      POST
    • 查询单个素材
      POST
    • 按批次查询素材
      POST
    • 更新素材名称
      POST
    • 删除素材
      POST
    • 获取素材库列表
      GET
    • 创建素材库
      POST
    • 删除素材库
      POST
    • 转移素材库
      POST
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • OpenAIUsage
    • ResponsesRequest
    • ResponsesResponse
    • AnthropicMessageRequest
    • AnthropicMessageResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • ModelListResponse
    • ImageGenerationRequest
    • ImageGenerationResponse
    • SeedanceContentItem
    • SeedanceMetadata
    • VideoGenerationRequest
    • VideoTaskSubmitResponse
    • VideoTaskQueryResponse
    • VideoTaskListResponse
    • VideoTaskListItem
    • VideoAutoUploadRequest
    • VideoAutoUploadSubmitResponse
    • VideoFlatQueryResponse
    • AssetItem
    • CreateAssetRequest
    • CreateAssetResponse
    • ListAssetsRequest
    • ListAssetsResponse
    • GetAssetResponse
    • BatchGetAssetsResponse
    • AssetIdResponse
    • AssetGroupListResponse
    • ErrorResponse
  1. API快速配置

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控制台,点击令牌管理菜单,选择令牌行快速导入按钮。
QQ20260731-141227.png
2.如下图所示,在快速导入弹窗中选择Claude Code、Codex、Gemini等页签,页面中完成模型配置后点击"导入CC Switch"按钮,自动将魔芋平台配置导入CC Switch,在CC Switch中启用导入后的配置即可。
image.png

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,完成以上配置,点击保存。
image.png
2.在CC Switch设置中开启路由,如下图所示:
image.png
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.info/v1
1.如下图所示,在Codex中配置Claude模型,上游格式选择Anthropic Messages,点击保存。
image.png
2.在CC Switch设置中开启路由,如下图所示:
image.png
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.info),Codex 带(https://www.moyu.info/v1)。这是两者最常见的配置差异。
Q:提示密钥无效?
A:检查 API Key 是否填写正确、是否有多余空格;Codex 还需确认 auth.json 的 OPENAI_API_KEY 为 null(密钥走环境变量注入)。
修改于 2026-07-31 07:11:01
下一页
Claude Code 与 Codex 安装配置
Built with