先定位配置目录
Windows 通常在 C:\Users\你的用户名\.codex，macOS 和 Linux 通常在 ~/.codex。目录中应包含 config.toml 和 auth.json 两个文件。
Codex 401 Fix
Codex 报 401 时，先检查 UUcode auth.json 格式
UUcode 疑难排查文档指出，Codex auth 错误通常与 auth.json 格式错误或 API Key 填写有误有关。统一网关配置让排查路径更清晰。
- auth.json 校验
- config.toml 路径
- 401 修复
检查 JSON 与 Key
auth.json 需要保持正确 JSON 结构，例如 uucode 对象下包含 api_key。多余逗号、错误引号或复制不完整的 Key 都可能造成 401。
同时核对网关地址
config.toml 中的 base_url 可用于 Anthropic 兼容接入，base_url_api 可用于 OpenAI 兼容接入。UUcode 文档示例使用 https://token.uucode.top 和 /v1。
01
打开 .codex 目录
确认 config.toml 与 auth.json 均存在，且当前用户拥有读取权限。
02
校验 auth.json
检查 JSON 是否闭合，api_key 是否完整复制，Key 是否仍在 UUcode 控制台有效。
03
重启 Codex 测试
保存后重新运行 codex，并在 UUcode 控制台查看是否出现新的请求记录。
常见问题
401 一定是 UUcode 网关问题吗？
不一定。多数情况下是 Key 无效、Key 复制不完整、auth.json 格式错误或模型分组不匹配。
可以重新跑自动配置吗？
可以执行 npx token-uucode，根据提示重新写入 Codex 所需配置。