CLI 登录(可选)
在 Codex CLI 和 IDE 扩展里用 ChatGPT 账号登录,查看登录状态、退出登录,以及 ChatGPT 登录和 API Key 登录的区别。
Codex 支持两种登录方式:
- Sign in with ChatGPT:用 ChatGPT 订阅里包含的额度。推荐,也是本教程默认的方式。
- API Key:按 API 用量单独计费,适合 CI 等自动化场景。
Codex Cloud 只支持 ChatGPT 登录。用 API Key 登录时,用的是 API 计费,不消耗订阅额度,也用不了云端功能。
登录 CLI
在浏览器里完成登录
Codex 会自动打开浏览器。用你的 ChatGPT 账号登录;如果账号属于多个工作区,选对工作区。登录完成后,浏览器会把凭据交回给 CLI。
浏览器没反应或回调失败?
登录时,Codex 会在本机 localhost:1455 起一个回调服务。如果你是在远程服务器、SSH 会话里,或者本机网络环境挡住了这个回调,请改用设备码登录。
登录 IDE 扩展
在 VS Code、Cursor 或 Windsurf 里打开 Codex 侧边栏。未登录时点 Sign in with ChatGPT,按浏览器提示完成即可。
CLI 和 IDE 扩展共用同一份登录缓存,在其中一个登录后,另一个一般不用再登;在其中一个退出,另一个下次启动时也要重新登录。
退出登录
codex logout或在交互界面里输入 /logout。这会同时清除 ChatGPT 登录和 API Key 登录的凭据。
登录会保持多久
ChatGPT 登录的会话在使用过程中会自动刷新令牌,正常使用时一般不需要反复登录。凭据缓存在 ~/.codex/auth.json 或系统凭据存储里。修改存储方式见拿到账号后的第一步。
用 API Key 登录(可选)
只在需要按 API 计费,或者在 CI 里跑自动化时才用。API Key 通过标准输入传给 CLI:
printenv OPENAI_API_KEY | codex login --with-api-key切换到 API Key 后,用量按 API 价格单独计费,不再使用订阅额度。想改回来,先 codex logout,再重新 codex login。
企业网络与自定义证书
如果公司网络使用 TLS 代理或私有根证书,登录前用 CODEX_CA_CERTIFICATE 指向 PEM 证书包(未设置时会退回读取 SSL_CERT_FILE):
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login