Codex 401 报错
Codex 报错 401 Invalid API key 怎么解决
按凭证来源、环境变量、登录状态和模型权限逐项排查 401 错误。
TL;DR：401 先查凭证来源，不要重复重试
401 Invalid API key 表示当前请求携带的身份凭证没有被服务接受。先确认你使用的是登录流程还是 API Key 流程，再检查环境变量、密钥状态和目标服务，不要把密钥贴进聊天记录或提交到仓库。
排查顺序
- 记录完整错误文本和触发命令。
- 确认当前终端读取的变量是否来自预期 shell。
- 检查密钥是否多了引号、空格或换行。
- 确认请求目标和账号权限匹配。
- 重新登录或更新凭证后只重试一次。
env | grep -E 'OPENAI|CODEX' | sed 's/=.*$/=<已隐藏>/'
codex --help
常见报错与解决
| 检查项 | 错误表现 | 处理方式 | | --- | --- | --- | | 环境变量 | 变量为空或读取旧值 | 新开终端并检查来源 | | 密钥格式 | 复制时带入空格 | 重新生成并安全保存 | | 登录方式 | CLI 登录和 API 请求混用 | 明确当前使用的认证路径 | | 权限范围 | 账号无目标资源权限 | 回到官方帮助中心核对账号能力 |
FAQ：401 错误的安全处理
可以把 API Key 发给 Codex 排查吗？
不可以。只提供变量名、错误类型和已脱敏的命令输出。
修改环境变量后为什么还报错？
当前终端可能仍保留旧环境。关闭并重新打开终端，再验证实际生效的配置来源。
401 和 429 有什么区别？
401 是身份凭证或权限问题，429 通常是频率、额度或并发限制问题，排查方向不同。