Codex 的三种用法：CLI、IDE 插件、网页云端任务完整对比与配置

很多人以为 Codex 就是个命令行工具，其实它是 OpenAI 的一整套编程 Agent，有三种使用形态，共享同一个账号和同一套额度。搞清楚三种形态的区别，你才能选对工具、也才能看懂商品页上「支持 Codex」到底意味着什么。

三种形态一览

	① Codex CLI	② IDE 插件	③ 网页/桌面端云任务
在哪用	终端命令行	VS Code / Cursor / Windsurf	chatgpt.com/codex、ChatGPT 桌面 App
代码在哪跑	你自己的电脑	你自己的电脑	OpenAI 云端沙箱
适合谁	习惯终端的开发者	主流：边看代码边让 AI 改	派发后台任务、手机上也能看进度
账号要求	Plus/Pro/Team 或 API Key	Plus/Pro/Team 或 API Key	必须 ChatGPT 账号登录（不支持纯 API Key）
是否吃订阅额度	是（ChatGPT 登录时）	是	是，与本地任务共享 5 小时窗口

额度是共享的：本地消息（CLI/插件）和云端任务用同一个 5 小时滚动窗口，另可能叠加周限额。Plus 够轻中度使用，Pro 是 Plus 的 5x/20x（详见限额机制详解）。

形态一：Codex CLI（命令行）

安装和国内网络配置在保姆级安装教程里讲得很细，这里只补配置要点。

npm install -g @openai/codex
codex          # 首次运行，选 Sign in with ChatGPT

配置文件在 ~/.codex/config.toml，常用配置：

model = "gpt-5"                # 默认模型
approval_policy = "on-request" # 什么时候要你确认

# 走 API 中转时配置自定义 provider
[model_providers.myrelay]
name = "myrelay"
base_url = "https://你的中转地址/v1"
env_key = "OPENAI_API_KEY"

国内注意：登录和调用都要能连 openai.com，终端也要走代理（export https_proxy=...）；连不上就改用 API 中转额度方式。

形态二：VS Code / Cursor 插件

对多数人来说这是体验最好的形态：AI 直接读你编辑器里打开的项目上下文。

在 VS Code / Cursor / Windsurf 的扩展市场搜索 「Codex – OpenAI’s coding agent」（发布者 OpenAI）安装。
侧边栏点 Codex 图标（找不到就命令面板运行 Codex: Open Codex Sidebar）。
点 Sign in，浏览器弹出 OpenAI 登录页，用 ChatGPT 账号登录。

要点：

CLI 和插件共享登录凭据——CLI 登录过，插件就自动登录了，反之亦然；一边登出，两边都要重登。
插件里可以把任务「Send to cloud」转到云端跑，也能把云端任务拉回本地继续。
Cursor 用户注意：Codex 插件和 Cursor 自带的 AI 是两套东西、两套账号体系，互不干扰（Cursor 本体的用法见这篇）。

形态三：网页 / 桌面端云任务（Codex cloud）

打开 chatgpt.com/codex（或 ChatGPT 桌面 App 里的 Codex 入口），连接你的 GitHub 仓库，然后像发消息一样派任务：「修复这个 issue」「给这个模块加测试」。Codex 会在云端沙箱里克隆你的仓库、跑代码、最后给你一个可以直接提 PR 的改动。

适合的场景：

电脑配置差 / 不想本地折腾环境；
同时派发多个后台任务，睡前派活早上收结果；
顺手让它做自动 Code Review（云端专属功能）。

注意：云端形态必须用 ChatGPT 账号登录，纯 API Key 用户用不了；免费档基本不可用，需要 Plus 及以上。

关键注意点：登 Codex 要绑手机号

这是买成品号的用户最常踩的坑：ChatGPT 网页能正常登录 ≠ 能登 Codex。Codex 的登录流程（codex login、插件登录、设备码登录都一样）中，OpenAI 可能把你重定向到 auth.openai.com/add-phone，要求账号绑定手机号才能继续——即使你是付费的 Plus 用户。

对应的正确姿势：

买号时看清商品说明：标注「已绑手机号」「可登 Codex」的成品号可以直接用。
号没绑手机号的，用长效接码号码自己绑一个：登录流程走到 add-phone 页面时填接码号码、收验证码即可。别用一次性接码——手机号绑定后还可能用于后续验证，号码失效会很麻烦（接码是什么见这篇）。
绑定手机号在 ChatGPT 网页的账号设置里也可以提前做，建议拿到号第一时间处理（完整的成品号首登流程见这篇）。

怎么选

你的情况	推荐形态
日常写代码，用 VS Code/Cursor	② 插件为主，重活转云端
终端党 / 服务器上干活	① CLI
想批量派任务、自动 Review PR	③ 云端
只有 API 中转额度没有订阅	① CLI 或 ② 插件（API Key 方式），云端用不了

三种形态的功能和限额官方更新很快，具体以 OpenAI Codex 官方文档为准。遇到 401/403、登录卡住等报错，看排错指南。