Codex 登录与凭据：ChatGPT、API Key 和 auth.json 的区别

先选登录方式，再改配置

ChatGPT 登录和 API Key 登录是不同的接入方式。前者使用相应账号权益，后者按 API 账户的规则计费；不要假定订阅与 API 额度相通。第三方供应商则还要配置模型路由。先决定你希望使用哪种方式，再检查当前状态，避免把不同来源的 Key 混在一起。

codex login status

官方 API Key：环境变量与登录是两步

以下命令适用于已经通过本机安全方式设置了 OPENAI_API_KEY 的情况。把变量传入标准输入完成登录，不要把真实 Key 写进截图、文章或命令参数。

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

PowerShell 对应使用 $env:OPENAI_API_KEY | codex login --with-api-key。只做 export 是给进程提供变量，不等于已经完成内置 OpenAI 路由的登录缓存。自定义供应商的 env_key 则是另一套连接方式，见 自己的 API 接入教程。

auth.json 不存在，不一定是登录失败

cli_auth_credentials_store = "auto"

修改存储模式后应重新检查登录状态，不能假定旧位置里的凭据已经自动迁移。若机器受组织管理，本地认证要求可能约束可选模式。

客户端能用，CLI 却显示未登录

1. 分别检查本地与远程环境，不把远程主机当成本机。
2. 核对双方的 CODEX_HOME，以及客户端是否在配置修改前已经启动。
3. 确认双方是否使用不同的凭据存储；先看状态，不要打印 auth.json 内容。
4. 若需要重新登录，在准备好对应登录方式后操作；共享缓存的客户端可能一起受影响。

怎么验证切换成功

登录状态能确认认证方式，却不能单独证明请求发到了正确供应商。重新启动后运行一个小任务，同时核对模型、目标端点和上游请求日志。不要以“Key 能保存”或“模型名出现了”作为完整验收。

如果出现 401、403 或客户端与 CLI 不一致，继续用 分层排错清单 定位。