Ubuntu 中 Codex CLI 登录失败使用 OpenAI API Key 解决最近我在 Ubuntu 虚拟机中配置 OpenAI Codex CLI希望后续可以直接在 Isaac Lab 项目中使用 Codex 修改和调试代码。1. 安装 Codex CLI首先安装 Node.js。Codex CLI 需要较新的 Node.js 版本因此建议直接安装 Node 20curl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-sudoaptinstall-ynodejs检查 Node.js 和 npm 版本node--versionnpm--version我的版本为v20.20.210.8.2随后使用 npm 安装 Codex CLI。由于网络环境原因我使用了 npmmirrorsudonpminstall-gopenai/codex--registryhttps://registry.npmmirror.com安装完成后检查版本codex--version如果输出类似下面内容说明安装成功codex-cli0.137.0如果出现codex命令入口异常可以查找实际安装位置npmroot-gsudofind/usr /usr/local-path*openai/codex*-o-namecodex.js2/dev/null我的实际路径为/usr/lib/node_modules/openai/codex/bin/codex.js因此可以手动建立软链接sudochmodx /usr/lib/node_modules/openai/codex/bin/codex.jssudoln-sf/usr/lib/node_modules/openai/codex/bin/codex.js /usr/local/bin/codexhash-r再次检查codex--version成功输出codex-cli0.137.0如果系统中存在旧版 Node.js 导致安装冲突可以先清理旧包再重新安装 Node 20sudoaptremove-ynodejsnpmlibnode-devsudoaptautoremove-ysudoapt--fix-brokeninstall-ycurl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-sudoaptinstall-ynodejs2. 登录时遇到地区限制Codex CLI 安装完成后版本检查正常codex--version输出codex-cli0.137.0但是第一次登录时遇到了问题。浏览器弹出的 Codex login 页面提示错误信息为Sign-in could not be completed Token exchange failed: token endpoint returned status 403 Forbidden: Country, region, or territory not supported Error code: token_exchange_failed也就是说网页登录认证阶段的 token exchange 被拒绝原因是当前网络出口所在的国家或地区不被支持。一开始我尝试通过 VPN 和代理解决但终端和浏览器的网络出口并不总是一致所以网页登录仍然失败。后来发现 Codex CLI 支持直接使用 API Key 登录。3. 使用 API Key 登录查看登录帮助codex login--help可以看到有一个参数--with-api-key说明可以从标准输入读取 API Key--with-api-key Read the API key from stdin于是我从 OpenAI 平台获取了自己的 API Key然后在 Ubuntu 终端中执行exportOPENAI_API_KEY你的_API_KEYprintenvOPENAI_API_KEY|codex login --with-api-key注意不要把 API Key 写进博客、截图或公开仓库。登录完成后检查状态codex login status之后进入项目目录启动 Codexcd~/test20260604/isaac_semicircle_linkage codex成功进入 Codex CLI 界面OpenAI Codex (v0.137.0) model: gpt-5.5 directory: ~/test20260604/isaac_semicircle_linkage4. 总结这次遇到的问题不是 Codex CLI 没装好而是网页登录认证时的地区限制403 Forbidden: Country, region, or territory not supported最终解决办法是使用 API Key 登录exportOPENAI_API_KEY你的_API_KEYprintenvOPENAI_API_KEY|codex login --with-api-key之后就可以在 Ubuntu 项目目录中正常使用 Codex CLI 了。