# (2025年12月最新版)Codex & Codex CLI 国内使用教程: 支付注册、安装配置、常见命令,手把手教学!

很多小伙伴让我出一下 codex 的使用文档,我就写了这篇。

首先什么是Codex?Codex 是 OpenAI 专门做代码的 AI

Codex

我现在做大项目的时候,遇到复杂 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 会要求登录。

img

用刚才买的 Google 账号登录就行!

# 第4步:后续启动(超简单)

打开终端,输入 codex,回车!

img

看到这个对话框了吗?成功了!

遇到问题怎么办?

  • • 卡住不动?等3分钟,可能在下载依赖
  • • 报错了?截图发给 AI,让它帮你解决

💡 记住:不要自己动手敲命令,让 AI 帮你!

# 三、基础操作(5分钟上手)

# 1. 拖拽文件(有个坑,别踩)

❌ 错误方法:直接把文件拖进去 → 失败!

✅ 正确方法按住 Shift,再拖进去 → 成功!

💡 为什么? 因为 Codex 需要 Shift 键才能识别拖拽…我也不知道为什么要这么设计…

# 2. 选模型(推荐 gpt-5 high)

输入 /model,回车。

img

两个模型的区别

  • codex 专业版:纯代码生成(速度快,但理解能力弱)
  • gpt-5 通用版:理解能力强(推荐新手用这个!)

img

选档次的时候,当然选 high

  • high = 高推理能力(处理复杂问题更准)
  • • 缺点:稍微慢一点,但值得!

img

# 3. 权限设置(推荐"自动判断")

输入 /,选 approvals

img

三种权限模式

权限 读文件 改文件 适合谁?
只读 超级谨慎(但啥也干不了…)
自动判断 需确认 新手首选!
全通过 老手(有风险)

为什么选"自动判断"?

  • AI 读文件 → 自动通过(不用每次点确认,省事!)
  • AI 改文件 → 弹窗确认(重要操作你说了算)

img

# 4. 其他常用命令

新建会话/new

img

让 AI 理解你的项目/init

img

这个命令会生成一个 .claude.md 配置文件,下次打开项目 AI 就自动知道这是啥了!

查看已安装的 MCP/mcp

img

💡 记住这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 + /

有问题评论区见!

上次更新: 12/2/2025