Codex 国内使用全攻略（2026）：终端、VS Code、Cursor、Opencode 四种接入方式
ChatGPT 会员可以直接用 Codex，不用额外买 API。本文把四种接入方式一次讲清：Codex CLI 的安装与授权、VS Code 插件、Cursor 里切换 Codex 模型、Opencode 客户端登录，以及国内网络环境下最容易踩的坑。
一、Codex 是什么，有哪四种用法
Codex 是 OpenAI 官方出品的 AI 编程工具，可以理解为终端版的 ChatGPT，专门用来写代码。目前国内常见的接入方式有四种：Codex CLI 在终端里直接对话写代码；Cursor 插件在 Cursor 编辑器里调用 Codex 模型；VS Code 插件在侧边栏对话；Opencode 在客户端里登录 Codex 账号使用。
现在三大主流编程工具是 Codex、Claude Code 和 Gemini。Claude Code 综合能力很强，但账号风控严格，对国内用户不算友好；Gemini 在前端设计方面优势比较明显；Codex 普遍被认为在代码审查上做得更出色，因为它分析严谨，代价是速度会慢一些。
Codex 的优势在于门槛低：Plus 会员（每月 20 美元）直接用，不用额外买 API；比 Claude 稳定，不用担心封号。前提是需要 ChatGPT Plus、Pro 或 Team 会员，免费账号用不了，另外需要一个稳定的科学上网环境。
二、前置准备：账号与会员
如果已经有 ChatGPT 账号，这一步可以跳过。注册地址是 chat.openai.com，国内邮箱（QQ、163、Outlook 都行）可以注册，不需要国外手机号，但注册过程需要科学上网环境。
会员这一环是硬性的，因为 Codex 只对付费用户开放，Plus、Pro、Team 任意一种都可以。麻烦的地方在于 ChatGPT 需要绑定海外银行卡支付，国内发行的 Visa 通常不行，对国内用户不太友好，如果只是想省事，可以找可靠渠道解决支付问题。升级成功后，在 ChatGPT 设置页能看到 Plus 标识。
三、Codex CLI：安装
Codex CLI 基于 Node.js 运行，需要 Node.js 22 或以上版本。先打开终端（Mac）或 PowerShell（Windows），运行 node -v 检查是否已安装。如果显示版本号大于等于 22，可以跳过安装；如果版本低于 22 或提示命令不存在，就去 nodejs.org 下载安装。
官网提供两种安装方式。方式一是下载安装程序，适合新手：Windows 下载 .msi 文件双击运行，一路点下一步；Mac 下载 .pkg 文件，按提示完成安装。方式二是命令行安装，适合有终端经验的用户，官网会显示一段基于 nvm 的安装命令，复制到终端执行即可。Windows 用户建议直接用方式一。装完重新打开终端，运行 node -v 确认版本。
接着安装 Codex CLI 本体。Mac 用户推荐用 npm 安装，遇到权限问题可以用 sudo，国内网络慢可以用镜像加速，也可以用 Homebrew。Windows 用户需要以管理员模式打开 PowerShell 再执行安装命令，同样可以用镜像加速。安装完成后运行 codex --version，看到版本号就说明成功了。
四、Codex CLI：登录授权
推荐的方式是 ChatGPT 官方账号登录。在终端输入 codex，如果你没有配置任何第三方 API key，会弹出登录选项。选择使用官网登录，浏览器会跳转到 OpenAI 页面，如果没有自动打开，可以复制它提供的链接手动打开，然后登录你那个有会员的 ChatGPT 账号。授权成功后 token 会自动保存到 .codex 目录，下次启动不用重复登录。
登录完成后会提示当前工作目录，并问你怎么执行操作。选项一是允许 AI 直接修改该目录下的文件、直接运行终端命令，期间不弹确认提示；选项二是修改任何一行代码或执行任何指令前都先让你确认。实际使用中选自动执行的比较多，每次都确认确实麻烦。Codex 会自动读取当前目录的代码上下文，所以在项目根目录启动会更省事。
另一种方式是使用第三方 API，适合已经有 API key 的用户，不需要 ChatGPT Plus 账号。做法是创建配置目录、写好 config.toml、再创建存放 API Key 的 auth.json，最后验证配置。需要注意第三方 API 必须支持 Codex 相关模型（比如 gpt-5-codex）才能正常使用，配置前先确认服务商是否提供对应模型。
五、Codex CLI：常用命令
启动和退出：直接输入 codex 进入交互模式；codex 加上你的问题可以在启动时直接提问，适合快速问一个简单问题；/quit 或 Ctrl+C 退出当前会话。
最常用的几条交互命令值得记住。/model 切换模型和 reasoning effort，简单任务切低配省额度，复杂任务切高配；/approvals 设置哪些操作需要确认、哪些自动执行，信任度高的项目开 full access，重要项目开 default；/status 查看当前模型、权限模式和 token 使用情况；/clear 清空当前对话历史重新开始；/compact 压缩上下文，对话太长时用它释放空间，系统也会自动压缩；/new 开始新对话但不退出当前会话；/review 审查当前代码改动、找出问题，写完代码让 AI 帮忙 review 时很好用。
会话管理上，/resume 恢复之前保存的对话，比如第二天继续昨天的重构任务；/fork 从当前对话分叉出一个新对话，适合想尝试不同方案又不想丢掉当前进度。进阶功能里，/skills 让 Codex 用特定技能处理任务，值得专门试；/experimental 用来开关实验性功能。
启动参数方面，codex --full-auto 是全自动模式，AI 直接执行不需确认，适合批量处理文件和自动化脚本；codex -a on-request 让模型每次执行命令前都需要你确认；codex --model gpt-5-codex 可以临时指定模型而不改配置；codex --help 查看所有可用参数。
还有一个危险但方便的参数：codex --dangerously-bypass-approvals-and-sandbox 会跳过所有确认并禁用沙盒，让 AI 完全自主执行。建议只在测试环境或你完全信任 AI 输出时使用，生产环境慎用。
这些命令不需要全都记住。用得最多的通常是启动命令、review 审查、compact 压缩和 skills 查看技能。另外，Codex 是多模态模型，能看懂截图里的文字和界面元素，直接截图报错让它分析是可行的。
六、VS Code 插件
不习惯用命令行的话，VS Code 插件更直观。打开 VS Code，在左侧扩展商店搜索 Codex，找到 OpenAI 官方的 Codex 插件点击安装。安装后左侧边栏会出现 Codex 图标，点击它会弹出登录提示，点登录后浏览器自动打开授权页面，流程和 CLI 一样，用 ChatGPT Plus 账号授权即可。授权成功后回到 VS Code，就能在侧边栏对话了。一个很顺手的功能是选中代码快速提问：选中一段代码，右键选择 Ask Codex，AI 会针对选中的代码回答。
七、Cursor 集成
Cursor 是目前最火的 AI 编程编辑器之一，本身自带 Claude 模型，但你也可以切换成 Codex 模型。方式一是在 Cursor 的扩展商店搜索 Codex 插件安装，和 VS Code 一样；如果已经配置了 API Key，安装后直接可用，没有配置则需要授权登录 ChatGPT 账号。
方式二是在 Cursor 的 AI 对话框里直接切换到 Codex 模型。需要特别注意的是，这种方式走的是 OpenAI API 计费，不是 ChatGPT Plus 会员额度。你需要在 platform.openai.com 有 API 余额，并在 Cursor 设置的 Models 里找到 OpenAI API Key 填入自己的 Key，然后在对话框选择 Codex 相关模型。
如果遇到报错提示模型服务商不对你所在地区开放，说明 Cursor 检测到服务商没有对你这个 IP 所属地区开放。解决方案是开启全局代理（增强模式或系统代理）。如果开了还是报错，可能是 Cursor 没有走系统代理，可以在设置里搜索 proxy 配置代理地址。如果代理问题不好解决，建议改用 Codex 插件，或者直接用 Codex CLI 和 Opencode。
八、Opencode 集成
Codex 支持 Opencode，允许用户直接在 Opencode 里使用 Codex 的订阅和使用限制，也就是可以直接登录自己的 Pro 或 Plus 账号使用。
先去 opencode.ai/download 下载客户端。安装完进入客户端，初始是什么都没有的状态。左上角的加号可以添加项目，在对话框输入 /model 可以选择模型，右上角有连接供应商的按钮，选择连接 OpenAI，如果你开了会员就在这里登录 ChatGPT 账号。授权流程和前面一样，可能会直接跳转到 ChatGPT 登录页面。授权成功后就可以使用 ChatGPT 的模型了，之后也能在模型管理里切换。需要注意不同版本界面差异比较大，部分 macOS 版本目前没有「添加模型」按钮，Windows 有些版本左下角会出现加号。
九、常见问题与踩坑
安装时报 npm ERR，通常是 Node 版本太低，升级到 Node 22 以上即可。登录后一直停在思考状态，多半是网络问题，可以开全局代理，或在终端里设置代理环境变量，把端口换成你自己的代理端口。信用卡支付被拒，是因为国内卡不支持，需要走可行的支付渠道。Cursor 里找不到 Codex 模型，一般是版本问题，更新到最新版。输入 /model 后没有响应，可能是网络延迟，等几秒或检查代理设置。
十、总结
ChatGPT Plus 会员直接用 Codex CLI，逻辑缜密，速度慢于 Claude Code，但胜在稳定、使用门槛低，是目前国内比较好用的 AI 编程命令行工具之一。
实际使用中几种工具可以搭配：Gemini 做前端，Claude Code 做主力开发，Codex 负责代码审查，整体代码质量和工作效率都会更高。