先看错误信息
model provider errorCodex model provider error 先记录底层状态、Provider、wire_api 和实际端点，分清配置解析、鉴权、模型授权与响应事件。普通 Chat 成功不能证明 Codex 所需 Responses 和工具流可用，修复后验收真实代码任务。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
常见表现
- Codex 可启动但调用失败
- 错误包含 provider
- 换 Key 仍失败
这个报错是什么意思
2026-10-07 核对官方高级配置。Codex 0.134.0 起 --profile 读取 <name>.config.toml，旧 [profiles.name] 与顶层 profile 选择字段已停止支持。本轮未新增在线请求。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
TOML / provider not found：请求可能尚未发出，换 Key 不解决加载问题。
判断 02
profile 不生效：看实际用户目录与独立文件，不继续修旧 [profiles]。
判断 03
CLI 正常 App 或远程失败：核对各自启动变量、CODEX_HOME 与用户配置。
判断 04
HTTP 请求失败：保存状态、准确 ID、最终路径、时间和脱敏正文，再定位权限/协议/网络。
按顺序修复
01
先记 codex --version 与错误指向，备份实际 CODEX_HOME 的用户配置。
02
对齐 model_provider 与 [model_providers.apizt]，顶层字段写在表头前。
03
需要独立切换时把片段放 apizt.config.toml，用 --profile apizt；保留基础配置。
04
用 features list 先检查本地加载，再验收 Key、Responses 和真实任务。
详细修复步骤
Step 01
同名 provider 与实际作用域
选择字段和 provider 表必须同名。当前项目 .codex/config.toml 不能覆盖 provider；用户文件和独立 profile 分层合并，CLI 覆盖可能再改变值。
Step 02
切换 profile 与恢复基础配置
将差异放实际用户目录的 apizt.config.toml。--profile apizt 指定该层；退出后不带 --profile 使用基础层，但基础层若本身指向网关，仍不会自动恢复官方。CC Switch 路由接管时先按它的恢复流程处理。
Step 03
Key 只在原进程的环境
env_key 是变量名 tokenba_API_KEY，不是实际凭据。桌面 App、WSL、SSH、容器和本机 CLI 分别核对；只打印存在与否，不打印 Key。
Step 04
协议与完整工具任务
wire_api=responses，base_url 带 /v1。gpt-6-sol 已在公开目录列出 Responses，但当前分组、工具事件和权限仍需验收；有效短文本与完整仓库任务分别记录。
正确配置
model = "gpt-6-sol"
model_provider = "apizt"
web_search = "disabled"
[model_providers.apizt]
name = "apizt"
base_url = "https://api.apizt.com/v1"
wire_api = "responses"
env_key = "tokenba_API_KEY"
supports_websockets = false常见原因
- provider 选择名与子表不一致
- provider 写在项目配置，当前版本忽略该机器本地设置
- 旧 profiles 表不再被当前 --profile 读取
- env_key 变量不在原启动环境
- 目标模型或令牌分组未支持 Responses
不要这样填
model_provider = "custom"
[model_providers.apizt]
base_url = "https://api.apizt.com/v1"
# 不再使用旧 [profiles.apizt] 作为新版 profile怎么确认已经修好
- codex --profile apizt features list 本地加载无 TOML/provider 错误。
- 实际启动环境变量存在，模型与分组支持 Responses；自行最小调用并核对有效内容。
- 在独立测试仓库实际读取、修改实现和运行原测试；人工 diff 与独立复跑。
避免下次再报错
- 团队内统一一份 Base URL 和模型名，不要让每个人从不同教程复制配置。
- 给生产任务和个人调试任务分开 API Key，方便定位是谁触发了限流或余额消耗。
- 工具升级后先保留旧配置备份，再用一个短 prompt 验证连通性。
- 把正确配置写进团队文档，尤其标明 Claude Code 和 OpenAI 兼容工具的 Base URL 差异。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
先查 provider 与 profile，再检查真实任务
2026-10-07 核对当前官方配置：0.134.0 起 --profile 读取独立 <name>.config.toml；项目层 provider 被忽略。这里深化配置诊断，没有新增在线 Codex 请求；既有公开仓库任务的证据保留在案例页。
- 观察对象
- 配置尚未加载
- 检查办法
- codex --version；完整错误与实际文件
- 通过条件
- 先修 TOML、provider 同名子表
- 观察对象
- profile 选择
- 检查办法
- 实际 CODEX_HOME 下 apizt.config.toml
- 通过条件
- --profile apizt 不依赖旧 [profiles]
- 观察对象
- 配置作用域
- 检查办法
- 用户级文件、profile、CLI 覆盖
- 通过条件
- provider 不只放项目 .codex/config.toml
- 观察对象
- 认证与进程环境
- 检查办法
- env_key 指向 tokenba_API_KEY
- 通过条件
- 原 CLI/App/远程宿主环境有变量
- 观察对象
- 最终协议与任务
- 检查办法
- /v1/responses；工具、测试和 diff
- 通过条件
- 有效回答后，完整原任务独立验收
一个 profile 的安全切换验收
- 先备份实际配置，把脱敏片段合并到实际用户目录的 apizt.config.toml，保留已有文件和其他表。顶层 model/provider 写在首个表头之前。
- 运行 codex --profile apizt features list，仅检查本地加载。退出测试会话后，不带 --profile 启动会读基础配置；只有基础配置本身仍为原入口才算切回。
- 在实际启动环境设置 Key，核对支持 Responses 的 gpt-6-sol。再自行最小调用与公开仓库任务；CLI、桌面、本机和 WSL/SSH 结果分别记录。
配置与验证示例
接入包检查模式不发请求；客户端与脚本按各自说明操作。
codex --version
codex --profile apizt features list
# 从当前 profile 退出后，不带 --profile 使用基础配置
codex核验日期与验证范围见各页记录；历史实测保留原日期，示例和空白记录表不等于真实任务结果。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
Codex model provider error 如何判断协议不匹配？
对照当前 wire_api 与最终请求端点，检查服务是否支持对应 Responses 或其他明确配置的协议。保存错误正文与流式事件，不能只根据模型品牌或 Chat 测试成功判断。
Codex Provider 修复后怎样验证工具任务？
在独立目录让 CLI 读取一个测试文件并完成小修改，查看文件差异和命令输出，再核对平台请求。短文本回复只验证部分链路，不能代表工具任务完成。
新版 profile 放在哪？
实际 CODEX_HOME 下的 apizt.config.toml，默认 ~/.codex/apizt.config.toml，再用 codex --profile apizt。0.134+ 不再读取旧 profiles 表。
不带 --profile 就会切回官方吗？
它使用基础配置。只有基础配置原本为官方入口且没有 CLI、变量或 CC Switch 接管覆盖，才会恢复该入口。
features list 通过就是模型可用吗？
只说明本地加载通过。Key、Responses 权限、工具任务和实际费用仍需分别验收。
2026 年 11 月 5 日补测
Codex Provider 报错：用请求路径区分 API 形态
发送两种固定协议请求，核对 Chat 和 Responses 的输入字段及路由。
- 本地 HTTP 故障复现（固定回包）。
- 准备独立样例。安装文章所用客户端，或用 Python 3.11+ 运行标注为本地 HTTP/TOML 的样例。
- 本例操作：发送两种固定协议请求，核对 Chat 和 Responses 的输入字段及路由。
- 解压练习包，执行 python3 lab.py --output ./result u10。完整命令、样例输入和输出保存在回执。
- 打开 result/u10.json，对照实际退出码、请求路径或产物字段。
- 逐项确认下方通过条件。本例的测试范围以运行回执为准。
- 通过：Chat 的 choices 与 Responses 的 output 分开核对
先下载样例，再完成自己的首次调用
示例不含密钥。API 按实际用量计费；下载和点击不代表调用成功。