Codex 本地客户端配置：共享 provider 与云端任务边界

分清产品入口与本地连接

Codex 有本地客户端与云端工作方式。官方认证说明，本地应用、CLI 和 IDE 扩展支持本地认证配置，云端 Codex 则要求 ChatGPT 登录。 这篇讨论本地模型连接，不承诺修改本地文件就能改变托管云端任务的上游。

IDE 扩展里还有两类设置：编辑器的 chatgpt.* 设置控制扩展表现，config.toml 控制模型、权限和 MCP 等 Agent 行为。 如果目标是更换 API，先找 Agent 配置，不要在编辑器字体或聊天外观设置里寻找 Base URL。

找到正在使用的配置层

用户配置位于 ~/.codex/config.toml。官方给出的 IDE 入口是侧栏齿轮、Codex Settings，再选择 Open config.toml。

CLI 和 IDE 共用配置层，但命令行覆盖、受信项目配置以及 profile 都可能影响有效值。

先备份准备编辑的文件，记录修改前的 provider 名称。最新高级配置说明，连接相关的 provider 键应放在用户配置，不应依赖项目目录下的同名键；看到启动警告时应核对这一限制。 不要把整个示例文件覆盖进已有配置。

定义一个独立 provider

下面是用户配置的局部示意，不是可运行服务：https://80321.cn/v1 仅为占位地址，本站没有提供经此教程验证的真实 API。模型和密钥也都是占位值。

model = "YOUR_MODEL_ID"
model_provider = "80321-example"

[model_providers.80321-example]
name = "80321-example"
base_url = "https://80321.cn/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
requires_openai_auth = false

这些字段分别选择模型、provider、协议和取钥变量。

官方当前规范只支持 responses 这一 wire_api 值；提供 Chat Completions 不等于满足此配置。

自定义 provider 若设置 requires_openai_auth = true，会忽略 env_key，因此必须根据实际认证方式选择。

编辑器里的最小对话

让启动编辑器的进程获得真实服务要求的环境变量后，再新建一个本地对话，只要求“返回 OK，不读写文件、不调用工具”。不要附加当前文件或仓库上下文。核对所选模型、有效 provider 与实际返回错误，不能仅凭模型选择器出现条目判定请求成功。

若 CLI 可用而 IDE 失败，分别确认两边的配置层和进程环境；若被管理策略拒绝，保留诊断信息交给管理员，不通过降低沙箱或更换认证模式绕开策略。官方说明，配置默认值仍受管理要求约束。

保留可回退的改动

只改这次需要的字段，保留原 provider 条目。遇到“不支持配置键”、认证与模型错误时先回到原连接，避免继续叠加不相关开关。密钥不写入仓库，也不截图展示。这里的 verified 仅表示官方字段已核对，不表示本站已联通，更不表示云端功能可由同一连接替代。