Codex Desktop 快速开始指南

Windows 系统

一共2步骤：第一步下载软件，第二步配置环境

第一步，下载安装

1.官网下载codex客户端地址openai.com （打不开网站的下载开加速器）

2.或者直接在微软商店输入codex下载

下载安装完成后直接退出软件，完全退出，右下角图标也要退出，等第二步完成后再打开

第二步，配置环境

关闭编辑器窗口和客户端

已经打开了codex桌面客户端的，要先退出账号右下角关闭客户端

CC Switch配置方法

没下载ccswitch的可以先下载 https://wwbbl.lanzoul.com/i5md23rkmpib

下载完成后右上角添加选gpt图标的别选Claude的

这里可以获取模型模型获取完成后直接保存即可

运行正常直接下一步就行，然后保存

点这里运行正常即可下一步

手动配置方法

使用编辑配置文件方式配置 Codex 环境变量

打开文件资源管理器，找到 C:\Users\你的用户名\.codex 文件夹（如果没有则创建）如图:

创建 config.toml，使用记事本打开，并输入以下内容：

model = "gpt-5.6-sol"
model_provider = "anyroute"
model_reasoning_effort = "high"

[model_providers.anyroute]
name = "AnyRoute"
base_url = "https://cc.anyroute.io"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

在 PowerShell 中将 API Key 设置为当前用户环境变量，并把 YOUR_API_KEY 替换为 AnyRoute 后台创建的 Key：

[System.Environment]::SetEnvironmentVariable(
  "OPENAI_API_KEY",
  "YOUR_API_KEY",
  [System.EnvironmentVariableTarget]::User
)

环境变量可被当前用户启动的进程读取。共享电脑建议优先使用 CC Switch 或其他安全凭证管理方式，不要把 Key 写入代码仓库或共享脚本。

重新进入Codex Desktop后测试

回复说明测试没问题正常使用即可

macOS 系统

和win系统原理都是一样操作一样看WIN操作对应操作即可

一共2步骤第一配置下载软件第2配置环境模型

如果在 Finder 中找不到 .codex 目录，可在终端运行：

解锁 Codex 在使用 API 的时候的远程操作和官方插件等能力

推荐顺序是：

在 CC Switch 的 Codex 面板切换到 OpenAI Official。

启动 Codex，并用官方 ChatGPT / Codex 账号登录一次，Free 订阅也可以（为了将 access token 写入配置文件）。

回到 CC Switch，打开设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录。

添加或切换到Anyroute api。

重启 Codex，让 config.toml 和模型目录重新加载。

准备工作

你需要准备：

CC Switch v3.16.1 或更新版本【下载链接】。

已安装并能启动的 Codex（建议 app 和 cli 都安装）。

一个可以登录 Codex 的官方 ChatGPT / Codex 账号，Free 订阅可。

AnyRoute后台创建好 API Key

请不要手动复制或分享 ~/.codex/auth.json 的内容。里面保存的是官方登录缓存和 Access Token，属于敏感信息。

第一步：先切回 OpenAI Official 并完成官方登录

打开 CC Switch，切到顶部的 Codex 标签页。先选择 OpenAI Official 供应商（如果没有的话，就在预设供应商当中添加一个），并把它设为当前供应商。

接着启动 Codex（建议启动 cli），按 Codex 的官方登录流程登录你的 ChatGPT / Codex 账号。这个账号可以是 Free 订阅；在这个方案里，它主要负责保留 Codex 官方 App 需要识别的登录身份，不负责第三方模型的计费。

登录完成后，Codex 会在 ~/.codex/auth.json 中保存官方登录缓存。后面的关键点就是：不要再让第三方供应商切换覆盖这个文件。

第二步：开启 Codex 应用增强

回到 CC Switch，进入：

设置 → 通用 → Codex 应用增强

打开：

切换第三方时保留官方登录

这个开关默认关闭，是因为部分用户并不想要这个功能。只有在你明确需要“第三方 API + 官方远程操作 / 官方插件”同时存在时，才需要开启它。

开启后，后端切换 Codex 第三方供应商时会走 config-only 写入路径：

auth.json：继续保留官方 ChatGPT / Codex 登录缓存。

config.toml：写入当前第三方供应商的模型、endpoint、model_provider 和 experimental_barer_token。

第三步：添加第三方 Codex 供应商

回到 Codex 面板，点击右上角的加号添加供应商。

Base url https://cc.anyroute.io

API key 填入你的后台创建的key

第四步：切换第三方供应商并重启 Codex

回到 Codex 供应商列表，启用你刚添加的第三方供应商。切换完成后建议重启 Codex，原因有两个：

Codex 在启动时读取 config.toml。

Codex 的 /model 菜单通常需要重启后才会重新加载 model_catalog_json。

重启后，你可以做一个简单验证：

在 Codex App 里，账号信息仍然显示官方账号，这是预期行为。

在 CC Switch 里，当前 Codex 供应商显示为第三方供应商。

如果开启了本地路由，请求日志或路由统计会看到 Codex 请求经过本地路由。

第三方供应商后台或余额记录会出现实际模型请求。

需要理解的副作用

Codex 里显示的账号始终是官方账号

这是最容易误解的一点。开启该能力后，Codex App 看到的是 auth.json 里的官方登录态，所以它会继续显示官方账号信息。

但这不代表模型请求还在走官方 OpenAI。实际流量以 CC Switch 当前 Codex 供应商、config.toml 和本地路由日志为准。

不要用 Codex 账号信息判断计费方

如果你切到 AnyRoute，Codex 里仍然显示官方账号，但模型请求会走 AnyRoute API。计费、限额、错误码和数据策略都应按AnyRoute理解。可以查看设置用量面板里的具体请求信息。

修改模型映射后要重启 Codex

Codex 的模型目录是启动时读取的。即使 CC Switch 已经生成了新的模型目录，正在运行的 Codex 也不一定会热加载，所以修改模型映射后请重启 Codex。

关闭开关会回到旧行为

如果关闭切换第三方时保留官方登录，第三方供应商切换会沿用兼容旧版本的行为，可能重新写入 auth.json。如果你的目标是长期保留官方远程操作和官方插件，建议保持该开关开启。

常见问题

我已经切到第三方 API，为什么 Codex 还显示官方账号？

这是预期行为。官方账号信息来自 auth.json，模型请求的实际供应商来自 config.toml 和 CC Switch 当前供应商。

Free 订阅真的可以吗？

可以。这里的官方账号主要用于获取并保留 Codex App 需要的官方登录态。第三方模型请求使用的是你在 CC Switch 里配置的第三方 API Key。

开启后官方插件或手机远程操作还是不可用怎么办？

先切回 OpenAI Official，重新启动 Codex 并完成一次官方登录；然后确认 CC Switch 的设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录已开启，再切回第三方供应商。

第三方请求 404、模型列表不对或流式响应异常怎么办？

如果该供应商是 Chat Completions 协议，请确认供应商表单里开启了需要本地路由映射，并且设置 → 路由里已经启动路由总开关、启用 Codex 接管。

可以在本地路由模式下切回 OpenAI Official 吗？

不建议。CC Switch 会尽量阻止在本地路由接管模式下切到官方供应商，因为用代理访问官方 API 可能带来账号风险。建议官方登录只用于保留 auth.json，模型流量则切到第三方供应商。

Codex Desktop 快速开始指南

Windows 系统#

第一步，下载安装#

第二步，配置环境#

CC Switch配置方法#

手动配置方法#

macOS 系统#

解锁 Codex 在使用 API 的时候的远程操作和官方插件等能力#

准备工作#

第一步：先切回 OpenAI Official 并完成官方登录#

第二步：开启 Codex 应用增强#

第三步：添加第三方 Codex 供应商#

第四步：切换第三方供应商并重启 Codex#

#

需要理解的副作用#

常见问题#