Windows Codex 图文配置

更新于 2026-09-20 · 页面与服务规则以当前控制台为准

先分清三件事

Codex 是客户端，CC Switch 管理配置，DragonAPI 提供模型接口与额度。 这三个软件或服务的账号和余额互不等同。DragonAPI 充值不会变成 ChatGPT 官方订阅，也不代表获得所有官方云端功能。

本页沿用 Windows PDF 的安装顺序。桌面应用、CLI 与扩展支持的登录方式会随版本变化，下载和登录入口以官方当前页面为准。第三方配置用于客户端支持的自定义供应商／本地工作流。

1. 下载并安装

1. 从 Codex 官方文档进入当前支持的下载入口；也可查看 Codex 产品页。按页面提示完成安装或官方账号登录。
2. 在 Windows「设置 → 系统 → 系统信息」确认系统类型，选择匹配的 x64 或 ARM64 包。
3. 从 CC Switch 项目 Releases下载桌面版。不要使用名称相似的 npm 包代替这个应用。
4. 启动 CC Switch。CLI 用户可继续看 Codex CLI 配置，桌面用户先按下面的导入流程操作。

2. 注册 DragonAPI 并准备密钥

在 控制台完成注册和邮箱验证，进入「API 密钥」创建独立密钥。具体界面见 新手图文教程。

选择自己的 GPT 分组，例如当前账号可见的 Pro 或 Plus，设置便于识别的名称、有效期和预算。需要试用可查看 试用与充值，以当前群公告为准。

模型从「获取模型列表」中选择完整 ID。 截图中的 gpt-5.6-sol 仅是历史示例；不要把不完整名称 gpt-5.6 当成可用模型。

3. 从密钥页面导入 CC Switch

1. 在密钥列表中找到自己的密钥，点击右侧「三个点」菜单，选择「CC Switch」。
2. 应用选择「Codex」，选择当前分组可用的模型，再点击「打开 CC Switch」。
3. 浏览器询问是否打开应用时，确认目的应用是已安装的 CC Switch。
4. 核对供应商名称、API 地址、密钥和模型，点击「导入」。
5. 在 CC Switch 的 Codex 页面启用刚导入的 DragonAPI 供应商，确认显示「使用中」。

核对导入的目标应用、地址、模型与密钥（PDF 脱敏示例） · 点击查看大图

4. 自动导入失败时手动添加

在 CC Switch 切换到 Codex，点击新增供应商。填写以下内容：

字段	填什么
名称	DragonAPI Codex，或你能区分的名称
官网链接	https://newapi.dragon3api.com
API Key	你在 DragonAPI 创建的完整密钥
API 请求地址	https://newapi.dragon3api.com/v1
默认模型	从当前可用列表选择完整模型 ID
协议	Codex 对应的 OpenAI Responses 兼容方式

手动配置字段，示例模型以当前列表为准（PDF 脱敏示例） · 点击查看大图

保存并启用配置。大陆线路、海外访问和长请求的选择见 线路与连接。

5. 测试连接，再测试真实对话

连接测试可能发送计费请求，先确认账户有测试额度。在 CC Switch 中点击连接测试按钮；通过后， 彻底退出 Codex、相关终端和 VS Code，再重新打开 。只关闭窗口可能仍有后台进程。

连接测试入口（PDF 历史示例，不代表当前延迟） · 点击查看大图

新建一个会话，发送「请只回复 OK」。确认三个结果：客户端收到回答、选择的模型符合预期、使用日志中有对应时间的请求。只有 CC Switch 绿色提示，还不足以说明整个对话链路都正常。

6. 配置没生效时怎么查

• 报错地址是 api.openai.com：先核对当前供应商与生效配置，请求可能仍走官方入口。
• 报错地址是本站：检查完整密钥、分组、过期时间、额度和模型权限。
• CLI、桌面程序或 WSL 使用不同用户目录时，确认你修改的是实际运行环境的配置。
• 更新软件后失效：先备份用户配置，核对当前版本的鉴权要求，再重新导入。 不要直接删除整个 .codex 目录 ，其中可能有会话与其他配置。
• 需要手工理解 env_key 和 requires_openai_auth，见 CLI 的鉴权说明。不要把所有 401 都用同一个开关处理。

详细对应关系见 错误排查。