OpenAI Codex · 官方

One agent for
everywhere
you code

Codex is OpenAI's coding agent for software development.

OpenAI 官方对 Codex 的定义。一个代理，跑遍你写代码的所有地方——终端、IDE、桌面、云端。ChatGPT Plus / Pro / Business 等订阅均含 Codex。

开源 · Rust 编写 CLI / IDE / 桌面 / 云端 免授权可无人值守
01

在哪用 Codex

四个入口，各管各的场景
⌘

CLI 命令行 主力

在终端跑 codex。本机干活、写脚本、夜间无人值守自动化。

‹›

IDE 扩展

装进 VS Code / Cursor，边写边让它改，diff 看得清楚。

▢

桌面 App

图形界面 + 定时自动任务 + 待审收件箱。不想碰终端的人用。

☁

Cloud 云端

任务跑在 OpenAI 服务器，不占本机，关上电脑也在跑。

02

能拿它干什么

全部来自官方 use-cases（50+ 用例）
编程开发Production · Security

理解大型代码库

导航陌生项目，给出初学者友好的结构拆解。

改 bug / 修复

扫全库找 bug、提修复、跑测试、出 PR + diff。

重构 / 代码迁移

大规模重构、跑代码迁移、升级 API 集成。

审查 PR / 安全

按 checklist 审 PR，评估代码、修安全问题。

写测试 / 加 evals

覆盖边界条件，给 AI 应用加评测。

自动 bug triage

把日志分类、调试流程自动化成 skill。

前端 · 设计 · 部署Web · Game · Native

Figma 转代码

把 Figma 设计稿直接变成可用代码。

响应式前端

从设计稿和提示做响应式 UI、做 UI 微调。

部署 App / 网站

从代码到上线部署一个应用或网站。

浏览器游戏

快速做原型循环、UI 和玩法。

iOS / macOS App

搭 Mac app 壳、构建调试原生 app。

QA 你的 app

用 Computer Use 自动测试你的应用。

数据 · 分析 · 财务官方

清洗脏数据

拖入乱 CSV（混乱日期/重复行/货币串），写干净副本，原文件不动。

查询表格数据

对 CSV/表格/Google Sheet 提问，出浏览器可视化。

分析数据集出报告

清洗+合并+建模，打包成带图表/出处的成品。

现金流预测

对财务数据做现金流预测。

DCF 估值建模

建 DCF 估值模型、对比预算与实际。

生成 PPT

生成幻灯片 / slide deck。

生产力 · 协作（非编程）Productivity

管理收件箱

找重要邮件、用你的口吻写回复。

用 Computer Use 操作电脑

让它点击、打字、操作你的 Mac 应用。

从 Slack 起任务

在 Slack 里直接发起编码任务。

把反馈变行动

把用户反馈转化成可执行动作项。

新人 onboarding

协调新员工入职流程。

配一个 AI 队友

给团队配一个常驻的 codex 队友。

学习 · 研究 · 长任务官方

学新概念

派多个 subagent 拆论文/课程，产出带图表的 markdown 报告。

把工作流存成 skill

用 $skill-creator 把重复流程固化成可复用 skill。

跟随长期目标 /goal

给它一个持久目标，长时间自主推进。

03

官方真实示例 · 学新概念

原样提示词，派 subagent 拆论文出报告
I want to learn a new concept from this research paper: [paper path or URL]. Please run this as a subagent workflow: - Spawn one subagent to map the paper's problem, contribution, method, experiments, limitations. - Spawn one subagent to gather prerequisite context and explain background terms. - Spawn one subagent to inspect figures, tables, notation, claims to verify. - Wait for all subagents, reconcile disagreements, avoid overclaiming. Final output: - create `notes/[concept-name]-report.md` - include executive summary, glossary, walkthrough, concept map, diagrams, evidence table - use Markdown-native Mermaid diagrams; cite sections/pages/figures
04

三步上手

# 1. 安装（macOS / Linux），升级同此命令
npm i -g @openai/codex@latest

# 2. 登录（ChatGPT 账号，GPT-5.5 仅此路可用）
codex login

# 3. 验证
codex --version # 显示 0.141.0 即成功
05

命令速查

日常就这几条
codex "任务"交互式对话，边聊边改
codex exec "任务"非交互，跑完退出，给脚本/夜间用
codex exec --full-auto自动批准 + 可写文件（夜间任务常用）
codex resume --last接着上次会话继续（长任务接力）
codex review代码审查
/usage6月新看 token 用量（日/周/累计）
/init生成 AGENTS.md 项目规矩文件
/import6月新从 Claude Code 导入设置/聊天
06

审批与沙箱

两个旋钮：要不要问你 + 能碰多少文件

审批策略 -a

on-request 默认偏稳 · 推荐
on-failure 失败才问
never 从不问（无人值守）

沙箱模式 -s

read-only 只读不改
workspace-write 改工作区 · 常用
danger-full-access 无沙箱 · 仅容器

⚠ --dangerously-bypass-approvals-and-sandbox

跳过所有确认和沙箱。只在 Docker / CI 临时机用，别在日常 Mac 开——它能无确认地改/删你任何文件。放飞前先用 git worktree 隔离。

07

模型怎么选

官方默认：从 gpt-5.5 开始
GPT-5.5默认首选。复杂重构、长任务、多步研究（仅 ChatGPT 登录）
GPT-5.4工具编排、浏览器、桌面自动化（API key 也行，CI 主力）
GPT-5.4-mini子代理 / 批量 / 单文件审查（快一倍，省钱）
GPT-5.3-Codex-Spark亚秒级实时迭代（仅 Pro）
GPT-5.3-Codex6 月起淘汰，新项目别用
08

上手路径 · 给外贸老板

日常就两条命令：交互用 codex，自动用 codex exec --full-auto "任务"
每个项目放一个 AGENTS.md，把铁律（翻译禁免费小模型、表格用 Arial）写进去，它就不会乱来
放飞前先 git worktree 隔离，日常别开 --dangerously-bypass
复杂活默认 GPT-5.5，批量子任务用 5.4-mini 省钱
配 cst 任务系统，白天拆任务、晚上让 codex 跑几十小时不偏离