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