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
推荐路径
Day 1: 安装 CLI → 完成 3 个小任务(30 分钟)
Day 2: 桌面 App(macOS/Windows)→ 体验并行 worktree(1 小时)
Day 3: 配置 Automations → 自动化重复任务(2 小时)
Day 4: Mobile 配对(macOS)→ 体验远程审批(30 分钟)
Day 5: 与 Claude Code 配合 → 规划-执行-审查(1 小时)
参考资料
官方文档
-
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 社区