Appearance
Codex 的 config.toml 和 auth.json 怎么配
最重要的原则只有两个:把 ChinaModels 后台提供的配置内容粘贴到正确文件里,并放在文件顶部;完成后用一次简单对话验证连接是否成功。
这两个文件分别做什么
| 文件 | 作用 | 常见错误 |
|---|---|---|
config.toml | 定义模型接入和运行配置 | 粘贴到错误位置、缺少空行、覆盖原有效配置 |
auth.json | 保存认证相关信息 | 文件路径找错、内容不完整、格式被手动改坏 |
正确配置步骤
- 登录 ChinaModels 后台并创建 API Key。
- 在 API Key 列表里点击“使用密钥”。
- 按弹窗提示找到本地的
config.toml和auth.json。 - 把给出的内容粘贴到文件最上方。
- 与原内容之间保留一行空行。
- 保存后启动 Codex,输入
hi做连通性测试。
如何判断配置成功
配置成功后,Codex 至少应表现出这几个特征:
- 能正常返回模型回复
- 不会立刻报认证失败
- 不会提示找不到 provider 或 endpoint
- 进入论文工作区后可以继续执行后续步骤
最常见的 4 个错误
1. 粘贴到文件底部
这会导致解析顺序或结构异常。优先按后台提示放到文件顶部。
2. 手动修改了 JSON 或 TOML 结构
如果你不熟悉格式,不要自己重排字段。先原样粘贴,再测试。
3. 选错了 API Key 的订阅分组
后台创建密钥时要选择与已购买订阅一致的分组,否则可能出现“创建成功但调用失败”。
4. 只配了一个文件
如果提示里要求同时改 config.toml 和 auth.json,就不要只改其中一个。
FAQ
config.toml 在哪里
不同系统位置可能不同。最稳妥的办法是直接按后台“使用密钥”弹窗里的指引定位,而不是凭记忆猜路径。
auth.json 需要完全覆盖吗
优先遵循弹窗说明。如果提示是插入或追加,就不要盲目整文件覆盖。
配完以后第一句该发什么
发一个最简单的 hi 就够了。第一步目标只是验证模型链路通不通,不是立刻开始复杂任务。
推荐下一步
- 如果还没安装客户端,先看 安装 Codex App
- 如果连接失败,直接看 Codex 安装或连接失败怎么办