1. 客户端接入
迷雾AI 文档
  • 网站介绍
  • 快速开始注册
  • 模型状态监控
  • 客户端接入
    • ChatGPT(Codex)
    • Claude Code Desktop
  • 常见问题
    • 收不到邮件怎么办?
  • 服务协议
    • 迷雾 AI 服务条款(Terms of Service)
  1. 客户端接入

Claude Code Desktop

步骤 1:安装 CC Switch#

前往 CC Switch 官网 下载并安装适合系统的版本。

步骤 2:切换CC Switch聚合模式#

CC Switch有三种链接模式:直联、路由、聚合
模式
直连CC Switch 不经手任何请求,客户端直接连所选供应商,体验最原生。
路由请求经本机 CC Switch 转发,可热切换供应商,并支持故障转移、格式转换等高级功能。
聚合多家供应商的模型同列在 /model,在客户端内即可无感切换。
📌
这里推荐直接使用聚合模式,因为如果您想使用国模如deepseek等模型,需要切换至聚合模式,更改上游格式后才能使用,且聚合模式多家供应商的模型可在客户端内自由切换。
image.png
image.png

步骤 3:从迷雾导入配置#

1.
回到迷雾的「API 密钥」列表,找到刚创建的密钥,点击右侧「填入 CC Switch」图标。
image.png
点击密钥右侧的「填入 CC Switch」
2.
选择Codex,填写便于识别的配置名称,选择主模型,再点击「打开 CC Switch」。
image.png
选择应用、配置名称和主模型
3.
在 CC Switch 弹出的确认窗口核对应用类型、API 端点和模型,点击「导入」。服务地址、API Key 和模型配置会自动填入。
image.png
核对配置后点击「导入」
若勾选「导入后立即切换到这个供应商」,后续客户端请求将使用新配置。未勾选时,导入后再切换到该配置。

步骤 4:获取并选择模型#

1.
在 CC Switch 中找到刚导入的配置,点击右侧「编辑」图标。
image.png
编辑刚导入的配置
2.
点击「获取模型列表」,查看当前密钥分组可用的模型。
文档演示选择使用的模型为gpt-6-sol,该模型的上游格式为:Responses(原生)步骤2选择无误无需操作。但如果选择的是国模,格式选择:Chat Completions(需转换)
image.png
点击「获取模型列表」
3.
勾选需要使用的模型,点击「应用」;返回编辑页,确认默认模型,再点击「保存」。
image.png
选择模型后点击「应用」,再保存配置

步骤 5:重启客户端并验证#

保存后,完全退出并重新打开客户端。 以截图中的 Codex 为例,检查输入框旁的模型名称是否为刚才选择的模型,再发送一句简短消息确认可以正常回复。
image.png
重启客户端后,检查当前模型名称
如果仍显示旧模型,先确认 CC Switch 中已启用新配置、模型选择已经应用且配置已保存,再重新启动客户端。
修改于 2026-10-29 08:22:28
上一页
ChatGPT(Codex)
下一页
收不到邮件怎么办?
Built with