核心功能详解

01自动化 Automation

自动化就是让 Codex 不只是"听你指挥"，而是能按规则定期帮你巡查项目、发现问题、处理问题。给它配好规则后，它可以在你离开时继续工作，回来直接看结果。

可以这样理解：给项目请了一个"AI 值班工程师"——平时不打扰你，有问题来提醒你，简单问题它先尝试修，最后让你审核决定。常见场景：资讯简报、竞品监控、定期巡检、日报周报、会话复盘。

自动化的几种触发方式

示例：让 Codex 每周自动复盘你的会话

下面这条提示词来自原书，能让 Codex 定期检查你最近的会话记录与执行日志，沉淀成一份可复用的工作流档案，越用越顺手：

请检索并复盘最近一周的 Codex 会话记录与执行日志，维护一份
"Codex 会话复盘与个人风格档案"。
要求：
1. 优先使用可用的会话历史检索能力；如需读取日志，只做搜索、元数据
   提取和相关片段抽取，不要整文件载入大型 session 文件。
2. 不要复现原始日志、隐私内容、密钥、内部 reasoning 或长对话原文。
3. 总结执行经验：哪些做法导致了问题，最终正确做法是什么，适合什么
   场景复用。
4. 总结我的偏好：UI 设计偏好、产品理念、交互原则、内容系统偏好和
   工作流偏好。
5. 整理可复用规则清单：把复盘结论改写成后续 Codex 会话可以遵循的
   简洁规则。
6. 更新文档时去重、合并相近规则，保留日期范围或任务类型作为来源线索。
7. 如有适合长期复用的规则，请建议是否加入项目级或用户级 AGENTS.md。

02插件 Plugin：能力安装包

Codex 本身已经能读代码、改代码、运行命令；插件是在这个基础上，让它连接更多工具、使用固定流程，或获得某些专项能力。比如 Gmail 插件可总结邮件、草拟回复；Chrome 插件可操作浏览器、检查页面。

插件生态全景（按领域分组）

Codex 插件覆盖从开发到办公、从浏览器到创意生产的全链路。下面列出代表性插件与"它能帮你做成什么"，先有全局地图，后面再深入安装与实战。

插件能做什么（常见类型）

在 Codex App 里安装插件

1. 打开 Codex App；
2. 搜索或浏览插件；
3. 点开插件详情；
4. 点击 Add to Codex 或添加按钮；
5. 安装完成后，新开一个 thread 再使用。

在 Codex CLI 里安装插件

进入项目目录后先启动 Codex：

cd 项目目录
codex

进入 Codex CLI 后输入 /plugins，打开插件列表后你可以：

常见插件与能力方向

十个高频插件一览

插件实战速览：以 HyperFrames 为例

插件到底怎么把"非开发任务"变成一句话？以 HyperFrames 为例：它属于"视频创意"类插件，用 HTML / CSS / JS 就能生成动画视频（同类还有用 React 的 Remotion）。你只要把一本书或一段内容丢给它，它就会自动调用该插件生成视频，并在完成后返回本地文件地址，点击即可查看。

完整步骤、提示词与迭代技巧见 P05 · R1-4 HyperFrames 案例。GitHub / Figma / Notion 插件的同类实战分别见 P05 的 R3（GitHub）/ R2（Figma、Notion）。

高价值插件实战 · GitHub / Figma / Notion

① GitHub 插件 · 让 Codex 直接在你的仓库里干活

授权后 Codex 能读 Issue、列 PR、做 Code Review，甚至按 Issue 直接开分支改代码，把"需求 → 代码 → PR"一条龙交给它。

更多 GitHub 实战（DKFile、远程修 Bug、GitHub Actions）见 P05 · R3。

② Figma 插件 · 设计稿直接变前端代码

连接 Figma 后，Codex 能读取画板、提取设计变量（颜色 / 字号 / 间距）并生成可运行的前端组件，最适合"照着设计图写页面"。

完整 Figma 案例见 P05 · R2。

③ Notion 插件 · 把文档库变成可操作的工作台

授权后 Codex 能读写 Notion 页面与数据库，可自动整理会议纪要、生成周报、把对话结论回填到知识库。

完整 Notion 案例见 P05 · R2。

插件实战库 · 10 个高价值插件（可直接照做）

连接 Slack 工作区后，Codex 能读频道历史、总结讨论、起草回复，甚至按对话里冒出的需求直接建任务。

授权后 Codex 能读邮件、总结未读、草拟回复、按邮件内容建任务或写文档。

连接 Jira 后，Codex 能读需求、按 ticket 开分支改代码、更新状态，把"需求 → 代码"打通。

授权后 Codex 能读 Drive 里的文档、把产出直接写成 Google Doc，省去复制粘贴。

Neon 是无服务器 Postgres。授权后 Codex 能连库、写并运行 SQL、做数据查询和表迁移。

Supabase 是开源 BaaS。授权后 Codex 能建表、写 RLS 安全策略、生成 API 和 Edge Function。

Stripe 插件能查账单、订阅、对账。涉及资金与不可逆操作，必须设 never 全自动禁用。

Rovo 能跨 Jira、Confluence、Drive 等做企业级语义搜索与问答，让 Codex 站在公司知识上回答。

CircleCI 插件能看构建状态、读失败日志、重跑流水线，甚至按失败原因改代码再提 PR。

授权后 Codex 能读你的 Zap、按自然语言改触发条件和动作，把跨应用重复流程自动化。

03Skill：把稳定流程沉淀成能力

Skill 就是给 Codex 准备的一套"固定工作方法"。它本身会读代码、改代码、运行命令；但如果你经常让它做同一类任务（写 README、做代码 Review、生成网页、整理文档），就可以把这套流程做成 Skill，以后一句话触发，不用每次重新解释规则。

Skill 由什么组成

Skill 和普通提示词有什么区别

Skill 适合什么时候用

一个 Skill 通常包含什么

一个最简单的 SKILL.md

# README 生成 Skill
## 适用场景
这个 Skill 适合用来为项目自动生成 README。
## 工作目标
Codex 最终交付一份结构完整、命令可用的 README.md。
## 工作流程
1. 阅读项目结构
2. 判断项目类型
3. 生成安装、启动、使用说明
4. 不编造不存在的命令，不确定的信息要标注
## 输出格式
使用 Markdown 格式。
## 注意事项
不要编造不存在的功能；不确定的地方要明确标注。

三种添加 Skill 的方式

方式一：使用已有 Skill

进入项目目录启动 codex 后，输入 /skills 打开列表；也可以直接输入 $ 快速选择，或在任务里点名使用：

方式二：用 $skill-creator 创建（最推荐）

$skill-creator 相当于一个 Skill 创建助手，会问你几个问题，把一套重复流程整理成 Skill 文件。

它会问你的关键问题：这个 Skill 是做什么的（明确用途）、什么时候触发（适用场景）、要不要包含脚本（是否指令型）、输出格式是什么（保证稳定）、有哪些限制（避免乱改乱编）。

$skill-creator
请帮我创建一个 README Skill。
作用：根据当前项目自动生成适合小白阅读的 README。
触发场景：当我说"生成 README""写项目说明""整理项目文档"
"写安装教程"时使用。
工作流程：
1. 先阅读项目结构
2. 查看 package.json、README、入口文件
3. 判断项目类型
4. 生成项目简介
5. 写安装步骤
6. 写启动命令
7. 说明主要文件夹作用
8. 补充常见问题
9. 不确定的地方不要编造
输出格式：使用 Markdown，必须包含：项目简介、功能特点、安装步骤、
启动命令、文件结构、常见问题、后续优化方向。
注意事项：不要编造不存在的功能；不要读取或输出 API Key、密码、
token、私钥。

方式三：手动创建 SKILL.md 文件

Skill 本质上是一个文件夹，里面必须有一个 SKILL.md。最简结构：

.agents
└── skills
    └── readme-skill
        └── SKILL.md

也可以放脚本、参考资料和资源文件：

.agents
└── skills
    └── readme-skill
        ├── SKILL.md
        ├── scripts
        ├── references
        └── assets

带 frontmatter 的最简 SKILL.md（description 写清楚，Codex 才能自动判断何时调用）：

---
name: readme-skill
description: 当用户需要生成 README、项目说明、安装教程、启动步骤时使用。
---
你是一个 README 文档生成助手。
任务：根据当前项目生成一份适合新手阅读的 README。
工作流程：
1. 阅读项目结构
2. 查看 package.json、README、入口文件
3. 判断项目类型
4. 生成项目介绍
5. 写安装步骤
6. 写启动命令
7. 说明文件结构
8. 补充常见问题
9. 不确定的地方不要编造
输出格式：使用 Markdown，必须包含：项目简介、功能特点、安装步骤、
启动命令、文件结构、常见问题、后续优化方向。

Skill 放在哪里更合适

推荐安装的社区 Skill

新手必装的 9 个 Skill（社区高频清单）

很多新手"裸装" Codex 后觉得不好用，其实差的就是几个常用 Skill。下面 9 个是社区里出现频率最高、覆盖写作 / 设计 / 科研 / 数据的"即装即用"清单，按场景挑着装即可：

04MCP：连接外部工具的接口

MCP（Model Context Protocol）让 Codex 连接外部工具与数据源，把公司系统、数据库、第三方 API 接进工程流，扩展它的工作边界。可以理解为：

Codex = 一个会干活的人；MCP = 给他接上不同工具的插座；MCP Server = 插在插座上的工具箱；Tool = 工具箱里的具体工具。

核心概念

MCP 适合做什么

常见 MCP Server 类型

在 Codex App 里使用 MCP

添加 MCP 时通常需要填：Name（名字）、Command / URL（启动命令或服务地址）、Type（本地命令型或远程 HTTP 型）、Env（放 token、配置项）、Auth（是否需要登录）、Enabled tools（只打开需要的功能）。

添加完回到 thread，直接描述任务即可，例如：

请使用可用的 MCP 文档工具，查询 Next.js App Router 的最新用法，
然后告诉我当前项目应该怎么修改。

在 Codex CLI 里使用 MCP

常用 MCP 终端命令

添加 MCP 的基本格式与示例

# 基本格式：codex mcp add 名称 -- 启动命令
codex mcp add context7 -- npx -y @upstash/context7-mcp

这条命令的意思是：给 Codex 添加一个叫 context7 的 MCP，它通过 npx 启动 @upstash/context7-mcp 这个工具。添加后运行 codex mcp list 确认已写入；进入项目目录启动 codex 后输入 /mcp 查看当前会话可用的工具。

MCP 配置文件在哪里

Codex 的 MCP 配置会写进 ~/.codex/config.toml，里面会有类似这样的配置：

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

如果你不熟悉配置文件，前期不要手动乱改，优先使用 codex mcp add / list / remove 这些命令。

远程 MCP 与清理

有些 MCP 不是本地命令启动，而是通过网址连接（远程 / HTTP MCP），可能需要 URL、Auth、Token、OAuth。需要登录时用 codex mcp login MCP名称，不用了用 codex mcp logout MCP名称。删除某个 MCP：

codex mcp remove context7
codex mcp list   # 确认已不在列表

05插件 / Skill / MCP 三者关系速记与选型

插件、Skill、MCP 是本篇最容易混淆的三个概念。它们不是互相替代，而是各管一层。下面这张总表请先记住，前几节已经分别展开，这里做一次合订。

选型决策：到底用哪个

06代码管理：Git 与 GitHub

用 Codex 做真实项目时，一定要懂一点 Git 和 GitHub。一句话：Git 负责记录代码变化，GitHub 负责远程保存和协作，Codex 负责帮你完成具体编程任务。

Git 与 GitHub 的区别

小白必须先懂的 Git 概念

小白必须先懂的 GitHub 概念

为什么用 Codex 更需要 Git

在 Codex 中使用 Git 的 10 步

1. 初始化 Git（让项目开始被 Git 管理）；
2. 写好 .gitignore（防止上传垃圾文件和密钥）；
3. 先 commit 一次（保存干净版本）；
4. 新建分支（给 Codex 一个安全实验区）；
5. 让 Codex 修改代码（完成具体任务）；
6. 查看 diff（检查 Codex 改了什么）；
7. 运行项目 / 构建（确认没出错）；
8. 满意后 commit（保存这次修改）；
9. push 到 GitHub（上传远程仓库）；
10. 创建 PR（合并前再检查一次）。

你可以直接在 Codex 对话框里输入：把项目初始化成一个 Git 工程，并排除不需要的文件，Codex 会帮你直接写好 .gitignore。

标准上传 GitHub 流程

1. 在 GitHub 新建仓库（创建一个远程项目空间）；
2. 复制仓库地址（后面要连接本地项目）；
3. 将地址复制给 Codex（让 Codex 知道要上传到哪个仓库）；
4. 推送到 GitHub（正式上传代码）。

代码回滚

先让 Codex 修改代码 → 提交到 Git 保存好当前版本 → 继续修改 → 打开 IDE 查看代码、复制版本号 → 把版本号复制给 Codex，让它回退代码到指定版本。这样即使改坏了也能随时回到干净状态。

Git Worktree：给项目开一个独立副本

普通 Git 分支虽然可以切换，但每次只能在一个文件夹里操作一个分支。Worktree 相当于一个草稿本：给同一个 Git 项目额外开一个独立工作副本，效果满意后再合并回正式项目。

使用流程：创建 Worktree → 使用分支进行任务 → 检查效果满意后，合并回主干并删除该分支。

07云端运行

云端运行本质上是把任务放到云端环境执行，不占用本地电脑。把代码任务交给 Codex，让它在云端环境里自己跑——适合你不在电脑前、长时间、批量的任务。

云端运行是什么

云端 vs 本地

08记忆系统：AGENTS.md

AGENTS.md 是写给 Codex 看的项目 / 全局规则文件，是它的"长期记忆"和上下文基础设施。分两级：

# AGENTS.md
## 项目说明
一个宠物零食品牌官网。
## 技术栈
- React
- Vite
## 风格约定
- 按钮、卡片、标题、留白要统一
- 移动端要基本可用
## 禁止事项
- 不要删除已有核心功能
- 不要随意新增大型依赖
- 不要直接改动和当前任务无关的文件

一份可直接照抄的完整模板

# AGENTS.md

## 项目概览
- 项目类型：
- 主要语言：
- 关键目录：
- 不要修改的目录：

## 常用命令
- 安装依赖：
- 本地开发：
- 运行测试：
- 类型检查：
- 格式化：

## 代码规范
- 遵循现有代码风格。
- 不做无关重构。
- 新增功能必须补充或更新测试。

## 安全边界
- 不读取或提交 .env、密钥和私有凭据。
- 不执行删除生产数据的命令。
- 修改数据库迁移前先说明影响。

## 交付要求
- 说明改动文件。
- 说明验证命令和结果。
- 说明未验证项和剩余风险。

放在哪里、怎么被读取

读取顺序：先读全局，再从 Git 根目录逐层走到当前目录，每层尝试读取；同目录里 AGENTS.override.md 优先于 AGENTS.md；越靠近当前目录越具体。

三个相关文件怎么分工

08·b沙盒与审批：Codex 的安全护栏

Codex 能读文件、改文件、跑命令，所以必须有一套"围栏"。三个核心概念可以这样类比：

沙盒三模式

审批策略四档

开启 Auto-Review（智能门禁）

default_permissions = ":workspace"
approval_policy = "on-request"
approvals_reviewer = "auto_review"

沙盒内操作不经过 Auto-Review；越界请求先交 reviewer agent 判断，有风险会被拒绝。

网络权限边界

联网常见用途：npm install / pip install、查资料、调 GitHub API、测本地服务器。风险则包括提示词注入、数据外发（代码 / 密钥 / .env 泄露）、供应链风险。建议：非必要不给网络；优先用受控 web search；联网前让 Codex 说明目标域名与用途；永远不要把 .env / token / cookie / 私钥交给会联网的命令。

动手前先让它说明计划（谨慎提示词）

请在动手前先说明你计划运行的命令和可能影响的文件。不要读取 .env、密钥、
token、cookie 或任何私有凭据。不要执行删除数据、发布、部署或迁移命令，
除非我明确确认。

判断一次操作要不要谨慎，问自己三句：① 有无不可逆副作用？② 是否涉及敏感数据？③ 是否影响项目外？高风险操作（删目录、数据库迁移、改认证 / 支付、访问生产服务器、部署发布）先让 Codex 说明计划再放行。

新人最常误解的权限问题

一个常见误解是："我只给 Codex 打开了一个项目文件夹，所以它只能看到和改这个文件夹。"这两件事都不完全对。

08·cVS Code 插件：在编辑器里用 Codex

习惯在编辑器里工作的开发者，可以直接在 VS Code 中安装 Codex 插件（OpenAI 官方的 ChatGPT 插件），把对话与代码辅助嵌进编辑器。

1. 打开 VS Code → 左侧「扩展」→ 搜索 Codex → 选第一个结果 → 点「安装」；
2. 打开任意项目文件 → 右上角出现 ChatGPT 图标 → 点击展开右侧 Codex 对话窗口；
3. 直接输入需求；在对话框输入 @ 后选择具体文件，可让 Codex 精确定位文件，比全局搜索更快更准（任务目标明确时优先用 @）。

08·d移动端协同：手机跟进桌面任务

用手机端 ChatGPT App 可以扫码配对桌面 Codex，在手机上查看 / 管理桌面任务，并可选择性开启 Computer Use。适合桌面无人值守跑任务、你在外出时用手机查看进度。

连接前 6 项准备

连接步骤与授权三开关

1. Codex → 左侧「设置 Codex 移动版」→「开始设置」；
2. 选「安卓」→ 手机扫码 → 点「我已在桌面端登录」；
3. 连接建立后点「授权此设备」；
4. 可选开关：保持唤醒（建议开）、Computer Use（可操作电脑应用，敏感、新手先别开）、Chrome 扩展（涉及账号安全、谨慎开）。

09Sites 与 Annotations（2026 新增）

此外还有面向调试的 Browser Developer mode（受控访问 Chrome DevTools Protocol，检查网络 / 控制台 / 运行时错误，使用前需你显式批准），以及 /init 一键生成项目说明、迁移导入其他 coding agent 配置等改进。

10演示即生成 Skill：Record & Replay（26.616+）

OpenAI 在桌面端 26.616 起上线了 Record & Replay（录制与回放）：你只要在电脑上把一套操作流程手动演示一遍，Codex 就会在后台记录每一步动作与决策节点，自动抽象成一个结构化的、可复用的 Skill。下次遇到同类任务，直接调用这个 Skill，不用再从头描述需求。