Codex 报错排查 · 401 认证失败

Codex 返回 401：先别改模型，认证链路才是第一现场

401 通常说明域名、HTTPS 和接口路由已经可达，请求停在认证阶段。它不能证明模型可用，但能帮助你把排查范围缩小到 API Key、环境变量和令牌状态。

直接开始排查查看实时模型

更新：2026-07-23 · 先用短请求验证，再迁移正式任务。

先把三个关键变量分开

同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。

先确认 Key 来源

Codex 使用 LinkAGI 控制台创建的 API Key，不使用 ChatGPT 登录令牌。

再确认变量名

config.toml 的 env_key 必须与终端中实际导出的环境变量名称一致。

最后查令牌状态

确认 Key 未禁用、未过期、有可用额度且分组允许目标模型。

三步完成最小验证

保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。

检查环境变量

在当前启动 Codex 的终端确认变量已设置；修改后要重新启动 Codex。

核对 config.toml

确认 provider 名称、env_key、base_url 与 wire_api 四项一致。

创建测试 Key

若仍无法定位，为 Codex 单独创建一个低额度测试 Key，排除旧令牌状态问题。

Codex 自定义提供方最小配置

model_provider = "linkagi"
model = "从控制台复制当前模型名"

[model_providers.linkagi]
name = "LinkAGI"
base_url = "https://api.linktoagi.com/v1"
wire_api = "responses"
env_key = "LINKAGI_API_KEY"

# 在启动 Codex 的同一终端执行
export LINKAGI_API_KEY="sk-替换成你的Key"

API Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。