Codex App 保姆级全攻略知识点提取目录Codex App 是什么安装前准备Codex App 基础界面与任务管理沙箱与权限控制上下文、模型与额度管理AI 生图、截图与中途引导 Steer计划模式 Plan ModeCodex 与 IDE / Git / GitHub代码回滚对话分叉 Git 回退Git Worktree 并行开发Codex 云端运行环境项目记忆系统AGENTS.md 与全局指令插件与自动化Skills官方、第三方、自定义技能MCP给 Codex 接入外部工具Netlify 部署网站Computer Use让 Codex 操作电脑常用提示词模板易错点与最佳实践来源https://www.bilibili.com/video/BV1Kk9kBAEJv/?spm_id_from333.1387.homepage.video_card.clickvd_source00e2e992f9d24cfebca6324ea1662cd41. Codex App 是什么Codex App 是一个面向编程和自动化任务的 AI Agent 工具可以读取、修改、生成项目代码管理多个项目和多个任务调用浏览器进行测试调用 AI 生图能力生成图片素材使用 Git / GitHub 管理代码在本地或云端运行任务安装插件、Skills、MCP 扩展能力创建定时自动化任务在支持的系统上通过 Computer Use 操作电脑视频中强调Codex App 的能力已经变得非常全面是 Codex 多种产品形态中非常强的一种适合用来做项目开发、网页改造、自动化办公和 AI Agent 工作流。2. 安装前准备2.1 需要提前安装的软件在安装和使用 Codex App 前需要准备工具作用Git管理代码版本、提交、回滚、推送到 GitHubNode.js运行前端项目、安装依赖、启动开发服务器VS Code查看和手动修改代码GitHub 账号托管代码、同步云端任务、创建 PRChatGPT 账号登录 Codex App2.2 支持系统Codex App 支持WindowsmacOS视频中提到Windows 和 Mac 主要功能基本一致但Computer Use自动操作电脑能力目前需要在 Mac 上演示。2.3 登录与初始化首次进入 Codex App 后一般会经历选择 ChatGPT 账号登录选择希望 Codex 帮你处理的工作类型Codex 根据你的选择预装部分插件 / Skills选择主要使用场景例如编程或日常工作点击“设置沙盒”完成沙箱初始化3. Codex App 基础界面与任务管理3.1 三栏布局Codex App 是经典三栏布局区域功能左侧栏项目列表、任务列表、插件、自动化中间区域对话窗口与 Codex 交流右侧区域多功能区例如浏览器、代码预览、终端等3.2 项目与对话Codex 可以绑定本地文件夹作为项目点击进入项目选择“使用现有文件夹”选择项目文件夹输入任务需求Codex 会在该项目上下文中执行任务一个项目可以开启多个对话。多个项目也可以并行运行多个任务。3.3 新建对话快捷键系统快捷键WindowsCtrl NmacOSCommand N新建对话时可以选择归属于某个项目不归属于任何项目仅作为普通聊天3.4 任务状态任务列表中会显示不同状态状态含义转圈图标AI 正在运行绿色标签等待用户批准蓝色小点任务已完成如果 Codex 需要联网、下载依赖或执行高权限操作会向用户申请批准。3.5 搜索与归档左侧栏可以搜索近期对话WindowsCtrl GmacOSCommand G注意视频中提到该搜索功能主要搜索对话标题不一定能搜索对话全文。对话可以归档归档后会从左侧任务列表隐藏。如果需要恢复可以在设置里的“归档对话”中取消归档。4. 沙箱与权限控制4.1 Codex 沙箱是什么Codex 的权限系统围绕“沙箱”展开。可以理解为Codex 只能在被允许的项目文件夹内工作不能随意操作电脑上的其他文件。默认情况下Codex 可以读取和修改项目文件夹内的文件Codex 不能修改沙箱外的文件Codex 默认不能联网如果需要联网或操作沙箱外文件需要向用户申请权限4.2 Codex 和 Claude Code 沙箱的区别视频中提到工具沙箱特点Claude Code沙箱更像额外开启的保护层Codex App沙箱是整个权限系统的地基Codex 的沙箱不是靠模型“自觉遵守”而是通过操作系统级别机制限制 AI 的行为。4.3 提权 Escalate当 Codex 需要做超出沙箱权限的操作时会触发提权申请例如联网下载依赖访问项目文件夹外的文件执行可能影响系统的命令默认情况下这些操作需要人工审核。4.4 权限档位权限模式含义推荐程度默认模式修改沙箱内文件沙箱外和联网需审批可用自动审查低风险操作自动放行高风险操作人工确认推荐完全访问无视沙箱限制可执行电脑上的所有操作谨慎使用4.5 推荐设置一般建议开启自动审查模式原因大多数低风险操作不用频繁手动批准高风险操作仍然会提醒用户安全性和便利性比较平衡5. 上下文、模型与额度管理5.1 上下文使用量对话窗口右侧的圆圈显示当前上下文使用量。它表示当前对话历史占用了多少模型上下文空间。当上下文过长时Codex 会自动压缩历史对话。5.2 手动压缩上下文可以输入/选择“压缩”选项手动触发上下文压缩。压缩的作用删除或弱化不重要的历史信息降低 token 消耗让 AI 更专注当前任务5.3 最佳实践清空好于压缩视频中提到一个 AI Agent 使用经验清空上下文通常比压缩上下文更好。原因是历史对话过多会干扰 AI 注意力一个任务完成后新开对话可以让 AI 专注新任务复杂项目可以通过AGENTS.md提供项目背景而不是一直依赖旧对话5.4 模型选择Codex 可以选择不同模型和思考强度。一般建议简单任务用较快、较轻量模型复杂任务用更强模型和更高思考强度代码迁移 / 架构改造建议使用更强模型5.5 快速模式视频中提到快速模式可以提升推理速度但会消耗更多套餐额度。适用场景任务很急套餐额度充足对成本不太敏感5.6 额度查看在左下角设置里可以查看剩余额度。通常会有两个限制5 小时限额周限额任意一个限额达到上限Codex 都会暂时不能继续使用直到对应时间重置。6. AI 生图、截图与中途引导 Steer6.1 Codex 可以生成图片Codex 内置 AI 生图功能可以用于生成网页配图替换不合适的素材图生成店铺环境图生成地图风格图生成产品展示图示例任务为宠物洗护网站生成三张店内环境轮播图分别展示店内不同区域并保持装修风格一致。6.2 可以粘贴截图作为上下文可以直接复制截图然后在 Codex 对话框中粘贴WindowsCtrl VmacOSCommand V适合场景标注地图位置指出网页某个 UI 问题给 AI 看设计参考图给 AI 看错误截图6.3 Steer中途引导Steer的意思是“引导”或“打方向盘”。当 AI 正在执行任务但你发现它理解错了方向时不要让它继续错下去可以立刻中途引导。使用场景AI 用错实现方案AI 画图风格不对AI 修改方向偏离需求AI 没有调用你希望的工具示例你这张图不行不要用 SVG 生成应该调用 AI 绘图能力重新生成地图。6.4 排队与引导的区别模式含义排队新指令等当前任务执行完再处理引导 Steer中途接管让 AI 立刻调整方向推荐默认保持“排队”需要紧急纠正时再点击“引导”。快捷键Ctrl Enter7. 计划模式 Plan Mode7.1 计划模式是什么开启计划模式后Codex 不会马上动手修改代码而是先输出工作计划等待用户确认。适合复杂任务例如项目架构迁移多页面重构数据库接入部署流程复杂自动化工作流7.2 计划模式流程开启计划模式输入复杂任务需求Codex 先提出问题确认关键选择Codex 输出完整计划用户确认计划Codex 开始执行执行完成后测试和修复7.3 示例迁移到 Next.js任务示例把这个项目改造成 Next.js 框架。Codex 可能会询问使用 App Router 还是 Pages Router是否使用 TypeScript样式如何迁移是否需要构建和启动本地服务器验证7.4 内置浏览器测试Codex 可以启动内置浏览器打开本地开发服务器查看页面效果自动化测试让用户对页面元素添加批注根据批注修改 UI示例批注为什么这个星星是空心的请改成实心。Codex 可以根据批注定位元素并修改代码。8. Codex 与 IDE / Git / GitHub8.1 Codex 不是传统 IDECodex App 可以查看代码但不是完整代码编辑器。它更像是AI Agent 工作台 项目任务管理器 自动化执行器。如果要手动修改代码可以用 VS Code 或其他 IDE 打开项目。8.2 初始化 Git 项目在 Codex 中可以直接让 AI 完成 Git 初始化把这个项目初始化成一个 Git 工程注意排除掉不需要提交的文件。Codex 会创建.gitignore排除不需要提交的文件初始化 Git 仓库帮你完成第一次提交8.3.gitignore应该排除什么常见需要排除node_modules/ .env .env.local dist/ build/ .next/ .DS_Store尤其要注意密钥文件不能提交环境变量不能上传 GitHub依赖目录通常不提交构建产物通常不提交8.4 用 VS Code 打开项目初始化 Git 项目后Codex 右上角会出现 VS Code 按钮。点击后可以直接用 VS Code 打开当前项目。也可以在设置里配置默认 IDE。8.5 推送到 GitHub可以让 Codex 把本地项目推送到 GitHub。大致流程在 GitHub 创建新仓库复制仓库地址粘贴给 CodexCodex 绑定远端仓库Codex 提交并推送代码提示词示例请把当前项目提交到 GitHub。远端仓库地址是你的仓库地址9. 代码回滚对话分叉 Git 回退视频中介绍了一个非常实用的回滚组合Codex 对话分叉 Git 代码回退9.1 为什么需要两种回滚Codex 任务有两层结果层级回滚方式对话历史使用对话分叉 Fork代码文件使用 Git 回退到某次 commit只回滚对话不会自动回滚代码。只回滚代码对话里仍会保留不需要的历史。所以最好两者一起处理。9.2 对话分叉 Fork当你发现某次对话方向错了可以找到想保留的上一段对话位置点击分叉按钮选择派生到本地新对话会从该位置继续后面的错误对话被排除9.3 Git 回退代码流程在 VS Code 的 Source Control / Git Graph 中找到要回退到的 commit复制 commit hash回到 Codex让 Codex 将代码回退到该 commit提示词请把当前代码回退到这次提交的状态后面的改动不要保留 commit hash9.4 适合场景AI 改了以后效果更差想删除某次错误尝试想回到某个稳定版本想让对话历史和代码状态保持一致10. Git Worktree 并行开发10.1 Worktree 是什么Git Worktree 可以理解为基于 Git 创建一个新分支并把该分支代码完整放到另一个文件夹中。这样可以实现主项目文件夹继续保持稳定新任务在独立文件夹中开发多个任务并行执行不同分支互不干扰最后再合并回主干10.2 Codex 中创建 Worktree操作流程找到项目右键创建永久工作树 / Worktree给分支起名Codex 会复制出一个新的项目文件夹在新文件夹中执行任务10.3 示例两个任务并行开发任务一优化客户评价部分多写几个评价做成动画轮播效果。任务二优化门店信息部分让门店信息和地图上下排列不要左右排列把地图展示完整。两个任务分别放在两个 Worktree 中执行互不影响。10.4 合并回主干任务完成后对每个 Worktree 输入请把当前分支合并回主干。合并后可以移除临时 Worktree。10.5 适合场景多个功能并行开发多个 AI Agent 同时工作想试验不同方案不想污染主项目文件夹需要降低任务之间互相干扰11. Codex 云端运行环境11.1 云端运行前提使用 Codex 云端运行环境前需要本地项目已经提交 Git代码已经推送到 GitHubGitHub 上的代码和本地代码保持同步11.2 云端运行流程点击推送确保代码同步到 GitHub选择关联 Codex Web前往 Cloud选择对应 GitHub 仓库输入云端任务需求Codex 在云端拉取代码并执行任务创建 Pull Request在 GitHub 审核并合并本地再同步最新代码11.3 示例任务请把首页的期望到店日期默认值设置为明天早晨 09:30。Codex 云端会初始化云端运行环境从 GitHub 下载代码分析项目修改代码创建 PR11.4 本地同步云端改动云端 PR 合并后本地需要拉取最新代码。在 VS Code 中点击Sync Changes含义是把 GitHub 上的最新代码同步到本地。11.5 适合场景出门在外没有电脑用手机审批任务让云端环境替你跑代码修改通过 PR 审核 AI 改动不想占用本地电脑资源12. 项目记忆系统AGENTS.md 与全局指令12.1 为什么需要记忆系统每次新开对话AI 默认并不记得之前聊过什么项目背景是什么代码结构是什么用户偏好是什么项目规范是什么项目复杂后每次都重新解释会非常低效。12.2 项目级记忆AGENTS.md可以在项目根目录创建AGENTS.md这个文件可以作为 AI 每次对话必读的项目指南。它可以记录项目介绍技术栈目录结构开发规范用户偏好禁止事项测试命令部署命令常见问题12.3 示例内容# Project Guide ## 项目背景 这是一个宠物洗护店预约网站。 ## 技术栈 - Next.js - TypeScript - CSS Modules - Supabase ## 用户偏好 用户擅长 Python 和 Java但不熟悉 CSS。 如果涉及网页样式请用大白话解释。 ## 开发规则 - 修改代码前先说明计划 - 不要提交 .env 文件 - 修改后需要运行构建或启动本地服务验证12.4 让 Codex 自动生成AGENTS.md可以直接让 Codex 通读项目并生成请通读当前项目把你学到的项目知识整理到 AGENTS.md 文件里方便以后新对话自动读取。12.5 全局记忆全局AGENTS.mdCodex 也支持全局自定义指令对电脑上的所有项目生效。入口设置 → 个性化 → 自定义指令视频中提到全局指令会保存在用户目录下的 Codex 配置文件夹里。12.6 全局安全提示词示例禁止使用脚本批量删除文件或目录。 如果需要删除文件只能一个一个删除。 如果必须批量删除请停止操作让用户手动确认和执行。这个提示词可以降低 AI 误删大量文件的风险。12.7 实验性记忆Codex 还有实验性记忆功能可以从聊天中生成新记忆并带入新聊天。视频中没有深入展开建议谨慎开启并观察效果。13. 插件与自动化13.1 插件是什么插件是第三方服务为 Codex 编写的软件包可以把外部服务能力接入 Codex。例如GitHub 插件Gmail 插件Netlify 插件浏览器自动化Computer Use13.2 示例GitHub Gmail 插件视频中的任务流程安装 GitHub 插件安装 Gmail 插件授权 Gmail 账号让 Codex 查询 GitHub star 数量前十的项目让 Codex 用 Gmail 给自己发送摘要提示词示例请查看我 star 数量前十的 GitHub 开源项目并用我的 Gmail 账户发一封摘要邮件给我自己。13.3 自动化任务如果希望任务定期执行可以让 Codex 创建自动化。示例很好请把上述工作做成一个自动化任务每周五下午四点发邮件给我。自动化中可以设置重复频率每周 / 每天 / 每小时执行时间使用模型是否立即运行测试13.4 Memory.md视频中提到Codex 在自动化执行过程中如果积累了经验可能会写入类似memory.md的文件帮助下一次自动化执行。这适合让自动化任务越跑越稳定。13.5 自动化适合做什么每周汇总 GitHub 项目数据每天生成工作日报定时检查网页信息自动打开网站签到读取看板并生成进度摘要自动发送邮件或消息14. Skills官方、第三方、自定义技能14.1 Skills 是什么Skills 可以理解为给 AI Agent 使用的专业技能包或者带目录的说明书。它可以把某种工作流、规范或专业能力封装起来让 AI 在执行特定任务时更稳定。14.2 Skills 的作用固化工作流程降低重复提示词成本提高输出稳定性让 AI 学会某个工具的最佳实践让团队共享统一规范14.3 三种 Skills 来源类型说明官方 SkillsCodex 插件 / 技能市场提供第三方 SkillsGitHub 等社区提供自定义 Skills自己用 Skill Creator 创建14.4 官方 Skill 示例RemotionRemotion 是一个用编程方式创建动画视频的工具。示例任务帮我生成一个 3D 圆锥摆的视频动画需要有受力分析角速度随时间缓慢增大。Codex 调用 Remotion Skill 后可以生成动画项目视频预览网页版剪辑工具可播放的动画演示14.5 第三方 Skill 示例网页 PPT视频中演示了从 GitHub 下载第三方 Skill用来生成电子杂志风格的网页 PPT。安装思路从 GitHub 下载 Skill 压缩包解压 Skill 文件夹在项目中创建.codex/skills/把 Skill 放入该目录回到 Codex 项目中用/唤起该 Skill示例任务请根据以下材料生成一份网页 PPT。 粘贴材料14.6 自定义 Skill视频字幕转 Markdown视频中最重要的自定义 Skill 案例当提供视频和字幕文件时自动转换成图文并茂的 Markdown 教程。工作流设计读取字幕文件自动添加标点划分段落转成 Markdown 笔记在适合插图的位置添加截图占位符调用 ffmpeg 从视频中截取关键画面用本地图片替换 Markdown 中的截图占位符14.7 创建自定义 Skill 的提示词请创建一个 Skill。 当我提供视频和字幕文件时 1. 读取字幕文件转换成 Markdown 笔记 2. 自动添加标点划分段落 3. 如果某一句涉及代码讲解、UI 交互或者借助视觉材料更容易理解就在这句末尾添加截图标记 4. 第一步完成后调用 ffmpeg 在每个截图提示位置进行截图 5. 用本地图片替换 Markdown 里的截图占位符 6. 最终输出一份图文并茂的 Markdown 教程。14.8 测试自定义 Skill测试流程新开一个对话输入/调用自定义 Skill在项目文件夹里准备视频和字幕告诉 Codex我已经准备好了字幕和视频请帮我转换。Codex 根据 Skill 流程生成 Markdown 文件15. MCP给 Codex 接入外部工具15.1 MCP 是什么MCP 全称Model Context Protocol中文可以理解为模型上下文协议。简单来说MCP 是大模型的标准化工具箱让 AI 可以通过统一协议连接外部服务、获取信息并执行操作。15.2 Codex 中添加 MCP入口设置 → MCP 服务器 → 添加服务器常见配置项包括服务器名称传输方式URL授权方式15.3 示例接入 Supabase MCPSupabase 是一个开源的云端数据库服务。接入流程在 Supabase 创建项目点击 Connect找到 MCP Client选择 Codex复制 MCP URL回到 Codex 添加 MCP 服务器选择流式 HTTP 传输方式粘贴 URL保存在终端执行登录授权命令授权后重启 Codex15.4 示例任务创建预约业务表提示词请使用 Supabase MCP 创建一个预约业务表。 我的需求是把用户提交的预约表单存入预约业务表。 数据库写入操作应该从后端用 Supabase / Postgres 的方式写入。Codex 可以完成创建数据库表添加后端接口使用连接池写入数据修改前端表单提交逻辑提醒用户配置环境变量15.5 环境变量配置常见需要配置DATABASE_URL你的数据库连接地址注意不要提交.env或.env.local连接地址里的密码要替换成自己的真实密码环境变量修改后通常需要重启开发服务器16. Netlify 部署网站16.1 Netlify 是什么Netlify 是一个网站部署平台可以部署静态网页Node.js 项目Next.js 项目前端应用16.2 使用流程在 Codex 插件市场安装 Netlify 插件用 GitHub 登录 Netlify授权让 Codex 部署项目Codex 返回公网可访问域名打开域名测试网站16.3 提示词示例请帮我把当前 Next.js 项目部署到 Netlify并返回可以公网访问的地址。16.4 部署后的好处获得公网地址可以直接分享给别人适合展示作品集适合测试 Demo适合临时发布网页项目17. Computer Use让 Codex 操作电脑17.1 Computer Use 是什么Computer Use 是让 Codex 像人一样操作电脑的能力。它可以打开软件点击按钮读取界面内容操作浏览器操作聊天软件发送消息汇总网页信息视频中提到该插件目前在 Mac 上使用。17.2 简单示例发送聊天消息提示词请打开聊天软件找到老板发送你好。Codex 会打开聊天软件找到联系人输入消息请求用户确认发送用户确认后发送17.3 复杂示例看板汇总 发简报任务示例请调用浏览器打开 GitHub 上的项目进度看板汇总里面的项目进度然后做一个英文版简报发送给老板。Codex 会打开浏览器阅读项目看板汇总工单状态生成英文简报请求确认后发送17.4 和自动化结合可以把 Computer Use 流程变成定时任务请把以上流程做成一个自动化每天下午 5 点下班时发送一份项目进度简报给老板。17.5 防止系统休眠如果希望每天定时执行自动化任务建议开启运行时防止系统休眠视频中提到这个开关是 Mac 上独有的Windows 不需要处理这一步。18. 常用提示词模板18.1 初始化项目把当前目录初始化成一个 Git 项目。 请创建合适的 .gitignore排除 node_modules、环境变量文件、构建产物和其他不需要提交的文件。18.2 推送 GitHub请把当前项目提交并推送到 GitHub。 远端仓库地址是 仓库地址18.3 开启计划模式后做复杂任务请先不要直接修改代码。 请先阅读项目结构并给我一份详细实施计划。 等我确认后再开始执行。 任务是你的任务18.4 中途纠正 AI当前方向不对请暂停现在的实现。 我的意思是重新说明需求 请按照这个方向继续。18.5 回滚代码请把当前代码回退到以下 commit 的状态后面的改动不要保留 commit hash18.6 创建 Worktree 并行任务请为这个任务创建一个独立的 worktree 分支不要影响主干。 任务是你的任务18.7 合并 Worktree当前分支开发完成请把它合并回主干。 如果有冲突请先停下来让我选择怎么处理。18.8 生成项目记忆文件请通读当前项目把项目背景、技术栈、目录结构、开发规范、运行命令、测试命令和注意事项整理到 AGENTS.md 文件中方便以后新对话自动读取。18.9 安全删除限制禁止使用脚本批量删除文件或目录。 如果需要删除文件请一个一个删除。 如果必须批量删除请停止操作让我手动确认。18.10 创建自动化请把刚才这个流程创建成自动化任务。 执行频率是每周五下午 4 点。 执行结果请通过 Gmail 发给我。18.11 创建 Skill请帮我创建一个 Skill用来把视频和字幕转换成图文 Markdown 教程。 要求 1. 自动读取字幕 2. 添加标点 3. 划分章节 4. 提取知识点 5. 需要配图的位置添加截图占位符 6. 调用 ffmpeg 从视频截图 7. 最终输出 Markdown 文件。19. 易错点与最佳实践19.1 不要让 AI 长时间在旧上下文里工作一个任务完成后建议新开对话。用AGENTS.md提供项目背景而不是依赖很长的聊天历史。19.2 复杂任务先开计划模式涉及架构迁移、数据库、部署、插件、MCP 的任务最好先让 AI 输出计划。19.3 AI 执行方向错了要及时 Steer不要等 AI 全部做完才发现方向错。中途发现问题立即使用引导功能。19.4 经常 commit每完成一个小功能就 commit。这样可以随时回滚到稳定状态。推荐节奏一个小功能 → 测试通过 → commit19.5 不要把密钥提交到 GitHub以下文件一定要加入.gitignore.env .env.local19.6 Worktree 适合并行任务多个独立功能可以用多个 Worktree 同时开发。不要让多个任务在同一个文件夹里互相干扰。19.7 云端任务适合用 PR 审核Codex 云端改代码后最好通过 Pull Request 审核再合并。这样更安全也方便看改动。19.8 全局指令里加入安全限制强烈建议加入类似规则禁止批量删除文件。 禁止在未确认情况下删除项目外文件。 高风险操作必须先询问用户。19.9 插件授权要谨慎插件可能连接邮箱GitHub浏览器数据库部署平台授权前要确认插件用途和权限范围。19.10 自动化任务要先手动测试创建自动化后建议先点击“立即运行”测试一次确认输出正确后再定时执行。一句话总结Codex App 不只是一个写代码工具更像是一个可以管理项目、调用工具、运行浏览器、连接外部服务、创建自动化的 AI Agent 工作台。真正高效的用法不是让它“一口气乱改”而是配合沙箱权限计划模式Git 提交Worktree 并行开发AGENTS.md 记忆插件 / Skills / MCPPR 审核自动化任务把 AI 的能力约束在安全、可回滚、可复用的工作流里。