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

ChatGPT(Codex)

ChatGPT(Codex) 是 OpenAI 推出的 AI 编程智能体桌面应用。你可以把它理解为:不只是帮你写代码的聊天机器人,而是一个能够直接操作项目文件、编写和修改代码、运行命令、测试程序,并协助你完成整个软件项目的 AI 程序员。

第一步:安装 ChatGPT#

前往 ChatGPT官网 下载桌面客户端,默认情况下这里会显示您当前的操作系统版本。(需要挂代理访问)
image.png
下载后直接安装即可。

第二步:获取 API 密钥#

前往 迷雾AI 官网 控制台创建你的 API 密钥。
详细的密钥创建步骤见 快速开始。

第三步:配置接入#

下面提供两种方式:用 CC Switch 一键管理(推荐),或自己手动配置。

方式一:用 CC Switch(推荐)#

如果你需要在多套 Provider、多个 CLI 工具之间频繁切换,推荐用 CC Switch 集中管理配置,无需反复改环境变量。
详见 下载 CC Switch →

第1步:切换CC Switch聚合模式#

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

第2步:从迷雾导入配置#

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

第3步:获取并选择模型#

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

第4步:重启客户端并验证#

保存后,完全退出并重新打开客户端。 以截图中的 Codex 为例,检查输入框旁的模型名称是否为刚才选择的模型,再发送一句简短消息确认可以正常回复。
image.png
重启客户端后,检查当前模型名称
如果仍显示旧模型,先确认 CC Switch 中已启用新配置、模型选择已经应用且配置已保存,再重新启动客户端。

方式二:手动配置#

由于手动配置是少数专业技术人员才会选择的方式,所以只给出ChatGPT官方文档的配置教程入口。ChatGPT官方文档
修改于 2026-10-29 13:51:59
上一页
Claude Desktop
下一页
WorkBuddy
Built with