客户端接入 · Codex++

Codex++ 设置:在「供应商配置」里把本站 API 接进 Codex。

Codex++ 是本地 Codex 客户端的管理台:供应商、代理、请求日志、Codex 多开都在一个界面里。本文只讲接本站 API 要填的字段,配图和参数都按实际界面来。

一、Codex++ 和 CC Switch 是什么关系

两者都是「本地 Codex 配置管理工具」,最终都在改同一份 ~/.codex/config.toml(以及 API Key 的存放位置),区别在界面和侧重点:

工具界面特征适合谁
Codex++供应商配置 + 代理设置 + 请求日志 + Codex 多开 + MCP / Skills / 会话管理想在一个面板里管 Codex 全部设置、还要看请求日志的人
CC Switch按应用分(Claude Desktop / Codex / Gemini CLI / Grok Build…),供应商卡片一键切换,支持 ccswitch:// 一键导入多客户端、多供应商来回切,或直接用后台一键导入的人
不要两个工具同时改同一个供应商两边都写 ~/.codex/config.toml,后保存的会覆盖前面的。选一个作为主配置工具,另一个只用来切换/查看。

CC Switch 的配置方式见 CC Switch 绑定;本文只讲 Codex++。

二、准备两样东西

Base URL
https://api.tutujing.com/v1(Codex 必须带 /v1)
API Key
控制台「API 密钥」里新建,分组必须包含你要用的模型,形如 sk-...
模型名
与模型广场完全一致,例如 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-6.1-sol、gpt-6-sol

分组与模型对照见 API 填写。分组不含该模型时会返回 503 / model_not_found,不是密钥失效。

三、图文步骤

下面这张是 Codex++ 的「供应商配置」页,先用它定位每个字段的位置:

Codex++ 供应商配置界面:基础设置、接入方式、API 连接、模型配置、模型列表
Codex++ → 供应商配置(截图中 API Key 已打码)。页面从上到下依次是:基础设置 → 接入方式 → API 连接(Base URL / 上游协议 / API Keys)→ 模型配置 → 模型列表。
1

左侧选「供应商配置」,新建或编辑

左侧导航在「工作区」分组下:概览 / 供应商配置 / 代理设置 / 请求日志 / Codex多开 / 设置。进入后右上角有 诊断供应商使用中保存供应商,顶部还显示「Codex 运行中」和「重启 Codex」。

2

基础设置 → 名称

起一个能认出的名字,例如 TUTUJING 纯API。名称只是本地标识,不影响请求。

3

接入方式:选「纯 API」

三选一:

选项含义什么时候用
官方登录只走 ChatGPT 官方账号,不写 API 凭证用官方额度,不接第三方
官方登录 + API保留官方账号登录,同时用下面的 API 连接想保留官方身份、又要把请求转到本站
纯 API只用 API 凭证,不依赖官方登录接本站 API 推荐这一项
4

API 连接:Base URL / 上游协议 / API Keys

Base URL
https://api.tutujing.com/v1
上游协议
Responses API(本站 Codex 通道走 /responses;选错会 404)
API Keys
粘贴 sk- 密钥,点「+ 添加 Key」可以放多把,用于轮换
地址别再手写 /v1/responses填到 /v1 为止,路径由客户端自己拼。写成 /v1/responses 会变成 /v1/responses/responses。
5

模型配置 → 配置模型

这里填的是默认启动模型,不要带后缀(不要写成 gpt-6-astra-high)。界面上也写明了:上下文窗口在下方「模型列表」里按模型单独配。

6

模型列表:每个模型一行

可以用「从上游获取」拉列表,也可以「+ 添加模型」手填。每行有 5 个参数:

列作用建议
模型名称必须与本站模型广场一致gpt-6-astra / gpt-5.6-sol / gpt-5.6-terra / gpt-6.1-sol / gpt-6-sol
上下文窗口单模型可用上下文长度,可写 1M、200K 或 1000000;留空用 Codex 默认272000(截图里的实际取值,够用且不虚标)
自动压缩接近上限时自动压缩历史的比例90%
图片处理方式截图/图片传给上游的方式原样发送图片
思考等级可选的 reasoning 档位low → ultra(Codex 自己的 model_reasoning_effort 走这里)
模型名写错不会自动回落列表里有、但本站分组没有的模型,请求会 503 model_not_found。加模型前先确认分组能覆盖。
7

保存 → 重启 Codex

点右上角 保存供应商,再点顶部 重启 Codex。Codex 只在启动时读 config.toml,不重启不生效。

8

验证

  1. 点 诊断供应商 看连通性(注意:它通常只测地址可达,不等于能出字)。
  2. 在 Codex 里发一条最小请求,比如「只回复 ok」。
  3. 回 Codex++ 左侧「请求日志」看状态码、模型、耗时。
  4. 再到本站控制台「日志」,确认模型、令牌、分组都对,扣费也一致。

四、字段速查表

Codex++ 字段本站该填什么
接入方式纯 API
Base URLhttps://api.tutujing.com/v1
上游协议Responses API
API Keyssk- 开头的密钥(分组要含目标模型)
配置模型默认模型名,不带后缀,如 gpt-6-astra
模型列表 · 模型名称与模型广场一致,如 gpt-5.6-sol
模型列表 · 上下文窗口272000
模型列表 · 自动压缩90%
模型列表 · 图片处理方式原样发送图片
模型列表 · 思考等级low → ultra

五、和 CC Switch 对照(同一台机器的另一套界面)

如果你团队里有人用 CC Switch,字段其实是同一批,只是名字不同。下图是 CC Switch 的 Codex 供应商编辑页(截图里的密钥已打码、auth.json 段已裁掉):

CC Switch 的 Codex 供应商编辑界面:名称、API Key、API 请求地址、模型列表、默认模型、子代理模型、自动审批模型
CC Switch → Codex → 编辑供应商。注意顶部提示:保存后会立即写进 ~/.codex/config.toml,下一次请求生效。
Codex++CC Switch 对应字段
Base URL「API 请求地址」→ https://api.tutujing.com/v1
API Keys「API Key」和下方 auth.json 里的 OPENAI_API_KEY
上游协议由 CC Switch 固定写 wire_api = "responses"
配置模型「默认模型」,如 gpt-6.1-sol
模型列表「模型列表」→「获取模型列表 / 手动添加」
思考等级「子代理模型」右侧的强度下拉(如「默认强度」)
自动审批「自动审批模型」→ Codex 默认 codex-auto-review
「自动审批」这一项要留意界面原话:Codex 会用官方的 codex-auto-review 审批,只有部分转发 ChatGPT 账号的中转会认;不认就会报 404。在模型列表里加上该模型后才能选。

六、常见问题

现象原因处理
404Base URL 少写 /v1,或上游协议不是 Responses API改成 https://api.tutujing.com/v1 + Responses API
401密钥错、已禁用、或复制时带空格重新复制;确认密钥状态
503 / model_not_found该密钥分组的模型里没有这个模型换分组,或在模型列表里换成分组有的模型
改了没反应Codex 只在启动时读配置点「重启 Codex」或完全退出重开
模型列表拉不出来「从上游获取」失败(分组/网络)手动「+ 添加模型」,名字照模型广场抄
两个工具互相覆盖Codex++ 和 CC Switch 都在写 config.toml只保留一个主配置工具

七、安全提醒

继续阅读:API 填写与模型分组 · CC Switch 绑定 · 完整文档站