发现很多佬对此有疑问，我尽量简明扼要的讲清楚
官方oauth登录不用往下读了，官方登录会自动写入好配置文件。
以下针对反代，其他模型api等等第三方情况。
必须要了解的前置知识
在一个智能体（比如codex和claude code）走第三方api，到底需要什么
-
API Key
一串密钥(sk-开头)，用来证明身份 + 计费。 -
URL（你的中转站，自己配置的反代，第三方模型供应商一定会告诉你这个地址）
服务器地址，告诉智能体去哪请求 AI。
例：https://…/v1 -
为什么 codex 的 url 带 /v1，claude code 不带
/v1 是接口的版本号，写在地址路径里。- codex 走 OpenAI 格式，版本号在 URL 里，所以要填到 /v1：
https://api.xxx.com/v1 - cc 走 Claude 格式，版本号在请求内部(header)里，程序自己处理，
所以只填根地址：
https://api.xxx.com
本质：两家接口规范不同，按文档/供应商示例填即可。在codex用的模型一定需要支持
- codex 走 OpenAI 格式，版本号在 URL 里，所以要填到 /v1：
codex接受什么模型
当然不是什么url都支持
无论什么模型（是的你可以在codex里面接入任何第三方模型，只要调用格式合法），必须支持「Responses API」(接口端点 /v1/responses)
-
这是什么意思？
OpenAI 有两套接口规范：- Chat Completions：老格式，为聊天设计。
- Responses：新格式，为 agent 设计，codex 只接受这种格式。（Anthropic的Messages API当然不支持）
-
我怎么知道我的url是Responses格式？
反代：通常指把多个账号，供应商订阅聚合到某个云平台或本地平台，对话暴露统一的url和api key，主流的cpa和sub2api是一定支持的
中转站：说白了就是大规模号池的盈利或不盈利的反代，商家会明说自己的url支不支持Responses。如果有人说仅支持Chat Completions，那就是不允许你在codex这类智能体里面使用。
一个codex的和鉴权相关的配置文件，有且仅有两个文件
用户\.codex\config.toml和用户\.codex\auth.json
前者是设置文件，后者只负责鉴权（填api key）。下面会详细讲这两个文件怎么写
auth.json如何填写
这个文件非常简单，没有任何歧义，你只需要填你的api key。
{
"OPENAI_API_KEY": "9bf9119......",
"auth_mode": "apikey"
}
-
注意：你会发现有的反代平台和中转站提供的api key是sk-9bf9119…
sk-是什么？
sk = secret key(密钥)的缩写，OpenAI 起的头，
各家中转沿用。它没有魔法，就是 key 字符串的开头几个字符。 -
为什么有的时候加上
sk-会提示api key无效，去掉sk-才能成功调用
服务器是拿你填的「完整字符串」去库里比对，
一字不差匹配上才放行。
你这个中转站库里存的真值就是不带 sk- 的(9b… 才是真 key)，
所以：- 填 sk-9b… → 多了 sk-，比对不上 → 无效令牌
- 填 9b… → 正好匹配 → 成功
那个 sk- 多半是它后台 UI 给你"装饰"上去的，不是 key 本体。
-
结论
key 要原样填，以「能调通的那个」为准。
下次遇到不确定，带 sk- 和不带 各试一次即可。
config.toml如何填写
这是一个有很高自由度的文件，在此我只讲他的最短配置，也是他必须承担的基础功能
如下，是一个最短配置需要包含的完整内容
model_provider = "a"
[model_providers.a]
name = "b"
base_url = "..."
(API Key 不在这里，在 auth.json)
逐行说明：
- model_provider 选用哪个 provider，值 = provider 的 id
- [model_providers.a] 定义该 provider，这个 a 就是它的 id
- name；可以认为是provider显示在codex内部的名字，他的作用只决定走不走远端压缩(见第二部分)，允许和前面的a不一样
- base_url 服务器地址(往哪请求)
注意：
- 两处 a 是同一个 id，必须完全一致，否则报错
(可换任意英文，但两处要一样)
我怎么知道我写的config.toml合不合法？
配置文件字段不合法的体现是：无法设置沙盒，点击使用备份沙盒也不会有任何反应。当然也无法进行任何对话。
打开codex后会如下图所示
远端压缩是什么，如何开启
-
压缩是什么？
本质就是一个ai调用，让ai对上下文进行总结（必定会损失某些细节信息，codex的压缩做的不错，压缩后的上下文会保留用户的输入和最近的清晰历史，ai会自己阅读代码，文档后跟进最新情况）
分为自动压缩和手动压缩，自动压缩临近上下文上限自动触发，手动压缩用/compact（codex app如果是中文版，是/压缩） -
远端压缩是什么
-
本地压缩：客户端自己叫模型把历史总结成「一段文字」存下来。注意这个“自己”。就是调用一次config存的url和auth存的api，让这个模型进行总结，和正常对话的模型是一个模型。
-
远端压缩：客户端调用服务器端点 /v1/responses/compact，
由「服务器」把历史压成一个加密块(blob)返回，
客户端看不到也改不了，下一轮原样回传、服务器解密还原。
"远端"二字就是指：压缩发生在服务器端，不在你本地。
-
-
远端压缩有什么好处
我不知道。众说纷纭，有人说压缩效果更好，期待有佬给出可信实证。 -
如何开启
-
把 name 改成严格的 “OpenAI”(大写 O 和 AI，差一字都不触发)：
model_provider = “a”
[model_providers.a]
name = “OpenAI”
base_url = “…”- 注意，远端压缩和前文说的provider的名字（就是那个得在两个地方一样的“a”）没有任何关系，只和[model_providers.a]里面的name有关。
-
压缩走 /v1/responses/compact，假如你自己部署反代（如cpa+new api）需要按照如下配置：
- CPA 侧配置模型 alias（映射）：
oauth-model-alias: codex: - name: "gpt-5.5" alias: "gpt-5.5-openai-compact" fork: true含义：
name = 真实上游模型 alias = 客户端请求模型名 fork = true 表示保留原模型，同时额外暴露 alias- 如果用new api：
渠道管理 -> 找到指向 CPA 的渠道 -> 编辑在模型列表里同时保留：
gpt-5.5 gpt-5.5-openai-compact- 不是所有的中转站都能远端压缩
看到这里可以发现，要启用远端压缩，中转站必须有模型映射这样的单独设置。如果没设置映射，那就用不了，作为用户可以让商家添加，或者把name改成非
OpenAI的任何名字即可（使用本地压缩）。 -
对话历史跟什么走
常见困惑：换了个中转站，怎么我之前的对话全不见了？
对话历史「仅仅」绑定 provider 的 id —— 就是那个要在两处
保持一致的 “a”。和块里的 name、api key、base_url 统统无关。
机制：每条对话在后台都记着「创建时用的 provider id」。
- config 里把这个 id 改了 → 旧对话只是被隐藏，不是删除
- 把 id 改回原来那个 → 这些对话又会重新出现
所以：换中转站(改 url / key)本身不丢历史，
真正让历史"消失"的，是顺手把那个 provider id 也改了。
(注意区分：远端压缩部分的 name 字段决定"压缩怎么走"，
这里的 provider id 决定"历史归在哪"。)
所以对话历史换供应商消失如何解决：显而易见就是只改url和api key，不要动provider id
暂时只想到这么多，config.toml的其他配置后续有空再补充。任何错误欢迎各位佬纠正
1 个帖子 - 1 位参与者