模型配置写完，不代表已经成功。
真正成功的标准是：Codex 能在当前入口里正常使用这个配置完成一次只读任务，并且没有密钥、模型名、Base URL、额度、权限相关错误。
> 前置教程：CLI、桌面版、IDE 配置为什么能共用
> 如果你还不清楚 config.toml、.env、项目级配置和临时选择的关系，先完成前置教程。
> 依据来源：OpenAI Codex 官方手册中的 Models、Configuration、Custom model providers、Authentication、Troubleshooting 思路。
先只验证一个入口。
不要同时验证 CLI、桌面版、IDE。
你可以从下面选一个：
| 入口 | 适合怎么验证 |
| ------ | ----------------------- |
| 桌面版 | 打开练习项目，新建会话，发只读提示词 |
| CLI | 进入练习项目，启动 Codex 后发只读提示词 |
| IDE 扩展 | 打开练习项目，在侧边栏发只读提示词 |
本篇的核心方法是一样的：让 Codex 做只读确认，不要先改代码。
复制下面这段：
``
请帮我验证当前 Codex 会话的模型配置是否可用。
要求：
- 只做只读检查，不要修改任何文件。
- 当前会话可以正常响应。
- 没有出现模型不可用错误。
- 没有出现认证错误。
- 没有出现 Base URL 连接错误。
- 可以先进入只读项目分析。
- 更准确地说，它是 API Key、Base URL、模型名、额度、权限、网络还是 config.toml 语法问题。
- 明确验证的是哪个入口。
- 完成一次只读模型验证。
- 知道正常结果和失败结果怎么判断。
- 出错时能把错误归类，而不是乱改配置。
- 只有验证通过后才进入项目实战。
2. 不要输出任何 API Key、Token 或密钥内容。
3. 如果你能看到当前模型或 provider 信息，请用中文说明。
4. 如果无法直接看到，请说明你会从哪些现象判断模型配置是否正常。
5. 请给出“可以进入项目实战 / 暂时不要进入项目实战”的判断。
`
这段话不要求 Codex 泄露内部密钥，也不要求它输出敏感配置。
你只是让它帮你判断当前会话是否能正常工作。
正常情况下，Codex 应该能给出类似判断：
如果它说无法直接确认模型名，也不一定是失败。
有些入口 or 版本不会把完整模型/provider 信息暴露给你。你要关注的是：当前任务是否能稳定完成，是否出现明确错误。
如果失败，先分类，不要乱改。
| 现象 | 更可能的问题 |
| ------------------- | ---------------------------------------------- |
| Unauthorized / 401 | API Key 错、密钥没读到、账号无权限 |
| 403 | 服务商权限、模型未开通、账号策略限制 |
| 404 model not found | 模型名错、模型下线、区域不支持 |
| connection refused | Base URL 错、本地代理或网络问题 |
| timeout | 网络慢、服务商不稳定、代理问题 |
| insufficient quota | 额度不足、余额不足、套餐限制 |
| provider not found | model\_provider 和 \[model\_providers.xxx\] 对不上 |
| TOML parse error | config.toml 语法写错 |
如果你看到错误，先复制错误关键字，不要复制 API Key。
然后看：国内模型配置排障总表。
第 5 步：让 Codex 自己解释错误
Section titled “第 5 步：让 Codex 自己解释错误”
如果 Codex 返回了错误，把错误中的敏感信息打码后，继续问：
`
这是当前模型配置验证时出现的错误，我已经隐藏了密钥：
【把错误粘贴到这里】
请帮我判断：
2. 请按最可能到最不可能排序。
3. 每一步只告诉我应该检查哪里，不要直接让我大范围重写配置。
4. 不要要求我公开 API Key。
``
这才是使用 Codex 的正确方式：让它帮你分析，不是让你凭感觉改配置。
只有当验证通过后，才进入后续教程：
如果模型验证没通过，不要继续。
否则后面任何失败都可能被误判为项目问题。
完成后，你应该做到：
下一篇看：第一次让 Codex 阅读项目。