Codex 配置：原理与线路
为什么 Codex 需要配置、背后原理（config.toml + auth.json）、base_url 线路选择与验证。
这一页回答两个问题：为什么 Codex 需要配置？ 以及 配置背后发生了什么？
为什么需要配置
Codex 默认连接 OpenAI 官方服务。使用 GetToken 时，需要告诉 Codex 三件事：
- 连到哪里：
base_url（GetToken 的 API 服务地址）。 - 你是谁：API Key（GetToken 控制台创建的个人凭证）。
- 用什么模型：例如
gpt-5.6-sol。
背后原理（大白话）
Codex 读取本机两个文件：
~/.codex/config.toml：告诉 Codex 服务地址（base_url）、模型等。~/.codex/auth.json：告诉 Codex 用哪个 Key 认证（OPENAI_API_KEY）。
Codex App 与 Codex CLI 使用同一套本机配置目录，所以配好一次，App 和 CLI 通常都能用。
base_url 与线路选择
| 线路 | 地址 | 用途 |
|---|---|---|
| 中国地区优化线路（推荐） | https://api.clawto.link | 面向中国地区访问优化，新手默认选择 |
| 标准线路 | https://api.gettoken.dev | 通用 / 海外访问 |
不要填写：
https://gettoken.dev
https://gettoken.dev/console这些是网站和控制台地址，不是 API 服务地址。
两种配置方式
- 自动脚本（推荐新手）：见「快速开始」，一条命令写入全部配置。
- 手动编辑：见「Codex CLI 配置」与「Codex App 配置」。
验证
codex "请输出一句话说明当前配置已生效"如果请求失败，按顺序检查：API Key 是否完整、base_url 是否 https://api.clawto.link、auth.json 是否是合法 JSON、config.toml 是否在 ~/.codex/config.toml、当前账号是否还有可用额度、网络是否能访问 API 线路。