开通 ChatGPT Plus 或 Pro 后，想让 AI 直接帮你阅读项目、修改代码、排查报错，下一步就是登录 Codex。
Plus 和 Pro 包含相应的 Codex 使用权益。使用订阅权益时，应选择“Sign in with ChatGPT”，并登录已经开通会员的同一个账号。 具体可用模型和使用额度，以账号当前显示的信息为准。
这篇教程分别介绍终端 CLI、IDE 插件和桌面端的操作方法。
本文依据 2026 年 10 月 2 日的官方文档整理，界面名称可能随版本调整。
一、先选适合自己的入口
三种入口可以按工作习惯选择：
入口适合谁使用方式
Codex CLI
经常使用终端的开发者
在项目目录运行 Codex
Codex IDE 插件
使用 VS Code、Cursor、Windsurf 的用户
在编辑器侧栏与 Codex 协作
桌面端
喜欢图形界面、需要管理多个任务的用户
登录桌面应用，选择项目或文件夹
CLI 可以在本地项目中检查文件、修改代码和运行命令；IDE 插件方便结合打开的文件和选中代码工作；桌面端提供项目和任务管理界面。
如果第一次接触 Codex，可以先选自己最熟悉的入口，完成一个小任务后再尝试其他方式。
二、先分清 ChatGPT 登录和 API Key 登录
Codex 支持两种主要认证方式：
- Sign in with ChatGPT：使用 ChatGPT 订阅权益。
- 使用 API Key：通过 OpenAI Platform 按 API 用量计费。
因此，已经开通 Plus 或 Pro、希望使用套餐权益的用户，应选择第一种。API Key 方式会按 API 规则计费，不会自动使用你的 Plus 或 Pro 订阅额度。
三、Codex CLI 安装和登录教程
第一步：安装 CLI
如果电脑已经安装 Node.js 和 npm，可以在终端执行：
npm install -g @openai/codex
macOS 和 Linux 用户也可以使用官方独立安装脚本：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
选择一种安装方式即可。安装选项和更新说明，可以查看 Codex CLI 官方文档。
第二步：登录 ChatGPT 账号
执行：
codex login
按提示在浏览器中完成登录，确认使用的是已经开通 Plus 或 Pro 的账号，再返回终端。
可以通过下面的命令检查认证状态：
codex login status
如果需要切换账号，可以先退出，再重新登录：
codex logout codex login
以上是官方提供的登录与状态检查命令。
第三步：在项目目录启动
进入你的项目文件夹，例如：
cd my-project codex
将 my-project 换成自己的实际项目路径。
第一次使用，建议先让 Codex 解释项目，不急着改代码：
请用中文介绍这个项目的目录结构、技术栈和启动方式，暂时不要修改文件。
确认它理解了项目后，再提出具体任务：
请检查登录接口为什么返回 500，先说明原因和修改方案。
官方建议在任务前后创建 Git 检查点，方便查看和撤回修改。
四、IDE 插件安装和登录教程
如果你平时主要在编辑器里开发，可以使用 Codex IDE 插件。
第一步：安装官方扩展
打开 Codex IDE 官方页面，从页面提供的安装入口进入扩展商店。
VS Code、Cursor 和 Windsurf 使用 Codex 扩展；Xcode 和 JetBrains 的集成入口有所不同，需要按照对应官方说明操作。
第二步：打开 Codex 侧栏
安装完成后，点击编辑器中的 Codex 图标。
如果没有看到图标，可以打开命令面板，搜索并执行：
Codex: Open Codex Sidebar
这是官方文档提供的侧栏打开方式。
第三步：选择 ChatGPT 登录
在未登录页面选择：
Sign in with ChatGPT
完成浏览器登录后，返回编辑器。不要误选 Use API Key，除非你确实准备使用 API 计费方式。
第四步：结合代码开始提问
打开项目，选中相关代码或添加文件上下文，然后描述需要完成的工作。例如：
请解释这段函数的输入、输出和异常处理逻辑。
或者：
请检查当前组件的重复请求问题，给出最小修改方案。
IDE 插件适合边阅读代码、边检查修改结果。完成任务后，查看差异，再决定是否保留修改。
五、桌面端登录和使用教程
第一步：从官方入口下载
当前官方文档将桌面入口称为 ChatGPT 桌面应用，应用内可以选择 Codex。旧教程中的“Codex 桌面端”名称和截图，可能与现在的界面不同。
从 桌面应用官方页面进入下载入口，根据操作系统选择对应版本。官方快速入门文档列出了 macOS、Windows 和 Linux 桌面端。
第二步：登录会员账号
打开应用，在未登录界面选择继续登录，按提示完成浏览器认证。
登录时，核对账号是否与开通 Plus 或 Pro 的账号一致。
第三步：选择 Codex 和项目
按照当前界面选择 Codex，创建新聊天，并选择需要处理的项目或文件夹。
官方桌面教程的基本流程是：安装应用、登录账号、选择工作位置，再发送第一条任务。
建议第一条任务写得具体一些：
请先阅读这个项目，告诉我如何本地启动，以及启动前缺少哪些依赖。暂时不要修改代码。
这样便于检查项目是否选择正确，也能减少一开始就大范围改动的情况。
六、登录时常见的问题
1. 浏览器登录成功，终端没有完成登录
如果是在远程服务器或没有浏览器的环境中运行 CLI，或者本地回调受到阻拦，可以查看官方设备码登录方式：
codex login --device-auth
这项功能需要在账号安全设置或工作区权限中启用，并以当前账号是否支持为准。它用于解决登录回调问题，不代表跳过账号验证。
2. 已经开通会员，仍提示权限或额度问题
建议依次检查：
1. 登录的是不是开通会员的账号。
2. 当前使用的是 ChatGPT 登录还是 API Key。
3. 是否选中了正确的工作区。
4. 账号内是否出现额度或功能限制提示。
会员身份不代表所有模型和任务都无限使用。使用量与模型、任务复杂度等因素有关，应查看账号的用量页面和限制提示。
3. 能否把登录文件交给别人帮忙处理
不要把认证缓存当作普通配置文件发送。
官方明确提醒，~/.codex/auth.json 可能包含访问令牌，应像密码一样保护，不要上传到代码仓库、工单或聊天窗口。
七、登录成功后，先做一个小任务
不必第一次就要求 Codex 重写整个项目。可以从一个容易验证的任务开始：
请检查 README 中的启动命令是否与项目配置一致，说明需要修改的地方。
确认它能读取正确文件、理解需求并给出可检查的结果后，再逐步尝试修复报错、补充测试和实现功能。
对于已经开通 Plus 或 Pro 的用户，接入的关键步骤是：安装官方客户端，选择 ChatGPT 登录，核对会员账号，然后在正确的项目中开始任务。
八、参考资料与核对说明
以上资料用于核对 Codex 入口、ChatGPT 登录与订阅边界，核对日期为 2026 年 10 月 4 日。具体界面、功能和使用限制以 OpenAI 当前官方页面及账号实际显示为准。
正文参考链接
以下为文章已有的公开参考链接，产品规则请以相关官方资料为准。