Codex CLI 登录教程：ChatGPT 登录与 API Key 选择

TL;DR：Codex CLI 登录先确定认证路径

Codex CLI 的登录问题，先分成两条路径：用浏览器完成 ChatGPT 登录，或者在终端使用 OPENAI_API_KEY。不要在同一次排错中反复切换两种方式；先记录当前路径，再检查命令、环境变量和账号权限。

第一步：确认 Codex CLI 已经安装

codex --version
codex --help

如果终端提示找不到 codex，先回到 Mac 安装教程 或 Windows 安装教程，检查 Node.js、npm 全局目录和当前终端的 PATH。

第二步：选择 ChatGPT 登录流程

适合希望用浏览器完成授权、又不想把 API Key 粘贴到终端的人，可以从项目目录启动 Codex：

cd /path/to/your/project
codex --login

按照终端提示打开浏览器并完成授权。不同版本的登录提示和可用账号范围可能发生变化，涉及账号资格、授权状态和使用额度时，应以 OpenAI Codex CLI 官方说明 为准。

完成授权后，回到终端运行一个只读任务，验证登录是否真正可用：

codex "只读取当前项目的 README 和 package.json，说明启动命令，不要修改文件"

第三步：选择 API Key 环境变量

需要在脚本、无头环境或明确使用 API 请求时，再考虑 API Key。只在当前终端会话临时设置，示例中的值必须替换成自己的密钥：

export OPENAI_API_KEY="your_api_key_here"
codex "检查当前项目的测试命令，只输出建议，不要修改文件"

检查变量时只显示变量名和是否存在，不要把完整密钥打印到日志：

if [ -n "$OPENAI_API_KEY" ]; then
  echo "OPENAI_API_KEY 已设置"
else
  echo "OPENAI_API_KEY 未设置"
fi

不要把密钥写入 AGENTS.md、Git 仓库、截图、工单或聊天记录。若密钥已经暴露，应尽快在对应控制台撤销并重新生成。

登录方式怎么选

| 使用场景 | 建议路径 | 重点检查 | | --- | --- | --- | | 本地交互式开发 | ChatGPT 登录 | 浏览器授权是否完成、终端是否回到原项目 | | 自动化脚本或无头环境 | API Key | 环境变量来源、密钥权限和日志脱敏 | | 团队共享项目 | 统一凭证规范 | 不共享个人密钥，使用组织批准的凭证管理方式 | | 登录后仍报 401 | 先停止重试 | 查看 401 排查页，确认凭证路径没有混用 |

常见报错与解决

| 现象 | 常见原因 | 处理方式 | | --- | --- | --- | | codex --login 没有继续 | 浏览器授权未完成或回调被阻断 | 保持终端窗口打开，重新执行一次并观察完整提示 | | 登录后仍提示未认证 | 当前目录或终端读取了另一套配置 | 新开终端，在项目目录重新运行 codex --help 和只读任务 | | 401 Invalid API key | 环境变量为空、密钥失效或认证方式混用 | 参考 Codex 401 报错解决 | | 任务卡住或超时 | 网络、代理或服务端响应异常 | 先查看 网络连接排查，不要连续重复请求 |

FAQ：Codex CLI 登录常见问题

Codex CLI 一定要 API Key 才能登录吗？

不一定。官方文档同时说明了交互式登录和 API Key 环境变量路径，具体可用选项以当前 CLI 提示和官方帮助页为准。

可以把 API Key 直接写进项目配置吗？

不建议。使用环境变量或凭证管理工具，并把密钥文件加入忽略规则；不要提交到 Git。

登录成功后第一条命令应该运行什么？

建议运行只读任务，例如让 Codex 总结项目入口、测试命令和目录结构，确认上下文读取正常后再允许修改。

修改了环境变量为什么还报旧账号？

当前终端可能保留旧变量或旧登录状态。关闭终端、重新打开，再用脱敏方式确认配置来源；如果仍不确定，按认证路径重新登录一次。

完成登录后，继续阅读 Codex 第一次任务教程、AGENTS.md 写法 和 Codex 官方工作流。