AI Agent / 系统课时

登录认证与版本维护

登录认证与版本维护

Codex 本地入口支持使用 ChatGPT 账号或 API Key 认证,二者对应不同的计费与组织策略。本课完成 CLI 登录、版本检查和更新,并给出登录失败、旧版本和多安装来源冲突的基础诊断顺序。

学习目标

  • 选择并完成合适的认证方式
  • 检查和更新 Codex CLI 版本
  • 按顺序定位常见登录与版本问题

使用 ChatGPT 账号登录

ChatGPT 登录适合使用订阅或工作区权限。运行登录命令后会打开浏览器,完成认证并选择正确工作区,再返回终端。

bash
codex login

预期结果

text
浏览器认证完成后,Codex CLI 保存有效登录状态并返回终端。

桌面应用和 IDE 扩展也会通过浏览器完成类似流程。托管工作区用户还可能受到成员资格、角色、模型和产品权限限制;能登录账号不代表一定拥有所有 Codex 功能。

使用 API Key 登录

API Key 方式按 API 组织的用量和数据策略运行。先在安全的环境变量中保存密钥,再通过标准输入传给 CLI,避免把密钥出现在命令历史或聊天中。

bash
printenv OPENAI_API_KEY | codex login --with-api-key

预期结果

text
Codex CLI 接收环境变量中的密钥并建立 API Key 登录状态;密钥正文不会作为正常输出显示。

PowerShell 可使用 $env:OPENAI_API_KEY | codex login --with-api-key。不要把 API Key 写入仓库、配置样例、截图或问题描述;怀疑泄露时应立即撤销并重新创建。

检查与更新版本

先记录当前版本,再调用自更新命令。codex update 仅在当前发行版和安装方式支持自更新时生效;不支持时应重新运行官方安装脚本,或使用原包管理器升级。

bash
codex --version
codex update
codex --version

预期输出

text
codex-cli <OLD_VERSION>
<UPDATE_STATUS>
codex-cli <NEW_VERSION>

如果没有可用更新,前后版本可能相同。npm 安装可用 npm install -g @openai/codex@latest 更新,Homebrew 安装则应继续使用 Homebrew,避免混合安装来源。

按顺序进行基础诊断

登录失败时先确认系统时间、浏览器会话、网络代理和工作区权限,再重新执行 codex login。API Key 方式还要确认环境变量不为空、密钥属于正确组织且仍有效。

版本异常时先运行 codex --version,再检查终端实际命中的可执行文件。若不同终端显示不同版本,通常是 PATH 中存在多个安装目录,而不是更新命令本身失败。

能启动但任务请求失败时,记录错误信息、认证方式、安装来源和版本号,再进行后续排查。不要在日志中粘贴令牌、API Key 或包含敏感路径的完整配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

登录认证与版本维护

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通