一、国内用户如何使用 Codex & Codex CLI？完整教程指南

最近，OpenAI 的 Codex 再次火爆全网。作为国内用户，虽然直接上手仍有一些门槛（如账号注册与支付问题），但最新升级让体验变得更简单。半年前，我的主力编码工具是 Cursor；三个月前切换到 Claude Code。但随着“降智事件”、封号风波以及 A 社的争议言论，我开始寻找更可靠的备选方案。

上个月，OpenAI 推出重磅更新：ChatGPT Plus 用户无需 API Key，直接登录即可使用 Codex CLI！这大大降低了门槛。全网都在讨论 Codex 的代码生成能力“质变”，我顺势安装了 Codex CLI，结果用后上瘾。于是撰写这篇“踩坑 + 对比实录”，专为首次上手 Codex 的国内用户准备，帮助你快速掌握 Codex CLI 安装教程和使用技巧。

注意：Codex 和 Claude Code 均为付费服务。如果你是免费用户，可先使用这个一键升级工具：

国内一键升级 ChatGPT Plus 工具：gptplus.org.cn

如果你还没有 ChatGPT 账户，可直接用邮箱注册，支持各种邮箱类型。

官方正规渠道
已服务 2,847+ 位用户

ChatGPT Plus 官方代充 · 5分钟极速开通

解决海外支付难题，享受 GPT-5 完整功能

官方正规渠道
支付宝/微信
5分钟自动开通
24小时服务
4.9分（1200+好评）
官方安全通道
平均3分钟开通
官方价 ¥180/月
¥160/月
节省 ¥20
立即升级 GPT-5

二、哪些用户可以免费使用 Codex？付费会员详解

Codex 目前需付费订阅，ChatGPT Plus、Pro、Business 等会员均可访问。网页版已有 Codex 入口：
ChatGPT Plus 用户 Codex 入口界面示意图

三种主要使用方式：Codex 网页版、IDE 扩展插件、Codex CLI 终端命令行。
GPT-5-Codex 专为 Codex CLI、Codex IDE 扩展、Codex 云环境和 GitHub 集成设计，还支持多种工具扩展，提升代码生成效率。

三、Codex CLI 快速安装教程（适用于国内环境）

3.1 通过 NPM 安装 Codex CLI

若本地已安装 NodeJS（版本 ≥ 22），可直接用 NPM 安装 Codex CLI。步骤如下：

步骤 命令示例
1. 确认 Node 版本 node -v # 示例输出：v22.21.10
2. 使用 NPM 安装 npm i -g @openai/codex
3. 验证安装成功 codex –version # 示例输出：0.42.0

国内 NPM 源较慢时，可切换镜像加速：

命令
npm i -g @openai/codex –registry=https://registry.npmmirror.com

3.2 安装 Codex 插件版本（适用于 VSCode 和 Cursor）

如果不习惯 CLI 命令行，可选择插件版 Codex。目前，VSCode 和 Cursor 应用商店均支持 Codex 插件安装：
VSCode 或 Cursor 中搜索安装 Codex 插件界面

在输入框直接描述需求，或切换模型（如 GPT-5-Codex high）：
Codex 插件使用界面，展示模型切换和代码生成示例

对于新手，IDE 插件版 Codex 是最友好的选择，提供 GUI 界面，降低上手难度。

四、无需复杂配置，一键启动 Codex CLI

在终端输入：

命令
codex

首次运行会弹出网页，使用 ChatGPT 账户一键登录，自动写入 ~/.codex/token。无需复制 API Key，只要你是 Plus、Pro 或 Business 会员即可。
Codex CLI 首次登录授权界面，选择 Sign in with ChatGPT

若授权回调失败，通常是网络问题。建议启用魔法工具的全局 Tun 模式：
网络问题解决：启用 Tun 模式后重新授权 Codex CLI

重启 Codex 后重新授权即可。

五、Codex CLI 常用命令与实用技巧

在使用 Codex CLI 时，常见疑问可参考以下解决方法，帮助你优化体验。

5.1 设置 Codex 以简体中文回复

对于英文不熟练的用户，必备设置：在 ~/.codex/ 下创建 AGENTS.md 文件，内容为：“Always respond in Chinese-simplified”。

Mac 用户可直接执行命令：

命令
mkdir -p ~/.codex && printf ‘Always respond in Chinese-simplified\n’ > ~/.codex/AGENTS.md

5.2 Codex CLI 常用指令示例

场景 命令示例 体验效果
1. 直达指令 codex “写一个下载文件的 Python 脚本” 约 3 秒生成可运行代码，无冗余说明。
2. 交互模式 codex ↵ → >> 把上面的脚本改成并发 支持 Tab 补全、Ctrl-R 历史搜索，类似 zsh 操作。
3. 图片报错修复 codex -i error.png “修掉图中的报错” 直接解析截图，免手动输入错误栈。
4. 整仓重构 codex “给整个 Go 项目加 ctx 传值” 先输出改造计划 → 生成 Diff 审核 → 批量应用。
5. 一键执行 codex exec “跑通 pytest” 自动安装依赖 → 执行测试 → 失败自动回滚。

六、Codex vs Claude Code：详细对比分析

维度 Codex (GPT-5) Claude Code (Opus 4.1)
登录门槛 ChatGPT Plus / Business 用户一键登录，无需 API Key 需要美区账号 + 接码，国内 IP 易封禁，门槛高
响应速度 首 token 平均 1.2 秒，高效零赘述 约 2.5 秒，常先分析再输出，稍显拖沓
上下文能力 处理 200k+ token，适合中大型仓库 理论 1M token，但复杂项目易失焦
目录结构 精准按结构生成文件，不乱放 偶尔合并文件，过度“聪明”
工程化体验 任务面板、Diff 审批清晰，社区生态丰富 功能多但复杂，新手易迷失
前端审美 简洁工程师风格，专注速度 动效丰富，但略花哨
价格策略 绑定 Plus / Business，不限量，每 3 小时约 40 次交互，高性价比 20～200 阶梯价，封号风险高
隐私模型 云端沙盒执行，不保留记录 本地执行更私密，但依赖硬件

高性价比开通 Business 会员：使用下方工具，只需几十元即可。

国内自助升级 ChatGPT 工具：gptplus.org.cn

七、Codex 常见错误及解决方法

7.1 修复 Codex 401 Unauthorized 错误

出现 401 Unauthorized 表示授权过期：
Codex 401 Unauthorized 错误界面及解决步骤

执行 /logout 退出，然后重启 Codex 重新授权。

7.2 解决 Codex 502 Stream Error 或 Re-connect 失败

多为网络问题：启用魔法工具 Tun 模式，或设置代理：

命令
export HTTPS_PROXY=127.0.0.1:7890

Vibe coding，不是单纯写代码，而是谱写自己的节奏～