Codex 从入门到精通：OpenAI 官方 AI 编程智能体完全教程

夏文强2026-07-21 10:46

Codex 从入门到精通：OpenAI 官方 AI 编程智能体完全教程

一、Codex 是什么？

OpenAI Codex 是 OpenAI 于 2025 年推出的 AI 编程智能体（Coding Agent） ，到 2026 年已成为开发者圈最炙手可热的生产力工具之一。它和我们熟悉的 ChatGPT 有着本质区别 ------ Codex 不是"聊天机器人"，而是能直接在你本地环境中动手干活的编程搭档。

核心能力

能力 说明
读懂项目 自动分析整个代码库结构，理解技术栈、目录职责和项目入口
跨文件编辑 同时修改多个文件，保持代码风格一致
执行命令 在隔离沙箱中运行终端命令、安装依赖、启动服务、跑测试
闭环验证 写完代码后自动运行测试、修复报错，直到通过
操作应用 操控浏览器、桌面应用，甚至移动鼠标点击操作

和 ChatGPT / GitHub Copilot 的区别

ChatGPT GitHub Copilot Codex
定位 对话式顾问 IDE 内联补全 全栈编程代理
工作方式 一问一答 写一句补一句 读项目 → 改代码 → 跑命令 → 验证
能干啥 给建议、写代码片段 补全当前行/函数 独立完成多步骤开发任务
操作文件 不能 不能 能直接读写你的本地项目文件

一句话：ChatGPT 是给你建议的军师，Copilot 是帮你敲字的手，Codex 是能独立干活的人。

二、四种使用入口

Codex 提供四种使用方式，覆盖不同工作场景：

入口 适用环境 适合谁 典型场景
桌面 App macOS / Windows 新手首选，不想碰终端的人 可视化管理项目、查看改动、拖拽操作
CLI 命令行 终端（需 Node.js 22+） 熟悉命令行的开发者 快速派活、脚本自动化、远程服务器
IDE 插件 VS Code / JetBrains 日常在编辑器写代码的人 边看代码边让 Codex 修改、解释、补测试
Cloud 云端 浏览器访问 想让任务在云端跑的人 长任务、并行任务、GitHub PR 联动

建议：新手从桌面 App 或 VS Code 插件入手，建立手感后再探索 CLI 和 Cloud。

三、安装与快速上手

3.1 桌面 App 安装

  1. 访问 OpenAI 官方入口：openai.com/codex
  2. 下载对应系统的安装包（支持 macOS 和 Windows）
  3. 按提示完成安装
  4. 使用 ChatGPT / OpenAI 账号登录
  5. macOS 如提示「无法验证开发者」→「系统设置 → 隐私与安全性」→「仍要打开」

3.2 CLI 安装

bash 复制代码 
# 方式一：npm 全局安装（需要 Node.js 22+）
npm install -g @openai/codex

# 方式二：macOS Homebrew
brew install --cask codex

# 启动
codex

首次启动会自动弹出浏览器完成 ChatGPT 账号登录。

3.3 账号与套餐

Codex 覆盖 ChatGPT 全系列套餐：Free / Go / Plus / Pro / Team / Edu / Enterprise。

  • Free / Go：额度非常有限，仅适合体验
  • Plus（$20/月） ：日常开发使用比较充裕，推荐起步套餐
  • Pro（$200/月）：重度用户，几乎无限制使用

3.4 三步安全习惯（必读！）

在开始使用之前，养成这三个习惯可以避免很多麻烦：

复制代码 
① 先让它只读分析 →  打开项目后先说「请先阅读项目，不要修改任何文件」
② 干活前先 git 存档 →  git init + git commit，方便随时回滚
③ 提交前逐文件 review →  检查改了什么、有没有改到不该改的地方

四、界面与核心概念

4.1 工作区结构

  • 聊天（Chat）：适合一次性问答，不绑定文件夹，每个对话独立
  • 项目（Project） ：Codex 的主战场。选择一个本地文件夹作为工作目录，所有生成的文件自动保存其中。一个项目可以开多个对话，共享目录文件但记录隔离

4.2 三种权限模式

模式 说明 适用场景
默认权限 所有操作（读文件、改文件、执行命令、联网）都需要手动确认 新手入门
自动审查 低风险操作自动放行（改普通代码、加注释、跑测试），高风险操作弹框确认 日常开发推荐
完全访问 AI 全权代理，无确认无拦截，直接执行所有操作 高度信任的个人练习项目

4.3 计划模式

在对话框中开启「计划模式」后，AI 先规划方案再动手------帮你理清需求、确认细节、制定分步计划，确认无误后才开始写代码。

每个稍复杂的任务都推荐先用计划模式。

4.4 使用情况查看

  • 左下角「设置」→「剩余额度」：查看 5 小时内剩余配额、本周剩余比例
  • 或输入 /status 命令查看

五、必做的基础配置

5.1 建立独立项目根目录

复制代码 
~/codex-projects/
  ├── my-web-app/
  ├── data-pipeline/
  └── cli-tool/

不要把项目放在桌面、下载目录或个人知识库里，避免 Codex 生成的文件污染其他目录。

5.2 配置 AGENTS.md（记忆系统）

这是 Codex 的**"开发手册"**，每次对话启动时自动读取。分为两级：

  • 全局级 ：~/.codex/AGENTS.md 或 设置 → 个性化 → 自定义指令（所有项目生效）
  • 项目级 ：项目根目录的 AGENTS.md（仅当前项目生效）

推荐模板：

markdown 复制代码 
# AGENTS.md

## 项目概览
- 项目类型：Web 应用
- 主要语言：TypeScript / Python
- 关键目录：src/ docs/ tests/

## 常用命令
- 安装依赖：npm install
- 本地开发：npm run dev
- 运行测试：npm test

## 代码规范
- 遵循现有代码风格，不做无关重构
- 新增功能必须补充测试
- 使用项目已有的工具库，不引入新的第三方依赖

## 安全边界
- 不读取或提交 .env、密钥和私有凭据
- 修改数据库迁移前先说明影响范围

## 交付要求
- 列出所有修改的文件
- 说明验证命令和结果

六、核心功能详解

6.1 文件与项目操作

Codex 可以直接操作本地文件系统：

  • 读取和分析项目中的所有源代码文件
  • 跨多文件修改代码，保持风格一致
  • 执行终端命令（安装依赖、构建、测试、部署）
  • 管理 Git 版本（暂存、提交、推送、创建 PR）

6.2 插件系统

进入左侧「插件」面板，按需安装：

插件 用途
Chrome 操控已登录的 Chrome 浏览器（保留登录态，可操作网页）
Computer Use 操控整个电脑桌面（看屏幕、移动鼠标、点击、打字）
Spreadsheets 处理 Excel 表格、数据分析
Presentations 制作 PPT 演示文稿
Netlify / GitHub 部署网站、管理代码仓库
Browser Use 内置浏览器预览网页、批注修改 UI

使用方式：对话中输入 @插件名 调用，如 @Chrome 帮我打开 GitHub 看看最近的 issues。

6.3 Skills 技能系统

Skills 是可复用的工作流说明书。Codex 内置了以下核心技能：

  • Image Gen：AI 图片生成
  • Skill Installer：安装社区共享的技能包
  • Skill Creator：把重复工作流封装成自定义技能

使用方式：输入 $技能名 调用，如 $image-gen 生成一张产品架构图。

6.4 MCP 协议

MCP（Model Context Protocol） 让 Codex 连接外部工具和数据源。在设置 → MCP 服务器中配置，可以连接：

  • 数据库（查询、建表、迁移）
  • GitHub Issues / Linear / Jira（任务管理）
  • Slack / 钉钉（消息通知）
  • 自定义 API 服务

6.5 定时自动化

在「自动化」面板可创建定时任务，例如：

  • 每日早上 9 点自动搜集行业热点并生成简报
  • 每小时扫描下载文件夹，自动分类整理
  • 每周五生成项目周报

6.6 代码审查与 Git 管理

Codex 用 Git 管理所有代码改动：

  • 侧边栏「审核」面板查看每个文件的变更内容
  • 逐块应用或撤销修改
  • 从暂存、提交、推送到创建 PR，不离开 App 完成全流程

6.7 Computer Use（桌面操控）

允许 AI 查看你的屏幕、移动鼠标、点击操作任何桌面应用：

  • 适合操作没有 API 的遗留系统
  • 可自动化 UI 测试
  • 注意：消耗 tokens 大，能用终端/浏览器完成的任务尽量不用它

6.8 手机远程操控

电脑端 Codex 扫码连接 ChatGPT 手机 App，即可：

  • 用手机远程下达开发任务
  • 审批 Codex 的高风险操作
  • 随时查看任务进度

七、进阶用法

7.1 VS Code 集成

  1. 在 VS Code 插件市场搜索 OpenAI Codex 并安装
  2. 登录 ChatGPT 账号完成认证
  3. 在编辑器内选中代码 → 右键 → Codex：解释代码 / 修复问题 / 生成测试
  4. 侧边栏可以打开 Codex 对话面板，上下文自动包含当前文件和项目

7.2 CLI 常用命令

bash 复制代码 
codex                              # 启动交互会话
codex resume --last               # 恢复上次会话
codex "修复这个 bug"               # 一句话派活，非交互模式

# 会话内命令
/model                             # 切换模型
/permissions                       # 调整权限模式
/status                            # 查看状态和额度
/review                            # 让另一个 Agent 审查代码
/compress                          # 压缩上下文（长对话时使用）

7.3 连接本地 LLM

Codex 支持通过 OpenAI Responses API 连接本地模型（如 Qwen、DeepSeek）：

  1. 使用 Unsloth Studio 或 llama.cpp 启动本地模型服务
  2. 编辑 ~/.codex/config.toml 配置 provider
  3. 通过 codex --oss --profile local_profile 启动

八、实战场景与提示词模板

场景一：分析陌生项目

复制代码 
请你作为资深架构师，帮我分析这个项目：
1. 技术栈是什么？用了哪些关键依赖？
2. 各目录的职责是什么？
3. 项目入口和核心调用链路在哪？
4. 如果要新增一个功能模块，应该改哪些文件？按照什么模式写？

场景二：排查报错

复制代码 
我在运行时遇到以下报错，帮我分析：
【粘贴报错信息】

请按以下步骤输出：
1. 报错的根本原因是什么
2. 问题出在哪个文件的哪一行
3. 给出修改后的代码
4. 为什么会这样修改

场景三：实现新功能

复制代码 
帮我在当前项目中新增一个 REST API 接口：

需求：用户上传头像图片，服务端校验格式和大小（<2MB），存储到本地 uploads/ 目录，数据库记录路径，返回可访问的 URL。

要求：
- 先分析项目现有的路由、中间件和数据库操作方式
- 按照现有代码风格实现
- 补充对应的单元测试
- 完成后运行测试验证

场景四：重构优化

复制代码 
帮我重构 src/services/user.js 这个文件：
- 保持功能和接口不变
- 提取重复代码为公共函数
- 把超过 50 行的函数拆分成小函数
- 添加必要的错误处理
- 不要改动其他文件

黄金法则

复制代码 
① 先分析 → ② 给方案 → ③ 确认 → ④ 再改代码

不要一上来就让 AI 大范围修改项目！

九、2026 年技术指标

指标 数据
驱动模型 GPT-5.5、o4-mini、o3、GPT-4.1 等
上下文窗口 约 258K tokens（有效使用）
Terminal-Bench 2.0 77.3%，同类工具领先
支持语言 Python、JS/TS、Go、Rust、Ruby、Java 等
沙箱安全 macOS Apple Seatbelt + Linux Landlock + seccomp（业界唯一 OS 级沙箱）
平台覆盖 macOS、Windows、Linux、VS Code、JetBrains、Web、移动端

十、常见问题 FAQ

Q：Codex 和 GitHub Copilot 有什么区别？

Copilot 在 IDE 中做内联代码补全 （你写一行它补一行）；Codex 是基于任务的智能体，在隔离沙箱中自主执行多步骤编程任务（读项目 → 改代码 → 跑测试 → 提 PR）。两者互补，可以同时使用。

Q：Codex 和 Claude Code 有什么区别？

Codex（OpenAI）有 OS 级安全沙箱、多入口（App/CLI/IDE/Cloud）、丰富的插件和技能生态。Claude Code（Anthropic）终端体验很强、代码理解深入。两者都是顶级的 AI 编程智能体，选哪个主要看生态偏好。

Q：免费套餐能用吗？

Free 套餐可以有限度体验，但额度非常受限。建议至少使用 **Plus 会员（20/月）**，日常开发比较从容。Pro（200/月）适合重度用户。

Q：数据安全吗？

Codex 是目前唯一在操作系统级别做沙箱的 AI 编程智能体（macOS Apple Seatbelt + Linux Landlock + seccomp）。企业版支持私有部署，数据不出企业内网。

Q：上下文太长怎么办？

  • 使用 /compress 命令压缩对话上下文
  • 大项目拆分多个小任务，每个任务开新对话
  • 在 AGENTS.md 中写明项目关键信息，减少重复描述

十一、新手自检清单

以下清单帮你确认是否已掌握 Codex 的核心用法：

  • 从 OpenAI 官方入口安装 Codex（拒绝第三方安装包）
  • 清楚四种入口的核心区别（桌面 App / CLI / IDE 插件 / Cloud）
  • 建立了独立的项目根目录，每个项目单独建文件夹
  • 创建了 AGENTS.md 文件（全局 + 项目级）
  • 能分清 Plugin / Skill / MCP 各自是什么，不盲目安装
  • 仅授权 Codex 访问当前项目文件夹（不是整个硬盘）
  • 先用默认权限熟悉，再逐步放开到自动审查
  • 养成了「先分析 → 给方案 → 确认 → 改代码」的工作流
  • 大改前先 git commit 或新建分支
  • 每次改动后逐文件 review 变更内容

十二、总结与学习路线

Codex 代表了 AI 编程工具的一次重要进化：从"补全代码"进化为"执行任务"。它不只告诉你代码该怎么写，而是直接在你的项目里帮你写完、跑通、验证好。

推荐学习路线：

复制代码 
安装桌面 App → 登录 Plus 账号
    ↓
创建独立项目目录 → 配置 AGENTS.md
    ↓
默认权限 + 计划模式 → 分析项目（只读）
    ↓
跑通第一个简单任务（如"加个注释"）
    ↓
逐步尝试修改代码 → 生成测试 → 跑验证
    ↓
切换自动审查模式 → 日常开发使用
    ↓
探索插件（Chrome / Computer Use）
    ↓
安装 Skills → 创建自定义技能
    ↓
配置 MCP → 搭建定时自动化

一句话：Codex 不是帮你写代码的 AI，是帮你完成开发任务的 AI 搭档。从今天开始，让它替你干活。

本文基于 OpenAI Codex 2026 年最新版本编写，功能可能随版本更新有所调整，请以官方文档为准。

热门推荐
01GitHub 镜像站点022026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片03如何新建文件夹？ 电脑新建文件夹的4种方法04幻兽帕鲁 - 服务器管理员权限与 GM 命令完全指南05AI科技热点日报 | 2026年07月01日06国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）07AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路08【AI前线观察】2026年国产开源大模型全面横评：从 DeepSeek V4 到 Kimi K3，谁才是开发者的最优选择？092026 年 AI 大模型 & AI 编程工具实战全总结102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？