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

> Codex 不只是命令行工具：CLI、VS Code/Cursor 插件、ChatGPT 网页里的云端任务，三种形态各适合谁？怎么登录、要什么账号档次、为什么登 Codex 要绑手机号？一篇配齐。
> 更新于 2026-08-09 · 难度 初级 · 来源 https://aicdks.com/guides/codex-three-clients

很多人以为 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（详见[限额机制详解](/guides/quota-limits-explained)）。

## 形态一：Codex CLI（命令行）

安装和国内网络配置在[保姆级安装教程](/guides/install-codex-cli-china)里讲得很细，这里只补配置要点。

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

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

```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 中转额度](/category/api-中转与额度-codex-额度)方式。

## 形态二：VS Code / Cursor 插件

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

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

要点：

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

## 形态三：网页 / 桌面端云任务（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 用户。

对应的正确姿势：

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

## 怎么选

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

三种形态的功能和限额官方更新很快，具体以 [OpenAI Codex 官方文档](https://developers.openai.com/codex)为准。遇到 401/403、登录卡住等报错，看[排错指南](/guides/codex-claude-code-troubleshooting)。