Codex 配置后还提示登录怎么办？从 auth.json 到最小请求的完整排查教程
如果你按照教程配置完 Codex，却依然反复弹出“请登录”或提示 401 Unauthorized，别慌。这通常不是代码问题，而是配置文件、请求头或环境没有彻底刷新导致的。本文从 auth.json、config.toml、Base URL 到最小请求，一步步教你系统性排查，10 分钟内帮你定位并解决登录问题。
为什么配置完 Codex 还是提示登录？
Codex 在启动时会按以下顺序读取配置：
~/.codex/auth.json（存储 API Key）~/.codex/config.toml（模型、Base URL 等核心配置）- 环境变量和命令行参数
只要其中任何一个环节出问题，它就会回退到官方登录逻辑，从而出现反复提示登录的情况。
第一步：检查 auth.json 是否正确
这是最常见的问题点。
正确路径（三平台通用）：
– Windows: C:\Users\你的用户名\.codex\auth.json
– macOS / Linux: ~/.codex/auth.json
正确写法示例：
{
"api_key": "sk-XXXXXXXXXXXXXXXXXXXXXXXX"
}
常见错误及排查方法：
– Key 前后有空格或换行
– 复制了 Bearer sk-... 而不是纯 key
– 文件名写成了 auth.json.txt
– 文件编码不是 UTF-8
快速验证命令：
cat ~/.codex/auth.json
确认 key 正确后，继续下一步。
第二步：正确配置 config.toml（最容易忽略）
很多人在改完 auth.json 后忘记同步修改 config.toml，导致配置不生效。
推荐的最小可用配置：
base_url = "https://api.token173.com/v1"
model = "gpt-4o-mini"
auth
provider = "bearer"
api_key = "sk-XXXXXXXXXXXXXXXXXXXXXXXX"
重点注意：
– base_url 必须以 /v1 结尾
– 不要使用官方 https://api.openai.com/v1
– 如果使用国内中转服务，必须确认对方支持 /v1/chat/completions 路由
第三步：完全重启终端和 VSCode
这是很多人的“隐形坑”。
配置改完后，旧的 Codex 进程仍然运行在内存中，使用的是旧配置。必须完全重启：
- 关闭当前终端窗口
- 彻底关闭 VSCode（包括所有实例）
- 重新打开终端
- 执行
codex --version验证
第四步：用最小请求验证是否真正打通
这是最关键的一步——最小化测试请求。
在终端直接运行以下命令：
codex --model gpt-4o-mini "输出一个 hello world 函数"
或者使用 curl 做最纯粹的测试（推荐）：
curl -X POST https://api.token173.com/v1/chat/completions \
-H "Authorization: Bearer sk-XXXXXXXXXXXXXXXXXXXXXXXX" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": {"role": "user", "content": "Say hello"},
"max_tokens": 50
}'
如果 curl 能正常返回，说明 API 本身是通的，问题出在 Codex 的配置加载逻辑上。
常见问题快速排查表
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 始终提示登录 | auth.json 未加载 | 检查文件路径和内容，重新启动终端 |
| 401 Unauthorized | Key 错误或 Base URL 错误 | 验证 Key 完整性，确认 Base URL 以 /v1 结尾 |
| 配置修改后不生效 | 终端进程未重启 | 彻底关闭终端和 VSCode 后重试 |
| 能用但一直提示登录 | config.toml 中 auth 配置缺失 | 补充 auth 区块 |
| 切换模型后仍报错 | 旧会话未刷新 | 新建一个终端会话或新对话 |
什么时候该考虑更换接入方式？
如果你只是想快速跑通原型，建议优先使用稳定且文档清晰的中转服务。先把最小请求打通，再决定是否长期使用。
目前很多开发者在初期测试阶段会选择 AI驿站（https://apivibe.cn/register?aff=E7yk），它的控制台能清晰展示可用的 Base URL 和模型列表，避免一开始就被复杂的配置信息搞晕。
总结：最小接入链路四步法
- 写对 auth.json（纯 Key，无多余字符）
- 配好 config.toml（正确的 base_url + /v1）
- 彻底重启终端和编辑器
- 用 curl 或 codex 最小命令验证
把这四件事跑通后，90% 的“配置后还提示登录”问题都能解决。
现在行动：
如果你当前正卡在 Codex 反复要求登录，可以直接按照上面的顺序从 auth.json 开始排查。排查完后，建议去 AI驿站（https://apivibe.cn/register?aff=E7yk）看一眼最新的可用入口和控制台信息，先用小额度跑通一条链路，再决定是否纳入正式开发流程。
先跑通，再优化，这是使用 Codex 最稳的路径。