AI 使用教程

1. 先搞清楚 App 里的三个概念

2. 第一次打开 Codex App，这样开始

1. 打开项目

   点“Open folder”，或用 Cmd + O 选择你要处理的代码目录。一个仓库里有多个子项目时，尽量只打开当前要改的那一层。

2. 新建线程

   用 Cmd + N 开一个新线程。一个线程只放一个清晰任务，比如“修登录失败”或“重做教程页”。

3. 选择工作方式

   小修小补用 Local；想试一个大改动用 Worktree；想并行跑任务再考虑 Cloud。刚开始建议用 Local 或 Worktree。

4. 发出任务

   把目标、相关文件、限制、验收标准一次说清楚。任务越像交给同事的 brief，Codex 越容易做对。

3. 按真实任务来写提示词

不要只写“帮我弄一下”。直接告诉 Codex 你要完成什么成果、素材在哪里、格式要求是什么、完成后怎么检查。下面这些模板可以直接套。

目标：根据这份资料做一个 10 页演示文稿。
素材：读取 docs/方案说明.md 和 data/案例.xlsx。
要求：第一页是标题页，最后一页是行动建议；风格简洁商务。
完成标准：生成 pptx，检查每页标题清楚、图表可读、没有溢出文字。

目标：把这份销售表整理成可看的月度报表。
素材：读取 sales.xlsx。
要求：清洗空值，按月份和渠道汇总，增加图表和总览页。
完成标准：输出新的 xlsx，并说明收入最高渠道、异常数据和计算方法。

目标：用浏览器打开后台页面，帮我检查订单筛选是否正常。
网页：http://localhost:3000/orders
要求：测试搜索、筛选、翻页和空状态。
完成标准：告诉我哪里有问题；如果需要改代码，改完后再用浏览器复测。

目标：用 Computer Use 打开桌面 App，复现设置页保存失败的问题。
范围：只操作这个 App，不碰其它窗口。
要求：记录复现步骤，找到原因并修复。
完成标准：同一条 UI 流程重新跑一遍，确认保存后刷新仍然生效。

4. 三个 App 里最常用的指令

在输入框里打 / 可以打开指令列表。下面三个最常用：

• /plan：复杂或不确定的任务先规划，确认方向后再动手。
• /goal：长任务用 Goal 模式，让 Codex 围绕一个目标持续推进。
• /review：改完后让 Codex 审查当前 diff，找风险和遗漏。

5. 改代码时看这几个地方

• Diff 面板：打开后能看到 Codex 改了哪些文件，可以按文件、按片段审查，也可以留言让它继续改。
• 内置终端：用来跑项目、测试、lint、git status。Codex 也能读取终端输出继续排查。
• 任务侧栏：看 Codex 的计划、来源、生成的文件和任务总结，方便中途纠偏。
• 内置浏览器：做前端时打开本地页面，直接看渲染效果，也可以在页面上留下视觉评论。

6. 几个好用快捷键

7. 使用习惯提醒

• 不确定会改很多文件时，用 Worktree，避免影响当前工作区。
• 看到权限提示时，优先批准最小范围；不确定就先让 Codex 解释为什么需要这个权限。
• 做前端页面时，让 Codex 同时跑浏览器验证，不要只靠代码想象。
• 长期重复的项目规则写进 AGENTS.md，比如测试命令、代码风格、不要动哪些文件。

1. 什么时候用 Chrome 插件

• 要操作你已经登录的网站，比如后台、CRM、Notion、GitHub、Gmail 或内部系统。
• 要读取真实页面状态，比如打开标签页、跳转页面、点击按钮、下载文件、上传文件、检查表单。
• 要复现“只在我的 Chrome 里出现”的问题，比如插件影响、缓存状态、账号权限或线上后台权限。
• 如果只是本地前端页面或公开网页，优先用 Codex App 的内置浏览器，速度更快、权限也更少。

2. 第一次使用前怎么准备

1. 安装插件能力

   在 Codex App 里打开 Plugins，添加 Chrome 插件能力，然后按提示安装 Codex Chrome 扩展。

2. 确认连接状态

   打开 Chrome 工具栏里的 Codex 扩展，确认它显示 Connected。没有连上时，先重启 Chrome 或重新打开 Codex App。

3. 打开目标网页

   用你平时使用的 Chrome 账号登录目标网站。需要登录态的任务，最好先自己确认页面已经能正常打开。

4. 新建任务线程

   在 Codex 里新开一个线程，任务里直接写 @Chrome，说明要让它操作 Chrome。

3. 这样写任务最清楚

Chrome 任务要写清楚网址、账号状态、允许做什么、不允许做什么，以及最终要给你什么结果。

目标：用 @Chrome 打开我已经登录的后台，检查最近 20 个订单是否有异常。
范围：只读取订单列表和订单详情，不改数据、不提交表单。
要求：把异常订单、异常原因、页面线索整理成表格。
完成标准：给出结论；如果需要修改网站代码，先说明原因再动手。

4. 权限和安全边界

• 第一次访问某个网站时，Codex 会询问是否允许当前线程操作这个网站。只给当前任务需要的网站权限。
• Chrome 历史记录可能包含敏感信息，除非任务必须用到，否则不要让 Codex 读取浏览历史。
• 涉及付款、密码、隐私资料、删除数据这类动作时，自己盯着流程，必要时让 Codex 只停在确认页。
• 如果任务要处理本地文件上传，需要在 Chrome 扩展详情页允许访问文件 URL。

5. 出问题先查这几项

1. 什么时候用 Computer Use

• 要操作桌面 App，比如 Keynote、PowerPoint、Excel、Numbers、设计工具、配置工具或公司内部客户端。
• 要复现一个 GUI 问题，比如按钮点了没反应、设置保存失败、窗口状态异常。
• 任务横跨多个应用，比如从网页下载文件，再导入表格软件，最后导出成新的文件。
• 没有合适的插件或命令行入口，只能像人一样在界面上点、拖、输入。

2. 开始前准备

1. 安装 Computer Use

   在 Codex App 里打开 Computer Use 或 Plugins，按提示安装 Computer Use 能力。

2. 授予系统权限

   macOS 需要给 Codex 屏幕录制和辅助功能权限；Windows 使用时要让目标应用保持在前台。

3. 清理桌面环境

   关掉不相关窗口，隐藏含有密码、付款、隐私资料的页面，只留下这次任务需要的 App。

4. 限制操作范围

   在任务里明确告诉 Codex 可以操作哪些 App、哪些文件夹、哪些动作必须先问你。

3. 适合直接复制的任务写法

Computer Use 的提示词要像给一个远程协助同事下任务：目标、范围、文件、禁区和验收标准都写清楚。

目标：用 @Computer 打开 Numbers，把这份 CSV 整理成月度报表。
范围：只操作 Numbers 和下载目录里的这份文件。
要求：清洗空值、增加汇总表、生成一张趋势图。
完成标准：保存文件，告诉我保存路径，并说明你检查了哪些内容。

目标：用 @Computer 打开这个桌面 App，复现设置页保存失败。
范围：只操作目标 App，不打开其它窗口。
要求：记录每一步点击和看到的提示。
完成标准：找到原因后修复；同一流程重新跑一遍，确认保存成功。

4. 权限和安全边界

• Codex 请求操作某个 App 时，只允许这次任务真正需要的 App。
• Computer Use 能看到被授权应用的窗口内容，任务开始前先关掉敏感页面。
• 密码、付款、删除数据、系统级授权这类动作，最好由你自己完成或让 Codex 停在确认前。
• 如果看到它走偏，直接接管鼠标键盘，或在 Codex 里让它暂停并重新说明边界。

5. 和内置浏览器、Chrome 插件怎么选