核心功能：云端运行与记忆系统

一句话结论

Codex Cloud 让任务在云端并行执行，AGENTS.md 是项目的长期记忆——两者结合让 Codex 越用越懂你的项目。

云端运行

Codex 的云端任务适合在你不方便一直开着本地电脑时继续处理工作；如果你的账号和客户端支持移动端入口，也可以在外出时查看或推进部分任务。
[code]
把代码任务交给 Codex，让它在云端环境里自己跑。
[/code]

小白可以这样理解：

模式	运行位置	简单来说
Local	你的电脑本地项目	Codex 直接改你电脑里的代码
Worktree	你的电脑本地副本	Codex 在安全副本里改代码
Cloud	OpenAI 云端环境	Codex 在云端拉取 GitHub 仓库并处理任务

Codex 云端运行是什么

Codex 云端运行，本质上是：

内容	说明
运行环境	云端容器
代码来源	GitHub 仓库
工作方式	Codex 在云端读取、修改、运行、验证代码
最终结果	生成修改结果、diff，必要时创建 PR
适合任务	修 bug、改功能、写文档、代码 review、处理 issue
不适合任务	本地私密文件、没有上传 GitHub 的项目、高风险生产操作

---

云端运行和本地运行的区别

对比	本地运行 Local / Worktree	云端运行 Cloud
代码位置	你电脑里	GitHub 仓库
运行位置	你的电脑	云端容器
是否占用电脑	会占用	基本不占用
是否需要 GitHub	不一定	通常需要
是否适合后台任务	一般	很适合
是否适合并行任务	一般	很适合
权限风险	主要是本机文件权限	主要是仓库、环境变量、网络权限
适合新手吗	更适合先学	学会 GitHub 后再用

云端运行操作步骤

推送代码到GitHub上面

打开Codex Web

选择我们要修改的仓库

选择好过后直接让Codex给我们工作就行了

修改完成后上传到 GitHub 仓库

本地修改前先同步 GitHub 仓库里的最新代码

如果云端任务已经把修改推回 GitHub，本地继续开发前要先同步最新代码，避免在旧版本上继续修改导致冲突。具体是 Codex 自动帮你应用变更，还是你手动 git pull / codex apply，取决于当前入口和任务类型。

记忆系统

让 Codex 记住一些长期有用的信息，方便以后继续工作。

项目级AGENTS.md

[code]
写给 Codex 看的项目规则说明书。
[/code]

小白可以这样理解：

文件	主要读者	作用
README.md	人	告诉人这个项目是什么、怎么安装、怎么使用
AGENTS.md	Codex / AI Agent	告诉 AI 在这个项目里应该怎么工作
.gitignore	Git	告诉 Git 哪些文件不要上传

AGENTS.md 放在哪里

放置位置	作用范围	简单来说
项目根目录 AGENTS.md	整个项目	当前项目的总规则
子目录里的 AGENTS.md	当前子目录及相关任务	某个模块的专属规则
用户级 ~/.codex/AGENTS.md	你所有项目	个人通用规则
项目级 AGENTS.md + 用户级 AGENTS.md	叠加生效	个人习惯 + 当前项目规则

如何写 AGENTS.md

可以直接交给AI来写，让AI总结这个项目的核心内容制作成 AGENTS.md

前端项目 AGENTS.md 模板

[code]
# AGENTS.md

## 项目说明

这是一个前端网页项目，用于构建产品页面、工具页面或个人作品展示页面。

## 技术栈

- React
- Vite
- Tailwind CSS
- JavaScript / TypeScript

## 常用命令

- 安装依赖：`npm install`
- 启动项目：`npm run dev`
- 构建项目：`npm run build`

## 项目结构

- `src/`：主要源代码
- `src/components/`：通用组件
- `src/pages/`：页面文件
- `src/assets/`：图片、图标等静态资源
- `public/`：公开静态文件

## 代码规范

- 优先使用 React 函数组件
- 优先使用 Tailwind CSS 写样式
- 不要引入 Bootstrap
- 不要大范围重构无关代码
- 修改时保持文件结构清晰
- 中文文案要自然、简洁、适合普通用户阅读

## UI 规则

- 页面要有清晰的信息层级
- 按钮、卡片、标题、留白要统一
- 移动端要基本可用
- 不要过度渐变、阴影和 AI 模板感
- 优先做真实产品感，而不是 Demo 感

## 禁止事项

- 不要修改 `.env`、`.env.local`
- 不要输出 API Key、token、密码
- 不要删除已有核心功能
- 不要随意新增大型依赖
- 不要直接改动和当前任务无关的文件

## 完成任务后

每次修改完成后，请输出：

1. 修改了哪些文件
2. 每个文件改了什么
3. 为什么这样改
4. 是否需要运行 `npm run build`
5. 提醒我检查 diff

[/code]

好的 AGENTS.md 有什么特点

特点	说明
具体	写清楚技术栈、命令、目录
简洁	不要写成长篇废话
可执行	Codex 看了知道怎么做
有限制	明确哪些文件不能碰
有验证	写清楚运行什么命令检查
有完成标准	让 Codex 知道交付什么
可维护	项目变化后及时更新

全局级AGENTS.md

打开Codex的设置，找到个性化

输入指令，这里的指令会作为你的个人通用偏好影响后续 Codex 会话

使用AI编程的时候最怕AI乱删东西，可以用以下指令

禁止批量删除文件或目录。

不要使用：

• del /s
• rd /s
• rmdir /s
• Remove-Item -Recurse
• rm -rf

需要删除文件时，只能一次删除一个明确路径的文件。

正确示例：
[code]
Remove-Item "C:\path\to\file.txt"
[/code]

如果需要批量删除文件，应停止操作，并向用户请求，让用户手动删除。