Codex 入门教程：安装、登录与第一个任务

一句话介绍：Codex 是 OpenAI 推出的 AI 编程代理，能在你的电脑上读取项目、修改文件、运行命令，也能把任务交给云端环境在后台完成。它有命令行（Codex CLI）、编辑器扩展、桌面应用和网页（ChatGPT 中的 Codex）几种用法，本文以命令行为主。

截图待补充

上线前补充实际操作截图并核验软件版本。本文写作时 Codex CLI 最新版本为 0.160.1，命令摘自 OpenAI 官方文档与官方 GitHub 仓库 openai/codex。

CCodex

OpenAI 的编程代理，可在本地或云端完成编程任务

官方入口

openai.com/codex

收费方式

ChatGPT 订阅（含免费版）或 API 按量付费

适合人群

开发者、想用 AI 建站的用户

教程

Codex 介绍与教程

资料核验：2026-10-09

编辑器、Git、练习项目等通用准备见 AI 编程工具入门：开始使用前需要准备什么，本页只讲 Codex 本身。

1. 主要功能

功能	说明
本地编程代理（CLI）	在终端里读懂项目、规划改动、编辑文件、运行本地开发工具
代码审查	用 /review 检查未提交的改动、某次提交或与主分支的差异，只给出问题清单，不改动你的文件
项目说明文件	用 /init 生成 AGENTS.md，写入项目规范，之后每次自动参考
非交互执行	codex exec 适合在脚本或 CI 中自动运行任务
恢复会话	codex resume 回到之前的对话继续工作
技能与插件	把常用流程打包成技能，或通过插件连接外部工具
其他界面	VS Code 等编辑器扩展、桌面应用（可运行 codex app 打开）、网页版云端任务 chatgpt.com/codex

2. 适合谁 / 不适合谁

适合：

• 已经在用 ChatGPT、希望用同一个账号写代码的人；
• 想让 AI 完成整块任务，或在后台并行跑几个任务的开发者；
• 想在提交前让 AI 做一次代码审查的人。

不太适合：

• 只想要编辑器里的补全提示——可以看 GitHub Copilot；
• 完全不想接触终端的人——可以改用 Codex 桌面应用或编辑器扩展，或选择 Cursor。

3. 收费方式

方式	说明
ChatGPT 订阅	官方定价页说明 Codex 包含在 ChatGPT 的 Free、Go、Plus、Pro、Business、Edu、Enterprise 方案中，不同方案用量额度不同
API 密钥	按 API 用量付费，官方建议用于 CI 等自动化场景

免费版和各付费档的具体额度、价格变化较快，以 OpenAI 官网为准。额度用完的处理方式见 AI 工具的免费额度与使用限制。

4. 安装

以下命令摘自官方文档和官方 GitHub 仓库 README 原文。

macOS、Linux（官方独立安装脚本）：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows（官方说明：在新的 PowerShell 窗口中运行）：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以用包管理器：

# npm（需要先安装 Node.js）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

安装完成后，打开新的终端窗口，运行 codex 能进入界面即说明安装成功。用安装脚本安装的，以后升级时重新运行同一条安装命令即可。

安装脚本下载很慢或失败

官方安装脚本默认从 OpenAI 的发布服务器下载，失败时会改从 GitHub Releases 下载。如果两者都超时，多半是终端没有走代理，见本文第 10 节。

5. 登录

1. 进入项目文件夹：

   cd 你的项目路径
   codex

2. 第一次运行时选择 Sign in with ChatGPT（用 ChatGPT 账号登录），按提示在浏览器中完成授权；也可以选择其他登录方式，比如使用 API 密钥（需要额外设置，见官方认证文档）。

3. 回到终端，看到输入框就可以开始了。

官方建议用 ChatGPT 账号登录，这样用量计入你的 ChatGPT 方案。

6. 第一个任务

在一个已经用 Git 管理的练习项目中操作（创建方法见 AI 编程工具入门）。

1. 了解项目：

   介绍一下这个项目：做什么用、用了哪些技术、从哪个文件开始看。

2. 生成项目说明：输入 /init，让 Codex 生成 AGENTS.md，打开看一遍，删掉不准确的内容，补上你的要求（例如“界面文字一律使用简体中文”）。

3. 提一个小改动，并要求先说计划：

   在页脚加上当前年份的版权信息，年份自动更新。
   先告诉我要改哪些文件，确认后再修改。

4. 检查改动：Codex 会显示它运行的命令和改动的差异；你也可以在另一个终端运行 git diff。

5. 审查一次：输入 /review，选择审查未提交的改动，看它是否指出问题。

6. 满意后提交，不满意就用 Git 回退。官方建议在任务前后各做一次 Git 提交，方便撤销。

7. 常用命令

在终端里启动时用：

命令	作用
codex	启动交互界面
codex exec "任务"	非交互运行一个任务，适合脚本和 CI
codex resume	恢复之前的会话
codex app	打开桌面应用

在会话里用：

命令	作用
/init	生成 AGENTS.md 项目说明文件
/status	查看当前会话的配置
/permissions	设置允许 Codex 自动执行哪些操作
/model	选择模型和推理强度
/review	审查改动并列出问题

权限设置

/permissions 决定 Codex 能否不经确认就修改文件、运行命令。新手建议保持需要确认的设置，逐条查看命令再允许，尤其是删除文件、安装软件这类操作。

8. 常用技巧与提示词示例

• 写清验收标准：例如“完成后运行 npm test，全部通过才算完成”。

• 把长期规则写进 AGENTS.md，不必每次重复。

• 复杂任务先问方案：

  我想给这个博客加上文章搜索功能。请给出两三种实现方案，
  比较优缺点，先不要写代码。

• 调试时给完整信息：粘贴完整报错和复现步骤，比“它坏了”有效得多。

• 推理强度按需选：简单改动用较低的推理强度更快，复杂问题再调高（用 /model 切换）。

更多实战做法见 用 AI 读懂和修改已有项目代码。

9. 和同类工具怎么选

对比	怎么选
Codex vs Claude Code	两者定位相近。已有 ChatGPT 账号先试 Codex；Claude Code 不含于 Claude 免费版，而 Codex 在 ChatGPT 免费版中也可使用（额度以官网为准）
Codex vs Cursor	Cursor 是完整的图形编辑器；Codex 以终端为主，也提供编辑器扩展和桌面应用
Codex vs GitHub Copilot	Copilot 擅长编辑器补全并与 GitHub 深度集成；整块任务交给 Codex 更直接

总体对照见 AI 编程工具入门。

10. 常见问题

问题	处理
安装脚本或 npm 安装超时	终端程序通常不读取系统代理，见 浏览器能访问，为什么应用程序连接失败
浏览器授权成功，终端一直等待	同上，开启代理客户端 TUN 模式后重开终端再试，见 代理客户端 TUN 模式怎么开
使用中提示请求失败、连接断开	按 AI 工具报错或无法访问怎么排查 检查
提示额度用完	等待额度重置，或升级方案、改用 API 密钥；换任务时开新会话以节省额度
Windows 上运行异常	官方文档为 Windows 提供了单独的说明（含 WSL 用法），以官网为准

Codex 的可用性以服务方公布的支持地区为准，请遵守 OpenAI 的使用条款。

相关阅读

• AI 编程工具入门：开始使用前需要准备什么
• Claude Code 入门教程：安装、登录与第一个任务
• 用 AI 读懂和修改已有项目代码
• AI 工具报错或无法访问怎么排查
• ChatGPT、Claude 和 Gemini 怎么选？按任务进行比较