1. 打开中转站地址
打开中转站地址:https://codexzhongzhuan.com
2.登录账号或者key
登录账号创建 API Key
3. 安装客户端(任选其一)
3.1 Codex Desktop App(推荐)
注意软件界面是英文的,开了魔法才可以正常切换界面语言。
Windows 用户可以通过微软商店下载安装。
官方地址:https://apps.microsoft.com/detail/9plm9xgg6vks
进入页面后:点击 获取 / 下载 按照提示安装即可。
如果电脑打不开微软商店,可以使用直装中文版:https://github.com/vaportail/codex-windows-updater/releases/
3.2 VSCode 插件
- 先下载并安装 VSCode。
- VSCode 官方下载地址:https://code.visualstudio.com/Download
- 打开 VSCode 扩展市场。
- 搜索
Codex。 - 安装插件并重启 VSCode。
3.3 Codex CLI
- 安装 Node.js(已安装可跳过)。
- 打开终端(
cmd、powershell或系统终端)。 - 验证环境:
node-vnpm-v- 安装 Codex CLI:
npminstall-g@openai/codex详细版本:
Codex CLI 安装、配置、使用与认证指南: https://blog.zhijun.io/posts/codex-cli-guide
4. 充值余额
4.1 新用户流程
- 注册并登录控制台账号。
- 进入「充值/订阅」页面进行充值。
4.2 老用户流程
- 登录已有控制台账号。
- 进入「充值/订阅」页面进行充值。
5. 创建 API Key
- 左侧进入「API 密钥」。
- 点击「+ 创建密钥」。
- 创建后点击「使用密钥」,查看接入参数。
6. 配置 Codex
6.1 cc-switch 配置(方法一,推荐新手)
下载一个 cc-switch
https://github.com/farion1231/cc-switch/releases打开后选择右上角
+,选择Codex供应商并进入自定义配置。API KEY填写上一步创建得到的 API Key,API 地址填写https://codexzhongzhuan.com。这个界面往下滑,也可以手动修改
config.toml配置文件。可以根据下文的“手动修改 codex 配置文件”,补全其他配置。添加后,回到主页面点击启用,重新打开 Codex 即可正常使用。
如果想要测试模型,记得单独配置“测试模型”。
6.2 手动修改codex配置文件(方法二)
- Windows:
C:\Users\你的用户名\.codex\ - macOS / Linux:
~/.codex/
重点文件:
config.toml:模型与服务地址配置auth.json:API Key 鉴权配置
6.2.1 config.toml 示例
gpt-5.4配置:
model_provider = "codexzhongzhuan" model = "gpt-5.4" model_reasoning_effort = "high" model_context_window = 1000000 model_auto_compact_token_limit = 900000 [model_providers.codexzhongzhuan] name = "codexzhongzhuan" base_url = "https://codexzhongzhuan.com" wire_api = "responses" requires_openai_auth = true [features] enable_request_compression = truegpt-5.5配置:
model_provider = "codexzhongzhuan" model = "gpt-5.5" model_reasoning_effort = "high" [model_providers.codexzhongzhuan] name = "codexzhongzhuan" base_url = "https://codexzhongzhuan.com" wire_api = "responses" requires_openai_auth = true [features] enable_request_compression = true使用5.5建议删除model_context_window和model_auto_compact_token_limit这两个配置,不然可能会 上下文压缩失败。
类似的配置还有max_tokens和context_length也删除下,不然也可能导致会话卡死。
说明:
- model:默认模型名称,请改成你中转站真实支持的模型 ID
- model_reasoning_effort:默认推理强度,可选如 low、medium、high、xhigh
- model_context_window:模型上下文窗口上限,用于控制最大可用上下文长度
- model_auto_compact_token_limit:自动压缩上下文的触发阈值,通常应小于 model_context_window
- base_url:OpenAI 兼容接口地址
- requires_openai_auth = true:表示使用 OpenAI 风格鉴权
- wire_api = “responses”:使用 Responses 接口模式
- enable_request_compression = true:启用请求压缩,减少长上下文请求体积
6.2.2 auth.json 示例
{"OPENAI_API_KEY":"sk-your-token-here"}将sk-your-token-here替换为你在控制台创建的真实密钥。
7. OpenClaw(可选)
7.1 手动配置
- 适合熟悉
openclaw.json的用户。 - 按 OpenClaw 现有配置结构手动合并中转站接入参数,不建议整份覆盖原配置。
参考片段如下,请按你的现有配置做合并:
{"models":{"mode":"merge","providers":{"openai":{"baseUrl":"https://codexzhongzhuan.com/v1","apiKey":"<换成你的apikey>","api":"openai-responses","models":[{"id":"gpt-5.4","name":"GPT 5.4","reasoning":true,"input":["text","image"],"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite":0},"contextWindow":272000,"maxTokens":128000}],"authHeader":true}}},"agents":{"defaults":{"model":{"primary":"openai/gpt-5.4"},"workspace":"/<换成你的用户级目录>/.openclaw/workspace","compaction":{"mode":"safeguard"},"thinkingDefault":"xhigh","timeoutSeconds":1800,"maxConcurrent":4,"subagents":{"maxConcurrent":8}}}}注意:
- 这是参考片段,请合并到原有配置中,不要整份直接覆盖。
<换成你的apikey>与用户目录路径都需要替换成你本地的真实值。
7.2 借助外部 AI Agent 自动配置
推荐先安装openclaw-configskill,再让外部 AI Agent 按文档完成配置。
以下流程和提示词适用于 Codex、OpenCode、Cursor、Trae 等主流 AI Agent,下面示例以 Claude Code 为例。
须知一:必须先安装openclaw-configskill,这样外部 AI Agent 才能获得更准确的 OpenClaw 配置上下文,减少协议冲突和字段错误。
须知二:不要让 OpenClaw 直接修改自己的配置文件。正确做法是使用外部 AI Agent 在 OpenClaw 之外完成配置,避免写错后无法启动。
- 安装
openclaw-configskill。 - 确认 skill 已正确加载。
- 将模板中的 API Key 占位符替换为真实密钥后,再执行配置。
步骤 1:安装 skill
npx skillsaddhttps://github.com/adisinghstudent/easyclaw--skillopenclaw-config步骤 2:验证 skill 是否成功加载
请你测试 openclaw-config 这个 skill 是否成功加载步骤 3:填入 API Key 后执行配置
将下面模板中的<换成你的apikey>和工作目录占位符替换为真实值,再交给外部 AI Agent 执行:
使用openclaw-config为我的openclaw接入gpt-5.4作为主模型并完成三轮工具调用测试,测试通过之后再更新各频道配置。以下是参考json: { "models": { "mode": "merge", "providers": { "openai": { "baseUrl": "https://codexzhongzhuan.com/v1", "apiKey": "<换成你的apikey>", "api": "openai-responses", "models": [ { "id": "gpt-5.4", "name": "GPT 5.4", "reasoning": true, "input": ["text", "image"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 272000, "maxTokens": 128000 } ], "authHeader": true } } }, "agents": { "defaults": { "model": { "primary": "openai/gpt-5.4" }, "workspace": "/<换成你的用户级目录>/.openclaw/workspace", "compaction": { "mode": "safeguard" }, "thinkingDefault": "xhigh", "timeoutSeconds": 1800, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } } }说明:
- OpenClaw 仍在快速迭代,手动配置更容易因为字段或协议变化出错。
- 如果你是零基础用户,优先选择自动配置方式更稳妥。
8. 遇到问题怎么排查
优先检查:
- 兑换状态是否生效。
- API Key 是否正确填写到配置文件。
base_url与接口模式是否正确。- 网络与客户端版本是否正常。