Codex 完全指南：你的 AI 编程助手可能只发挥了一半

早上 9 点，你同时有三件事要干：重构 utils 模块、写测试用例、整理文档。

如果是一个人干，至少要一下午。

但如果你用的是 Codex，这些事可以同时跑。

第一章：Codex 是什么？

一句话：Codex = ChatGPT + 能读写你电脑文件的 AI + 能帮你执行命令的助手。

它不是什么魔法，就是一个能帮你干活的工具：

改代码、跑命令、操作网页
多任务并行，互不干扰
定时任务，自动执行
手机远程审批

它解决什么问题？

第二章：Codex 五件套地图

Codex 在 2026 年已经是完整的五件套生态：

快速决策树：

你是什么情况？
├─ 我只是想试试 → Cloud（浏览器打开即用）
├─ 我日常写代码，想提高效率 → IDE 扩展
├─ 我经常处理多任务 → 桌面 App
├─ 我是命令行爱好者 → CLI
└─ 我需要离开工位也能审批 → 桌面 App（macOS） + Mobile

第三章：5 分钟快速上手

第一步：安装

npm install -g @openai/codex

要求：Node.js 18+，推荐 22+ （LTS）。

装完验证：

codex --version

第二步：登录

codex

首次运行会弹出浏览器，登录 ChatGPT 账号授权。

第三步：试一个任务

试试这些任务（选一个）：

"在当前目录创建 hello.txt，写入'Hello Codex'"
"检查 src 目录下所有 .js 文件，列出未使用的 import"
"给 README.md 添加项目简介"

完成后你会体验到：

文件自动创建/修改
命令自动执行
与 AI 的自然对话流

现在你已经掌握了 60% 的核心功能。

第四章：Codex 桌面 App

4.1 它是什么

Codex 桌面 App 是一个独立的应用程序，不是 CLI 的图形外壳。

界面布局：

左侧：项目侧栏（最近项目、活跃 threads）
中间：会话区（提示词 + 回复 + diff 预览）
右侧：终端输出和文件树

下载方式：

macOS：openai.com/codex/download
Windows：Microsoft Store（2026-03-04 上线）
Linux：暂无官方版本，使用 CLI

4.2 平台功能对比

4.3 核心功能详解

并行 Worktree

每个新 thread 自动创建 Git worktree，任务之间互不干扰。

真实场景：

Thread A：重构 utils/format.js
Thread B：为重构后的函数写单元测试
Thread C：更新 README 中的 API 文档

三个任务同时跑，互不打架。完成后勾选想要的合并。

如何操作：

桌面 App 打开项目
点击 "New Thread" 创建新对话
输入任务，Codex 自动创建 worktree
完成后在右侧查看 diff，勾选要合并的文件
点击 "Merge Selected" 合并到主分支

Automations

定时任务自动执行，结果放入审查队列。

真实场景：

每天 9:00 → npm audit + 输出到 security-audit.md
每周一 9:00 → 汇总上周 commit → 周报草稿
每月 1 号 → 清理长期未用的 feature 分支

如何配置：

桌面 App 点击 "Automations" 标签
点击 "New Automation"
设置任务名称、执行内容、时间表
保存后自动执行，结果在队列中查看

Computer Use（macOS 独占）

能让 Codex 看屏幕、动鼠标、敲键盘，操控 Mac 上别的应用。

真实场景：

打开 Finder 找昨天下载的 PDF
打开 Safari 登录 Web 控制台改配置
运行原生 App，复现 GUI bug

Windows 替代方案：用应用内 Browser Use 操作网页。

Appshots（macOS 独占）

双击Commonds捕获当前窗口

锁定运行（macOS 独占）

锁屏后继续干活

第五章：Codex CLI

安装方式（三种）

方式一：npm（推荐）

npm install -g @openai/codex

方式二：Homebrew（macOS/Linux）

brew install --cask codex

方式三：二进制文件
访问 developers.openai.com/codex/cli 下载

验证安装

codex --version

核心能力

CLI vs 桌面 App

第六章：Codex Mobile

6.1 它解决了什么问题

真实场景：

你在咖啡馆，手机收到 Codex 推送："任务需要批准删除旧表"。打开 ChatGPT App，切到 Codex 标签，看到 SQL 语句，确认没问题，点批准。五秒后任务继续跑。

核心价值：把审批从工位上解耦，随时随地掌控任务。

6.2 它是什么 / 不是什么

是：ChatGPT 手机 App（iOS/Android）里的 Codex 标签，远程控制台。

不是：独立 App、手机 IDE、P2P 直连（走 OpenAI relay）。

6.3 谁能用

6.4 核心功能

功能一：审批待办
Codex 遇到 sandbox 边界发推送，手机端批准/拒绝/改提示。

功能二：看 diff
色块高亮显示文件变更，看完批准 commit。

功能三：看 terminal
实时同步命令输出，任务失败直接看错误。

功能四：看截图
任务里要求"截个图"，截图推到手机。

功能五：起新任务
手机直接发起任务，桌面执行。

配对步骤（macOS）：

Mac 桌面 App 打开 "Set up Codex mobile"
手机 ChatGPT App → Codex 标签 → "Connect Device"
扫描二维码
确认配对

第七章：IDE 扩展与 Cloud

IDE 扩展

支持：VS Code、Cursor、Windsurf

安装：扩展市场搜索 "Codex"，登录 ChatGPT 账号。

JetBrains：Codex 内嵌在 JetBrains AI Assistant 里（2025.3+），在 AI Chat 的 agent 菜单选择。

适合场景：写代码时顺带问一句，不切窗口。

Codex Cloud

访问 chatgpt.com/codex

特点：零安装、浏览器打开、OpenAI 沙箱环境、并行多任务

限制：无文件系统直接访问、无命令执行、无 Computer Use、无 Automations

第八章：关键配置

配置文件位置

~/.codex/config.toml（所有组件共用）

模型配置（最新）

# 模型选择（2026-05）
model = "gpt-5.4"  # 默认，适合大多数任务
# model = "gpt-5.5"  # 最新前沿模型，复杂任务
# model = "codex-1"  # 软件工程优化，测试驱动

模型说明：

GPT-5.4：2026-03-05 发布，旗舰编码模型，原生 computer use
GPT-5.5：最新前沿模型，复杂编码、知识工作、研究工作流
Codex-1：基于 o3 优化，强化学习训练，更像人类代码风格

审批策略

approval_mode = "auto"   # 简单操作自动，危险操作确认
# approval_mode = "manual"  # 全部手动确认
# approval_mode = "smart"   # 智能判断

沙箱级别

sandbox_level = "strict"  # 严格模式，写文件需确认
# sandbox_level = "permissive"  # 读自动，写确认
# sandbox_level = "dangerous"  # 几乎全自动（不推荐）

MCP 服务器（可选）

[[mcp_servers]]
name = "filesystem"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/your/project/path"]

配置生效：CLI 重启终端 / 桌面 App 重启 / IDE 刷新窗口

第九章：与 Claude Code 配合使用

双开理念

推荐工作流：

规划 → Claude Code（想清楚）
执行 → Codex（去干）
审查 → Claude Code（检查）

同任务对比

任务：拆分 utils/format.ts

CLI：输入"拆分文件" → 快速完成

桌面 App：开 worktree → 可视化 diff → 选择合并

差异：CLI 快，桌面 App 清晰。

第十章：实战案例

案例 1：同时干三件事

场景：utils/format.js 500 行，要拆分 + 写测试 + 更新文档

操作：桌面 App 开三个 thread，同时跑。完成后勾选想要的合并。

节省：2 小时 → 20 分钟

案例 2：自动化部署

场景：每次推送后自动测试 + 部署

配置：Automation 设置 "after git push" 触发，运行 npm test && vercel --prod

节省：每次 15 分钟 → 自动化

案例 3：网页数据抓取

场景：每天 9 点抓取网站数据

操作：Automation 设置每天 9 点，Codex 用 Browser Use 打开网页、提取数据、保存 CSV

节省：每天 10 分钟 → 自动化

案例 4：通勤审批

场景：地铁上收到推送，任务需要批准删除旧表

操作：手机打开 → 看 SQL → 批准 → 继续

节省：任务不卡住，回家直接看结果

案例 5：睡前长任务

场景：睡前丢一个"跑全量测试 + 生成 coverage"

操作：Codex 跑两小时，中间装依赖发推送，床上批准

节省：早上起床看报告，直接开工

第十一章：常见问题

Q：Windows 能用 Codex 吗？

能用。CLI 全功能，桌面 App 2026-03-04 已上线，IDE 扩展支持。Computer Use 和 Mobile 配对暂不支持。

Q：Computer Use 很重要吗？

看你需求。主要在终端/编辑器工作 → 影响小。需要操控原生 App → macOS 是唯一选择。

Q：和 Cursor 区别？

Cursor 内置了 Codex，用 Cursor 不需要额外装扩展。

Q：Linux 怎么办？

用 CLI，功能完整。桌面 App 和 Mobile 暂不支持。

第十二章：下一步行动

立即开始

npm install -g @openai/codex
codex

参考资料

官方文档

Codex Models - 最新模型 GPT-5.4/GPT-5.5
Codex 官网
Codex 桌面 App 介绍 - Windows 版 2026-03-04 上线
Codex App - Windows
Codex CLI
Codex 配置
Codex Mobile - Mac 已支持，Windows coming soon
Microsoft Store - Codex - Windows 官方版本

Claude Code

Claude Code 官网
Claude Code 文档
Claude Code Scheduled Tasks

第三方资源

WAYTOAGI 社区

第一章：Codex 是什么？

第二章：Codex 五件套地图

第三章：5 分钟快速上手

第一步：安装

第二步：登录

第三步：试一个任务

第四章：Codex 桌面 App

4.1 它是什么

4.2 平台功能对比

4.3 核心功能详解

并行 Worktree

Automations

Computer Use（macOS 独占）

第五章：Codex CLI

安装方式（三种）

验证安装

核心能力

CLI vs 桌面 App

第六章：Codex Mobile

6.1 它解决了什么问题

6.2 它是什么 / 不是什么

6.3 谁能用

6.4 核心功能

第七章：IDE 扩展与 Cloud

IDE 扩展

Codex Cloud

第八章：关键配置

配置文件位置

模型配置（最新）

审批策略

沙箱级别

MCP 服务器（可选）

第九章：与 Claude Code 配合使用

双开理念

同任务对比

第十章：实战案例

案例 1：同时干三件事

案例 2：自动化部署

案例 3：网页数据抓取

案例 4：通勤审批

案例 5：睡前长任务

第十一章：常见问题

第十二章：下一步行动

立即开始

推荐路径

参考资料

官方文档

Claude Code

第三方资源