Codex 登录教程:ChatGPT 账号 or API Key?
2026-08-22 14:12:51阅读 3
装好 Codex 后第一道坎就是登录。界面会给你两个选择:Sign in with ChatGPT 和 API key。新手常在这卡住——选哪个?都登录了有什么区别?这一篇讲明白两条路的真实差别,以及登录失败时怎么救。
两种登录方式:一张表看懂
| Sign in with ChatGPT | API key | |
|---|---|---|
| 是什么 | 用 ChatGPT 账号授权 | 用 OpenAI 平台生成的密钥 |
| 计费 | 走套餐额度(Free/Plus/Pro 等) | 按 token 实打实扣钱 |
| 功能完整度 | 完整(含云端集成、代码审查等) | 部分功能可能不可用(官方原文) |
| 适合 | 大多数用户、日常使用 | 开发者、程序化/CI 场景 |
| 麻烦程度 | 网页授权,一次搞定 | 要去平台申请,还要管密钥 |
官方原文原话:"也可以通过 API key 使用 Codex,但部分功能可能不可用。"——这句话翻译过来就是:能用,但别指望体验完整。
默认推荐:Sign in with ChatGPT
日常使用选这个,三个理由:
- 免费档也能登录——没有 API 订阅也能体验(见免费使用攻略)
- 额度是套餐制的——不用担心"跑着跑着欠费"
- 功能全——云端集成、自动代码审查、Slack 联动这些都要 ChatGPT 账号才完整
登录方式(官方 README 原文):运行 codex,选择 Sign in with ChatGPT,浏览器弹出授权,确认即可。
什么时候才用 API key
只有这些场景值得:
- 你要写代码集成 Codex(SDK/脚本调用)
- 你在 CI 环境里跑 Codex,没法走网页授权
- 你已经有 OpenAI API 订阅,想按量付费
如果只是"在终端里用 Codex 干活"——别用 API key,那是给自己添麻烦。
登录失败怎么办:最常见的坑
坑一:access token 报错
症状:提示 token 无法刷新/过期。
处理:退出登录重新授权一次,多数能好;反复出现就检查网络(部分网络环境对 OpenAI 授权域名不友好)。
坑二:浏览器授权卡住
症状:点了登录没反应。
处理:确认默认浏览器可用;授权是一次性的,重开 codex 再试。
坑三:API key 无效
症状:401 错误。
处理:去平台确认 key 没被删/没过期;注意 key 是 sk- 开头的新格式还是旧格式。
更多报错排查见 7.1 常见报错排查。
登录后的三个检查
codex进入交互界面 → 登录成功- 输入
你好,介绍一下自己→ 模型正常回复 /status看当前会话配置 → 模型、权限正常
常见问题
| 问题 | 解答 |
|---|---|
| 换了套餐需要重新登录吗? | 不用,账号授权不变,额度跟着账号走 |
| 可以两个都登录吗? | 可以切换,但同一会话内用一种计费方式 |
| 公司电脑登录有风险吗? | 用公司账号或确认 IT 策略;个人账号注意授权范围 |
| 忘记登出? | 命令行登出即可,具体见官方文档 |
一句话总结
先 Sign in with ChatGPT,别急着上 API key。 等你真要写代码集成 Codex 了,再回头申请 key——那时候你就知道自己在干什么了。
接下来读什么
- 登录后额度够不够用 → 免费使用攻略
- 想升级套餐 → 价格详解:Plus/Pro/Team 套餐额度对比
← 上一篇:2.1 免费使用攻略 | 下一篇:2.3 价格详解 →
↑ 返回 教程总目录



