1. 快速接入
AnyRoute
  • AnyRoute用户手册
  • AnyRoute｜售后群
  • 支持模型列表
  • 常见问题
  • 环境准备
    • Node.js 环境安装指南
    • CC Switch介绍
  • 快速接入
    • ClaudeCode 快速开始指南
    • Codex 快速开始指南
    • OpenClaw 快速开始指南
    • Hermes 快速开始指南
    • Cherry Studio 快速开始指南
    • Claude Desktop 快速开始指南
    • Codex Desktop 快速开始指南
    • GPT Image 2 使用指南
    • Claude Code VS Code 图形化操作教程
  • 进阶指南
    • 自用 AGENTS.md 全局规则
    • Claude Code 与 Codex 协同开发指南
  1. 快速接入

Codex Desktop 快速开始指南

windows 系统#

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

第一步，下载安装#

1.官网下载codex客户端地址openai.com （打不开网站的下载开加速器）
2.或者直接在微软商店输入codex下载
image.png
image.png
下载打开后
image.png
image.png
这里先退出软件，完全退出，右下角图标也要退出，等第二步完成后再打开

第二步，配置环境#

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

CC Switch配置方法#

没下载ccswitch的可以先下载 https://wwbbl.lanzoul.com/i5md23rkmpib
下载完成后右上角添加 选gpt图标的别选Claude的
image.png
image.png
image.png
这里可以获取模型 模型获取完成后直接保存即可
image.png
运行正常直接下一步就行，然后保存
点这里运行正常即可下一步

手动配置方法#

使用编辑配置文件方式配置 Codex 环境变量
打开文件资源管理器，找到 C:\Users\你的用户名\.codex 文件夹（如果没有则创建） 如图:
image.png
创建config.toml,用Notepad打开，输入以下内容：
disable_response_storage = true
model = "gpt-5.5" 
model_provider = "custom"
model_reasoning_effort = "high"
windows_wsl_setup_acknowledged = true

[model_providers.custom]
base_url = "https://cc.anyroute.io/v1"
name = "custom"
requires_openai_auth = true
wire_api = "responses"

[notice]
hide_full_access_warning = true
创建 auth.json 文件，在文件添加以下内容：
{
  "OPENAI_API_KEY": "hone_xxx"
}
把hone_xxx替换为你的https://cc.anyroute.io后台创建的key即可
重新进入Codex Desktop后测试
image.png
image.png
回复说明测试没问题正常使用即可

Mac 系统#

和win系统原理都是一样 操作一样 看WIN操作对应操作即可
一共2步骤 第一配置下载软件 第2配置环境模型
Mac 找不到.codex文件的 直接终端输入指令 open ~/.codex

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

推荐顺序是：
1.
在 CC Switch 的 Codex 面板切换到 OpenAI Official。
2.
启动 Codex，并用官方 ChatGPT / Codex 账号登录一次，Free 订阅也可以（为了将 access token 写入配置文件）。
3.
回到 CC Switch，打开 设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录。
4.
添加或切换到Anyroute api。
5.
重启 Codex，让 config.toml 和模型目录重新加载。
image.png

准备工作#

你需要准备：
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 供应商（如果没有的话，就在预设供应商当中添加一个），并把它设为当前供应商。
image.png
接着启动 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
image.png

第四步：切换第三方供应商并重启 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，模型流量则切到第三方供应商。
修改于 2026-07-14 14:59:00
上一页
Claude Desktop 快速开始指南
下一页
GPT Image 2 使用指南
Built with