# （2025年12月最新版）Codex & Codex CLI 国内使用教程： 支付注册、安装配置、常见命令，手把手教学！ 很多小伙伴让我出一下 codex 的使用文档，我就写了这篇。
首先什么是Codex？Codex 是 OpenAI 专门做代码的 AI。
我现在做大项目的时候，遇到复杂 bug，都靠它！
为什么？
相比 Claude Code：
✅ 细节处理更好（查 bug 特别准） ❌ 但是慢…特别慢…（所以我一般用 Claude 做日常执行，Codex 专门查 bug） 真实案例：agent 生图对比
比如下面的 agent 生图，右边的 GPT5（Codex 的模型），一次性出稿特别好！
左边 Claude：
生成的图有些细节不对 需要多轮调整才能搞定 右边 GPT5（Codex）：
一次性生成完美 细节处理到位，不用反复改 我现在的使用策略
日常执行 → 用 Claude Code（快，理解能力强）
↓
遇到复杂 bug → 切换到 Codex（慢，但查得准）
↓
细节处理 → 继续用 Codex（一次搞定）
特别是大项目：
代码量几千行
bug 藏得很深
Claude 要找好几轮
Codex 一次定位，直接告诉你第几行有问题
💡 结论：Codex 不是 Claude 的替代品，而是完美搭档！
问题来了，怎么才体验 Codex？接着往下看！
# 一、怎么才体验 Codex？ 目前 Codex 需要付费才能使用，ChatGPT Plus、Pro、Business 等付费会员都可以使用，这些用户网页版就已经有 Codex 入口：
目前 Codex 和 Claude Code 一样需要付费才能使用，如果你还是免费用户，可以试试这个一键升级工具（支持微信/支付宝付款）：
✅小林亲测有效，点击链接🔗👉：国内自助升级 ChatGPT Plus 网站 (opens new window)
详细的 ChatGPT Plus 充值教程，我也写过详细的教程：ChatGPT Plusc充值完全指南 (opens new window)，手把手教程，亲测有效！
# Codex 使用场景有哪些？ 三种使用方式： Codex 网页版、IDE扩展、Codex CLI 终端。
GPT-5-Codex 专为 Codex CLI、Codex IDE 扩展、Codex 云环境和在 GitHub 中工作而构建，还支持多种工具使用。
下一步：安装 Codex CLI（继续往下看！）
# 二、零代码安装 Codex CLI（提示词大法） 🚀 重点来了：你不需要懂命令行！我把安装步骤都写成提示词了，复制给 AI 就行！
# 为什么要装 CLI 版本？ CLI = 命令行工具（听起来很专业，其实就是"高级版软件"）
为什么不装 IDE 拓展插件版？
• ✅ CLI 功能最全（可以被其他 AI 调用） • ✅ 可以管理 MCP 插件（给 AI 装"外挂"） • ✅ 可以变成 MCP 给其他 AI 用（后面教你） 但是！重点来了：
你完全不需要懂命令行！我已经把所有步骤都写成提示词了！
# 准备工作：先装个 AI 搭档 我推荐 Trae (opens new window)（中文友好，界面简洁）。
为什么要装这个？因为后面安装 Codex 的时候，你需要一个 AI 来帮你执行命令…
没下载 Trae？下载教程我也给大家写好了：《TRAE-AI编程 – 字节跳动推出的免费AI编程工具 (opens new window)》
# Codex CLI 安装步骤 # 第1步：复制这段话，发给 Trae（或其他 AI） 帮我自动检查环境并安装 Codex CLI 工具，按以下步骤执行：
第一步：检查系统和环境
- 检查我的操作系统（Mac/Linux/Windows）
- 如果是 Windows：检查是否有 WSL（运行 wsl --version 或 wsl -l -v）
第二步：检查 Node.js
- 运行 node -v 检查 Node.js 是否已安装
- 如果没有安装，提示我：
Mac: 运行 brew install node 或去 nodejs.org 下载
Linux: 运行 sudo apt install nodejs npm 或去 nodejs.org 下载
Windows: 去 nodejs.org 下载安装
第三步：安装 Codex
根据环境选择：
- Mac/Linux：直接运行 npm install -g @openai/codex
- Windows 有 WSL：在 WSL 环境运行 npm install -g @openai/codex
（提醒我：以后使用时先输入 wsl 再输入 codex）
- Windows 无 WSL：先询问我是否要安装 WSL（推荐，更稳定）
- 如果要：运行 wsl --install，提醒我重启后继续
- 如果不要：运行 npm install -g @openai/codex --force --no-os-check
（警告：Windows 原生环境可能有兼容问题）
第四步：验证安装
- 运行 codex --version 检查是否安装成功
- 告诉我下一步该怎么启动 Codex
# 第2步：等 AI 自动帮你装 执行上面的这段话后，AI 会自动检查你的系统、安装依赖、安装 Codex…你只需要坐着等！
如果你是极客，就是想自己手动执行命令安装的话，可以按下面的步骤（注意：已经让AI 自动帮你安装的同学，不需要看这个手动安装的命令）：
# 1. 确保 Node ≥ 22
node -v # v22.5.1
# 2. 一行命令搞定
npm i -g @openai/codex
# 3. 验证
codex --version # 0.36.0
如果感觉国内 NPM 很慢？两条路：
1. `npm i -g @openai/codex --registry=https://registry.npmmirror.com`
2. 或者 `brew install codex`（for mac 用户，Homebrew 已同步最新版）
# 第3步：登录你的 ChatGPT 账号 安装完成后，第一次进入 Codex 会要求登录。
用刚才买的 Google 账号登录就行！
# 第4步：后续启动（超简单） 打开终端，输入 codex，回车！
看到这个对话框了吗？成功了！
遇到问题怎么办？
• 卡住不动？等3分钟，可能在下载依赖 • 报错了？截图发给 AI，让它帮你解决 💡 记住：不要自己动手敲命令，让 AI 帮你！
# 三、基础操作（5分钟上手） # 1. 拖拽文件（有个坑，别踩） ❌ 错误方法：直接把文件拖进去 → 失败！
✅ 正确方法：按住 Shift，再拖进去 → 成功！
💡 为什么？ 因为 Codex 需要 Shift 键才能识别拖拽…我也不知道为什么要这么设计…
# 2. 选模型（推荐 gpt-5 high） 输入 /model，回车。
两个模型的区别：
• codex 专业版：纯代码生成（速度快，但理解能力弱） • gpt-5 通用版：理解能力强（推荐新手用这个！）
选档次的时候，当然选 high！
• high = 高推理能力（处理复杂问题更准） • 缺点：稍微慢一点，但值得！
# 3. 权限设置（推荐"自动判断"） 输入 /，选 approvals。
三种权限模式：
权限 读文件 改文件 适合谁？ 只读 ✅ ❌ 超级谨慎（但啥也干不了…） 自动判断 ✅ 需确认 新手首选！ 全通过 ✅ ✅ 老手（有风险） 为什么选"自动判断"？
AI 读文件 → 自动通过（不用每次点确认，省事！） AI 改文件 → 弹窗确认（重要操作你说了算）
# 4. 其他常用命令 新建会话：/new
让 AI 理解你的项目：/init
这个命令会生成一个 .claude.md 配置文件，下次打开项目 AI 就自动知道这是啥了！
查看已安装的 MCP：/mcp
💡 记住这4个操作，基本够用了！
# 四、给 AI 装插件（MCP 管理，又是提示词大法） 🔥 又一个爆点：别的教程让你手改配置文件，我们用一句话搞定！
# MCP 是啥？ MCP = 给 AI 装插件
举个例子：
• 默认情况：AI 只能写代码、读文件 • 装了 Chrome DevTools MCP → AI 可以操作浏览器！（自动测试、爬虫、截图） • 装了 滴滴出行 MCP → AI 可以帮你叫车！（是的，真的可以） # 怎么装？（提示词大法好） # 第1步：复制这段提示词，发给 Codex 帮我管理 MCP 服务(添加或删除)。
我会提供配置信息,格式如下:
{
"mcpServers": {
"服务名": {
"command": "命令",
"args": ["参数列表"]
}
}
}
请你根据我的需求:
## 添加服务
1. 提取配置中的服务名、command、args
2. 转换成命令:codex mcp add-json <服务名> '{"command": "xxx", "args": [...]}'
3. 执行安装
4. 安装完成后测试是否可用
## 删除服务
使用命令:codex mcp remove <服务名>
# 第2步：告诉 Codex 你要装什么 例如：
@提示词
添加 MCP:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["chrome-devtools-mcp@latest"]
}
}
}
就这么简单！ AI 会自动帮你装好！
验证：
输入 /mcp，看到 “chrome-devtools” 出现在列表里就成功了！
💡 提示词大法：所有复杂操作，都可以让 AI 帮你搞定！
# 五、终极玩法 – 双 AI 联动（省钱又爽） 💡 最后一个爆点：让 Claude Code 当项目经理，Codex 当技术专家！
# 什么意思？ 简单说：在 Claude Code 里装一个 Codex 插件，遇到复杂代码问题自动调用 Codex！
工作流程：
你提问 → Claude Code 开始干活
→ 遇到复杂 bug（查不出来）
→ 自动调用 Codex MCP
→ Codex 返回精准答案
→ Claude Code 继续完成任务
你完全不用切换工具！一切自动完成！
# 为什么要这么做？ 问题场景：
• 你主要用 Claude Code（快，理解能力强） • 但 Claude 处理复杂代码细节不如 Codex • 你又买了便宜的 Team 账号（10元/月） 解决方案： 把 Codex 装成 Claude Code 的"外挂"！
• 日常工作用 Claude Code（架构设计、多轮对话） • 遇到技术难题 → 自动调用 Codex（查 bug、代码细节） 特别适合国产模型用户！ 如果你用 GLM 之类的，配合 Codex 简直完美！
# 安装步骤 复制这段话，发给 Claude Code（或其他 AI）：
用下述指令，安装 codex MCP:
claude mcp add codex -s user -- codex -m gpt-5-codex -c model_reasoning_effort="high" mcp
安装成功后，测试是否正常显示
验证一下：
在 Claude Code 里输入 /mcp，看到 “codex” 出现在列表里就成功了！
# 为什么推荐双 AI 联动？ AI 擅长什么？ 怎么用？ Claude Code 理解项目、架构设计、多轮对话、日常执行 主力 Codex 查 bug、代码细节、复杂逻辑 辅助 结论：取长补短，省钱又高效！
# 六、快捷键速查表（收藏备用） # 常用快捷键 作用 Mac Windows/Linux 多行输入 Option + Enter Alt + Enter 中断响应 Ctrl + C Ctrl + C 历史命令 ↑ / ↓ ↑ / ↓ # 编辑快捷键 作用 Mac Windows/Linux 跳到行首 Ctrl + A Ctrl + A 跳到行尾 Ctrl + E Ctrl + E 按词移动 Option + ←/→ Alt + ←/→ 删到行首 Ctrl + U Ctrl + U 删到行尾 Ctrl + K Ctrl + K 删除单词 Ctrl + W Ctrl + W 撤销 Ctrl + / Ctrl + / 有问题评论区见！