摘要：本文基于完整的实战项目，系统讲解Codex的安装配置、三种权限模式、精准标注修改、Fork会话分叉、agent.md跨会话配置、Plan Mode、Side Chat、插件、Skill、自动化定时任务以及手机远程控制。全文含对比表格和操作命令，可直接落地。

目录

1. 安装与套餐选择
2. 三种权限模式
3. 项目实战：从网页到Electron客户端
4. Fork机制：会话分叉与代码回滚
5. agent.md跨会话配置
6. Plan Mode与Side Chat
7. 插件：浏览器与电脑控制
8. Skill与自动化任务
9. 手机远程控制
10. 参考资源

1. 安装与套餐选择

登录方式	说明	推荐度
ChatGPT账号登录	免费版额度极少，建议订阅Plus（20美元/月）	推荐
API Key登录	需海外信用卡，门槛高，不划算	不推荐

安装流程：官网下载→双击安装（macOS拖入Applications文件夹）→登录→选择工作类型（可跳过配置导入）。

2. 三种权限模式

在输入框下方可选择权限模式，影响Codex执行风险操作时的行为：

模式	行为	适用场景
Default permissions	修改项目外文件或执行高风险命令时弹窗确认	绝对安全，但需全程在场
Autoreview	安全审查agent自动判断，危险操作拒绝，极少数情况弹窗	推荐，效率与安全平衡
Full access	全部自动同意，无安全校验	测试环境，风险自担

为避免频繁弹窗，推荐使用Autoreview模式。

3. 项目实战：从网页到Electron客户端

3.1 创建项目并提需求

• 新建文件夹（如“马克笔记”）→ Codex中Work in a project→Use an existing folder关联。
• 需求示例：使用HTML/CSS/JS写一个笔记软件，界面左右分栏：左边笔记列表，右边笔记内容。注意做好测试。
• Codex自动生成代码并提供本地预览。

3.2 精准修改：Notate功能

• 点击notate图标→在预览区域圈选要修改的元素（如两条示例笔记）→输入修改意见（如“去掉”）→提交。
• Codex会同时发送截图和文字要求，实现精准修改。

3.3 预览器限制注意事项

• Codex内置预览器有安全限制（如禁用localStorage），可能导致某些功能（如添加笔记按钮）无响应。
• 解决方案：在独立浏览器中打开页面测试，功能正常。

3.4 Git集成与终端操作

• 快捷键Cmd+J开关终端面板。
• 基础命令：git init、git add .、git commit。
• Codex内置Git UI：点击Environment→Changes→查看未暂存改动→可对特定代码行添加注释要求修改→点击Commit按钮提交。

3.5 改造为Electron桌面客户端

• 需求：把这个网页应用改成桌面客户端，使用Electron + React + TypeScript，注意做好测试。
• 启用Plan Mode（加号→Plan Mode），Codex先输出计划并询问关键问题（数据存储位置、交付程度等），确认后实施。
• 如遇白屏错误，将控制台报错信息提交给Codex即可自动修复。

4. Fork机制：会话分叉与代码回滚

Codex没有直接的“回滚”按钮，而是通过Fork复制会话到历史节点。

选项	代码处理	特点
Fork into local	继续使用原项目目录，代码不会回滚	需配合git reset手动回滚代码
Fork into new worktree	创建新的隔离目录（基于git worktree）	新老会话代码独立，互不影响

Fork仅复制对话内容，不会自动回滚代码；如需代码与对话同时恢复，需手动使用Git。

会话归档：点击会话旁图标→rm可归档（隐藏）；按Cmd+,→Archived Chats可找回或彻底删除。

5. agent.md跨会话配置

在项目根目录创建agent.md文件，Codex每次启动新会话时会自动读取其内容作为初始指令。

示例：写入每次完成代码修改后，都需要提交一次git commit
效果：后续所有会话中，Codex完成代码修改后自动执行git commit。

扩展用途：可规定代码风格、命名规范、技术栈要求、项目背景介绍等，提升Codex对项目的理解。

6. Plan Mode与Side Chat

功能	触发方式	作用
Plan Mode	加号→Plan Mode	复杂任务先输出详细计划，确认后实施；可多次修改计划
Side Chat	输入/side	在主任务执行期间并行提问轻量问题，不干扰主任务

7. 插件：浏览器与电脑控制

7.1 插件结构

每个Plugin包含：

• App：连接外部工具（如Gmail插件提供24个Action）
• Skill：指导大模型如何使用该插件的说明文档

7.2 Rome浏览器插件

• 安装：Plugins页面点击Rome旁加号→按提示安装Chrome扩展。
• 使用示例：打开Product Hunt首页，找出今天最热门的三个新发布的产品，总结各自的特点，并附上对应的访问链接。
• Codex自动创建标签组、访问页面、收集信息并输出结果。

7.3 Computer Use插件

• 用于直接操作电脑应用（如日历、笔记软件）。
• 使用示例：请打开我电脑自带的日历应用，帮我新建一个5月28日10点的日程，标题叫做“讨论马克笔记的后续设计”。
• Codex使用独立虚拟鼠标，可后台运行，不干扰用户正常操作。

8. Skill与自动化任务

8.1 Skill管理

• 查看已安装Skill：Plugins→Skills标签页。
• Image Gen Skill：生成高质量图片。使用时可上传真实软件截图（点击加号→选择Electron应用截图，或双Command键快速截图）。
• 自定义Skill：新建会话→提出需求（如写一个代码审核Skill，专门给当前的项目使用）→Codex自动生成→新会话中可通过@选择调用。

8.2 自动化定时任务

• 创建：点击三个点→Automation→填写：
  • 标题（自动生成）
  • 任务要求（如检查当前项目的代码是否有问题）
  • 执行环境：local（项目目录）、worktree（新建隔离目录）、chat（不绑定项目）
  • 运行频率：如daily每日9点
  • 模型与推理强度
• 保存后可在Automations面板查看、试运行。

9. 手机远程控制

• 启用：点击Codex mobile→Get Started→Allow→登录→扫描二维码。
• 手机端操作：选择插件（如computeruse）→输入请求（如把日历中5月28号讨论马克笔记的日程删掉）→设置“不使用项目”→提交。
• 电脑端自动执行，支持远程任务下发。

10. 参考资源

-本文基于B站@马克的技术工坊《Codex从0到1全攻略》，由Ai好记辅助整理，若需快速定位本教程中特定功能的画面或提取命令行，可用Ai好记进行视频解析，希望对你有帮助！
如有问题欢迎评论区交流。欢迎点赞、收藏支持～