安装 Codex CLI

Codex 是 OpenAI 出品的 AI 编程助手，装好后在终端里就能直接和 AI 对话、让它帮你写代码、改文件。

你将学会： 安装 Codex CLI、完成首次登录、用三种模式和 AI 对话。

预计时间： 10 分钟

前置条件： 已完成 终端与 Homebrew 的安装。

一、什么是 Codex CLI

你可能用过 ChatGPT 的网页版 —— 打开浏览器，输入问题，AI 回答你。

Codex CLI 做的是类似的事，但它直接运行在终端里。区别在于：

ChatGPT 网页版Codex CLI
在哪用浏览器终端
能看到你的文件吗不能能
能帮你改代码吗只能给建议能直接修改文件
能运行命令吗不能能（经你同意后）

简单来说，ChatGPT 只能"说"，Codex 能"说"也能"做"。

费用说明

如果你已经订阅了 ChatGPT Plus（$20/月）或 ChatGPT Pro（$200/月），Codex CLI 是免费附赠的，不需要额外花钱，不需要单独购买 API 额度。

登录时使用你的 ChatGPT 账号即可。

二、安装 Codex CLI

打开终端，选择以下任一方式安装。

方式一：用 Homebrew 安装（推荐）

如果你跟着上一篇教程安装好了 Homebrew，直接运行：

code
brew install codex

Homebrew 会自动下载并安装 Codex CLI。

方式二：用 npm 安装

如果你的电脑上已经装了 Node.js（一个 JavaScript 运行环境），也可以用 npm 安装：

code
npm install -g @openai/codex

不确定自己有没有 Node.js？在终端输入 node --version。如果显示版本号（比如 v22.x.x），说明有。如果显示 command not found，用方式一的 Homebrew 安装就好。

验证安装

安装完成后，输入以下命令确认 Codex 已经装好：

code
codex --version

看到版本号就说明安装成功。

三、首次登录

安装好了，现在要把 Codex 和你的 ChatGPT 账号关联起来。

在终端中输入：

code
codex

第一次运行时，Codex 会：

  1. 自动打开浏览器，跳转到 OpenAI 的登录页面
  2. 用你的 ChatGPT 账号登录（就是你平时用 ChatGPT 的那个账号）
  3. 页面会提示授权 Codex CLI，点击"允许"
  4. 浏览器显示"认证成功"后，回到终端

终端里会出现一个对话界面，表示 Codex 已经准备好了。

如果浏览器没有自动打开，终端里会显示一个 URL 链接。手动复制这个链接，粘贴到浏览器里打开即可。

四、第一次对话

登录成功后，你会进入 Codex 的交互界面。试着问它一个简单的问题。

首先，让我们进入一个有文件的目录再启动 Codex（这样 AI 才能"看到"你的文件）：

code
cd ~/Desktop
codex

进入对话界面后，输入：

code
what files are on my Desktop?

Codex 会扫描你桌面上的文件，然后用自然语言告诉你有哪些东西。

再试试：

code
create a file called hello.txt with the content "my first AI-created file"

Codex 会先告诉你它打算做什么（创建一个文件），然后等你确认。按 Enter 同意后，它就会帮你创建这个文件。

你可以在 Finder 中打开桌面，确认 hello.txt 是否出现了。

这就是 Codex 的核心体验：你用自然语言描述你想做的事，AI 帮你执行。它不会偷偷做任何事情 —— 每一步都会先问你同不同意。

退出 Codex 对话界面：按 Ctrl + C，或者输入 /exit。

五、三种工作模式

Codex 有三种模式，决定了 AI 的"自主程度"。你可以根据需要切换。

Ask 模式（默认）

code
只回答问题，不做任何操作。

这是最安全的模式。Codex 只会看你的文件、回答问题，但不会修改任何东西。适合你刚开始使用，想先了解情况的时候。

Agent 模式

code
可以读写文件、运行命令，但每一步都先问你。

这是最常用的模式。Codex 会提出操作建议，你逐一确认后它才执行。比如它说"我要修改 app.js 的第 15 行"，你看了觉得没问题，按回车确认，它才动手。

Auto 模式

code
自动执行，不逐步确认。

Codex 会自己判断该做什么，直接执行。适合你已经熟练使用、信任 AI 判断的时候。初学者不建议使用这个模式。

怎么切换模式

在 Codex 对话界面中，你可以在启动时指定模式：

code
codex --approval-mode ask        # Ask 模式
codex --approval-mode suggest    # Agent 模式
codex --approval-mode auto       # Auto 模式

或者在启动后，界面底部会有模式切换的提示。

六、常用操作

在对话中切换模型

code
/model

输入 /model 可以查看和切换当前使用的 AI 模型。

查看帮助

code
/help

列出所有可用的斜杠命令。

开始新对话

code
/clear

清除当前对话历史，从头开始。

退出

按 Ctrl + C 或输入 /exit。

常用斜杠命令速查

命令作用
/help查看所有命令
/model查看或切换模型
/clear清除对话历史
/exit退出 Codex

七、排错指南

"command not found: codex"

原因： Codex 没有正确安装，或者安装路径不在系统 PATH 中。

解决方法：

code
# 如果用 Homebrew 安装的，试试重新安装
brew reinstall codex
 
# 安装完后验证
codex --version

如果还是不行，关闭终端窗口，重新打开一个新的终端再试。

浏览器登录后终端没有反应

解决方法： 回到终端，等几秒钟。有时候认证回调需要一点时间。如果超过 30 秒还没反应，按 Ctrl + C 中断，重新运行 codex。

提示 "rate limit" 或 "quota exceeded"

原因： ChatGPT Plus 有使用额度限制。如果你短时间内用了太多次，会暂时被限速。

解决方法： 等一会儿再试。通常等待几分钟到一小时后会恢复。

brew install 卡住不动

解决方法： 检查网络连接。如果使用的是公司或学校网络，可能存在防火墙限制。试试切换到手机热点。

八、为什么选择 Codex CLI

市面上有很多 AI 编程工具，为什么推荐从 Codex 开始？

性价比最高。 ChatGPT Plus 订阅 $20/月，Codex CLI 免费附赠。不需要单独购买 API 额度，不需要设置 API Key，不需要担心账单。对于刚入门的人来说，这是门槛最低的选择。

上手最简单。 安装一行命令，登录用现有的 ChatGPT 账号，打开就能用。不需要配置环境变量、不需要管理 API Key。

功能完整。 能读文件、写文件、运行命令、理解项目结构。对于日常的编程辅助、文件管理、脚本编写来说完全够用。

为后续做铺垫。 当你后面配置 OpenClaw（AI 网关）时，Codex 的 OAuth 认证可以直接复用，让 OpenClaw 也能使用 OpenAI 的模型作为"大脑"。一次登录，多处使用。

总结

你在这一页学会了：

  • Codex CLI 是运行在终端里的 AI 助手，能直接操作你的文件
  • 用 brew install codex 一行命令安装
  • 首次运行 codex 会通过浏览器登录 ChatGPT 账号
  • 三种模式：Ask（只问不动）、Agent（问了再动）、Auto（自己动）
  • ChatGPT Plus 订阅自带 Codex，不额外花钱

下一步

Codex 装好了，你已经有了一个本地 AI 助手。接下来，我们要搭建 OpenClaw —— 一个开源 AI 网关，让 AI 的能力从终端扩展到 Telegram、定时任务和更多场景。

OpenClaw 从零到一 -->