OpenAI Codex App 使用手册

摘要

OpenAI Developers 从 4 月 1 日以来的帖子，核心结论很清楚：Codex 正在从“写代码工具”扩展为“跨电脑、跨工具、跨时间的工作代理”。

理解它的关键，不是记住每一次发布时间，而是看它正在补齐哪些工作能力。

阅读前先统一几个术语：Plugins 指连接外部工具和信息源的插件；

Skills 指可复用的工作流程或团队标准；

MCP 是让模型接入外部工具和数据源的协议；

PR 是代码合并请求；

CI/CD 是自动化测试、构建和部署流程；

Hooks 是在关键动作前后自动触发的检查、记录或限制机制。

总览：Codex 的 8 个能力层

上下文捕捉层：让 Codex 看见你正在看的东西。

工具连接层：让 Codex 进入真实工具，而不是靠你复制粘贴。

流程知识层：让 Codex 按你的团队方法做事。

执行闭环层：让 Codex 能自己验证、迭代、完成。

长期任务层：让 Codex 跨小时、跨天持续推进。

多代理协同层：让多个 agent 同时处理多个任务。

团队治理层：让组织能共享、观察、限制和审计 Codex。

输出扩展层：让 Codex 产出不止代码，还包括文档、表格、幻灯片、图片、视频和可视化。

主题 1：上下文捕捉，让 Codex 少问你“背景是什么”

这个主题的目标是降低上下文搬运成本。过去你需要截图、复制报错、描述页面状态、粘贴文档片段；现在 Codex 开始主动从窗口、浏览器、文件和桌面 app 里拿上下文。

关键能力

Appshots：Mac 上按 Command-Command，把当前 app window 附到 Codex thread。Codex 同时获得截图和窗口文本，包括屏幕外未显示的文本。

In-app browser：在 Codex 内打开本地页面或 web app，查看、点击、截图、标注并反馈给 agent。

Computer Use：让 Codex 在授权范围内看、点、输入，处理 GUI-only 场景。

文件预览：在侧栏打开 PDF、表格、幻灯片、文档，减少来回切换。

适合场景

前端页面、设计稿、报错弹窗、设置页、邮件、文档、控制台窗口。

只能在 GUI 中复现的问题。

需要让 Codex 理解“我眼前这一屏”的任务。

可直接使用的提示

主题 2：工具连接，把插件当成 Codex 的“手和眼”

插件的价值不是“多一个入口”，而是让 Codex 能直接读取和操作工作流里的真实系统。

插件解决什么

你不用把 Slack、Gmail、Google Drive、Figma、CI 日志、数据库状态复制到 thread。

Codex 可以在工具之间建立上下文：issue、代码、设计稿、CI、PR、部署和文档能被串起来。

插件可与 skills 组合，形成可复用工作流。

高价值插件方向

信息源：Google Drive、Gmail、Slack、Notion。

代码协作：GitHub、GitLab Issues、Linear、JIRA、CodeRabbit。

CI/CD：CircleCI，用于读取 pipeline context、定位失败、验证修复。

设计和可视化：Figma，把 implementation plan 转为 FigJam board、架构图、ERD、notes、code blocks。

后端和数据：Supabase、Neon，让 Codex 跨 database、auth、storage、edge functions 工作。

部署和运行时：Render 等部署插件。

视频和动态内容：Remotion，用 prompt 或 code 创建、修改视频、动画、图表、字幕和 motion graphics。

插件使用原则

任务里有外部系统时，优先问：“有没有插件能直接接进去？”

需要精确调用某个插件时，用 @插件名。

如果只是描述目标，也可以让 Codex 自动选择已安装插件。

示例：

主题 3：Skills，把“怎么做”沉淀为流程资产

OpenAI Academy 对 plugins 和 skills 的区分很清楚：

Plugin：Codex 需要访问外部工具或信息源。

Skill：Codex 需要遵循特定流程、格式、风格或团队标准。

Plugin + Skill：既要拿外部信息，又要按固定方法产出。

适合做成 skill 的内容

周报、日报、复盘、客户 brief。

PR review 标准。

发布前检查清单。

竞品分析结构。

设计评审格式。

团队代码规范、文档语气、命名约定。

常见故障排查路径。

判断标准

如果你已经连续 3 次对 Codex 解释同一套流程，就该把它写成 skill。

示例

主题 4：执行闭环，让 Codex 不只是“给建议”

Codex 的更新一直在强化“自己验证自己”的能力：浏览器测试、截图、CI、文件预览、Computer Use、PR review、多个 terminal tabs，都是为了从“生成方案”走向“执行到结果成立”。

可形成闭环的任务

修 bug：复现 -> 修改 -> 测试 -> 再复现 -> 截图或日志证明。

前端：打开页面 -> 标注问题 -> 修改样式 -> 多 viewport 验证。

CI：读取失败日志 -> 分类根因 -> 修复 -> 重新跑检查。

文档/表格/幻灯片：生成 -> 预览 -> 迭代 -> 达到可分享状态。

好的完成条件

坏的完成条件：

主题 5：长期任务，从回合制聊天变成持续推进

长期任务相关能力包括 /goal、Automations、mobile preview、locked Computer Use、memory。

/goal

/goal 适合给 Codex 一个明确 milestone。它会持续工作到达成为止，可跨小时或天运行；你可以 check in、steer、pause。一个实用技巧是开 side chat 理解当前进展，不打断主任务。

Automations

Automations 适合周期性或需要醒来继续的工作：

每天扫 issue 和 PR。

定时跟进 Slack、Gmail、Notion 里的项目变化。

持续监控 CI、部署或安全提示。

在已有 thread 里继续长期任务，保留上下文。

Mobile Codex

手机端不是“远程桌面”，而是让你在路上也能：

查看 agent 进度。

批准命令。

回答澄清问题。

改变方向。

看截图、diff、测试结果。

Locked Computer Use

Codex 可以在 Mac 锁屏时继续使用被授权的 app。适合远程推进，但权限边界要谨慎，尤其是涉及账户、凭证、支付和敏感数据时。

主题 6：多代理协同，重点不是开更多窗口，而是降低注意力成本

OpenAI 关于 Symphony 的信息非常关键：他们发现人类通常只能舒服地管理 3-5 个 Codex session，再多就会被上下文切换拖垮。Symphony 的思路是把 Linear 这类 issue tracker 变成 agent 控制台。

Symphony 的模式

它改变的是管理方式：

人不再逐个盯 session。

issue tracker 变成状态机。

agent 持续运行，崩了或卡住可以重启。

人类主要负责定义任务、设置护栏、review 结果。

适合团队试点的任务

小型 bugfix。

依赖升级。

测试补齐。

文档更新。

CI 修复。

低风险 refactor。

前提

issue 必须拆得清楚。

repo 要有自动化测试。

需要明确 review 和权限边界。

先从低风险队列开始，不要一开始就让 agent 接管核心架构决策。

主题 7：团队治理，从个人神器到组织系统

当 Codex 进入团队，问题会从“能不能做”变成“能不能管”。

关键能力

Shared plugins：Business 用户可在团队间共享 custom plugins，Enterprise 可申请 early access。

Analytics：查看 active users、credits、tokens、runs、user leaderboards、lines of code generated、plugin usage，并通过 Analytics API 接入内部看板。

Hooks：扫描 prompts 中的 secrets、运行 validators、记录对话、创建 memories、按目录或 repo 定制行为。

Remote SSH：进入受控 devbox 或远程环境，让依赖、凭证、安全策略集中管理。

Programmatic access tokens：Business/Enterprise 可用于 CI、release workflows、内部自动化。

Approvals 和安全策略：敏感动作、外部服务、文件修改和命令执行都需要有清晰审批策略。

团队落地建议

先统一插件和 skills。

再定义哪些任务可以自动执行，哪些必须审批。

用 Analytics 看使用情况和成本。

用 Hooks 和权限策略控制敏感数据。

最后再引入 Symphony 这类多 agent 编排。

主题 8：输出扩展，Codex 不只交付代码

OpenAI Devs 的帖子里反复出现“docs、sheets、slides、images、videos”。这说明 Codex 的边界正在扩展到软件工作周边的产物。

输出类型

代码和 PR。

技术方案、实施计划、review notes。

表格和数据分析。

幻灯片和文档。

图片、mockup、游戏素材。

视频、动画、字幕、动态图表。

FigJam 架构图、ERD、可视化笔记。

对开发者的意义

很多“支持代码交付的工作”也可以交给 Codex：写说明、准备演示、整理会议信息、生成测试报告、做发布 readout、把实现计划转成图。

如何选择能力：任务分流表

任务特征	优先使用
需要看当前窗口、报错、设计稿	Appshots
需要点击网页或验证 UI	In-app browser
只能通过桌面 GUI 操作	Computer Use
信息在 Slack/Gmail/Drive/Figma/CI/DB	Plugins
需要固定格式或团队流程	Skills
需要持续工作到明确目标完成	`/goal`
需要定期检查或稍后继续	Automations
团队有大量 issue 可并行处理	Symphony
需要组织级复用和管理	Shared plugins、Analytics、Hooks