装好 Codex，第一件事就是登录，而登录口摆着两条道：一条用 ChatGPT 账号授权，额度装在订阅里；另一条填 API key，按量计费。AI 编程工具的这两条认证路径决定了你后面能用什么功能、额度怎么扣、账单从哪出，选错道的人常常用到一半才发现功能缺一块，或者 API 账单莫名在涨。这篇讲清两条道各是什么、codex login 的流程怎么走、两条道差在哪，以及凭据文件为什么要当密码看。
两条道各是什么
第一条道是 ChatGPT 订阅登录：用 ChatGPT 账号完成授权，Codex 的用量计入订阅内含的额度池，Free、Plus、Pro 这些档位各带一份额度，档位的梯度结构见计费轨道一篇的展开。第二条道是 API key：在平台后台生成一把密钥交给 Codex，请求按实际消耗计量，从 API 账户里扣，API 的基础概念见什么是 AI API一篇。两条道进门方式不同，背后的计费账户也不同，这正是大量「额度怎么算」「账单对不上」困惑的源头。
| 对比项 | ChatGPT 订阅登录 | API key |
|---|---|---|
| 额度从哪出 | 订阅内含的额度池，Free、Plus、Pro 各带一份 | 按实际消耗计量，从 API 账户里扣 |
| 云端任务 | 内含，任务丢到云端、多端看进度 | 不在 API 轨道上，没有这一块 |
| 新模型到手时机 | 新模型上线时通常先用到 | 可用时机可能晚一步 |
| 什么情况下选它 | 日常个人开发，想用订阅里那份额度 | 脚本与自动化里跑，或团队统一管 API 预算 |
codex login 的流程怎么走
命令行里执行 codex login，CLI 会拉起默认浏览器跳到授权页面，你在页面上登录账号并确认授权，浏览器把结果回传给本地监听的回调，CLI 收到凭据后落盘保存，登录完成。全程不需要手动复制 token，授权一次长期有效，失效了重走一遍即可。如果公司网络把回调拦了、浏览器没弹出来，登录会卡在最后一步，Windows 环境下的逐项排查见Windows 登录一篇。想锁定登录方式，配置里还有强制开关，配合环境变量一起管，坑见下一节。
两条道差在哪：功能面与更新时机
两条道付账方式不同，能力面也有差别。订阅道带着完整的云功能：把任务丢到云端执行、多端查看进度，这些都内含在订阅里；模型更新也优先，新模型上线时订阅用户通常先用到。API key 道少一块：云端任务这类功能不在 API 轨道上，模型可用时机也可能晚一步。选道的判断因此很直接：日常个人开发、想用订阅里那份额度，走 ChatGPT 登录；要在脚本与自动化里跑、或由团队统一管理 API 预算，才走 API key。两条道随时可以切换，但切换前务必把环境变量清干净——变量里残留的 key 会悄悄改变道，账单跟着变，这个坑见静默切 API 计费一篇。
auth.json：当密码看的凭据文件
登录成功后，凭据落在本地 auth.json 文件里，这个文件要当密码看：里面存着能代表你身份的令牌，拿到它就等于拿到账号的使用权。三条纪律：一不进代码仓库，把相关目录写进 .gitignore，避免凭据随代码一起提交；二不贴进聊天与截图，求助时把敏感字段打码；三不外借，出了用量异常，追责追到的是你的账户。凭据失效的典型表现是请求被拒，处理办法见401 处理一篇的排查顺序。想建立整体认知，可以让 DeepSeek 把两条道的差异整理成一张对照表，再用豆包解释令牌与密钥在本地的存放位置，选道之前先把账算明白。
登录两条道速查
- 两条道：ChatGPT 订阅登录（额度内含）与 API key（按量计费）
- codex login：浏览器授权、回调落盘，失效重走一遍
- 云功能与模型更新优先级归订阅道，API 道没有云端任务
- auth.json 是凭据：不进仓库、不贴截图、不外借
- 切换道之前先清环境变量，防止静默改道
登录两条道快问快答
- 两条道能同时挂着用吗？：技术上可以，但容易出乱子：环境变量里的 API key 与订阅登录并存时，CLI 会按优先级挑一条走，你以为是订阅额度，账单却记在 API 头上，处理办法见静默切 API 计费一篇。
- 换登录方式要重装吗？：不用。codex logout 退出当前凭据，再按目标道重新登录即可，项目文件与配置都不受影响。
- 登录状态会过期吗？：会。令牌有有效期，账号改密码或撤销会话也会让本地凭据作废，表现为请求被拒，重新登录即可恢复。
