Codex CLI invalid_api_key 怎么解决？

为什么 Codex CLI 会报 invalid_api_key

Codex CLI 的请求流程是：发送请求 → 服务端验证 API Key → 返回响应或错误。

invalid_api_key 是服务端的认证响应，HTTP 状态码通常为 401。它意味着 Key 在服务端看来是无效的，可能是以下情况之一：

• API Key 本身填写错误或复制时带有多余空格
• API Key 已被删除、撤销或过期
• API Key 和 Base URL 不属于同一平台（用 A 平台的 Key 请求 B 平台的 API）
• Base URL 没有带 /v1 后缀，请求路径不对
• 该 Key 没有请求的模型权限

先检查 Base URL 和 API Key 是否匹配

如果 API Key 是从 LinkAI 控制台创建的，Base URL 也应该使用 LinkAI 的 API 端点。

如果你不确定 API Key 和 Base URL 的填写逻辑，参考 OpenAI API Key 和 Base URL 是什么？新手配置指南。

不要拿 A 平台的 Key 去请求 B 平台的 Base URL，也不要把前端页面地址当成 API 地址。

正确的 Base URL 格式：

• 普通请求：https://api1.link-ai.cc/v1
• 长任务（推荐）：https://api2.link-ai.cc/v1

Codex CLI invalid_api_key 排查清单

按顺序检查以下 10 项：

1. Key 是否完整复制 — 检查开头是 sk- 还是其他前缀，末尾有没有多余空格
2. Authorization 是否是 Bearer — Codex CLI 通常自动处理，如手动配置确认格式为 Authorization: Bearer YOUR_KEY
3. Base URL 是否带 /v1 — 必须是 https://api2.link-ai.cc/v1 而不是 https://api2.link-ai.cc
4. Base URL 是否为 API 域名 — 不能填控制台（#/console/token）、注册页（#/register）或根域名
5. Key 是否属于当前平台 — LinkAI 的 Key 必须配 LinkAI 的 Base URL
6. Token 是否被删除或过期 — 在控制台检查 Key 状态
7. 模型名是否可用 — 确认该模型已在控制台开通
8. 账户余额是否足够 — 余额不足可能导致请求失败
9. 是否走错 provider — 确认 config.toml 中 provider 的 base_url 字段配置正确
10. 是否可以用 curl 请求 /v1/models — 用 curl 测试可快速定位问题在 Key 还是在配置

用 curl 快速判断 Key 是否有效

在排查 Codex CLI 配置之前，可以先用 curl 验证 Key 和 Base URL 是否正确：

curl https://api1.link-ai.cc/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

正常返回示例（Key 有效）：

{
  "object": "list",
  "data": [
    { "id": "claude-3-5-sonnet-20241022", "object": "model", ... },
    { "id": "gpt-4o", "object": "model", ... }
  ]
}

异常返回（Key 无效，返回 401）：

{
  "error": {
    "message": "invalid_api_key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

常见错误码对照表

FAQ