引言
Codex 是 OpenAI 的核心 AI 开发工具，能辅助编码、调试、测试，甚至控制电脑。本指南将带你走完 Codex 的完整使用流程——从安装到插件、技能、移动端控制等高级功能。
1. 安装与初始设置
1.1 下载安装 Codex
- 访问 Codex 官网下载安装包。
- macOS 用户将 Codex 拖入 Applications 文件夹即可完成安装。
1.2 登录方式
- ChatGPT 账号登录：可选 Free、Go、Plus、Pro 套餐。推荐 Plus（$20/月），token 额度适中。
- API Key 登录：使用 OpenAI API 密钥（需境外信用卡，性价比不如订阅）。
1.3 初始配置
- 按提示选择你的职位角色。
- 暂时跳过"导入云端代码"步骤。
- Codex Mobile 可以稍后设置（详见第 8 节）。
2. 基础项目开发流程
2.1 创建项目
- 创建本地文件夹（如"Mark Note"）存放项目文件。
- 在 Codex 中点击"Work on a Project" → "Use an Existing Folder"，选择你的项目文件夹。
2.2 第一个项目：构建 Markdown 笔记应用
- 输入你的需求：
用 HTML 构建一个笔记应用，左右两栏：左侧笔记列表，右侧笔记内容。包含基本的增删改查和本地存储功能。- Codex 会生成代码并请求启动本地服务器的权限。选择"Yes"允许。
2.3 预览与迭代
- 点击"Open in"在浏览器中预览应用。
- 使用"Annotation"功能选中 UI 区域并请求修改：
删除左侧栏顶部的两个示例笔记。2.4 调试
- 如果"添加笔记"按钮不工作，Codex 会诊断问题（通常是预览环境限制导致）。
- 在独立浏览器中测试应用以确认功能正常。
3. 高级配置与安全
3.1 权限模式
- 默认权限：执行高风险操作前 Codex 会请求确认。
- 自动审查：安全代理自动批准安全操作、阻止危险操作（推荐，兼顾安全与效率）。
- 完全访问：无提示，但需谨慎使用（有数据丢失风险）。
3.2 模型设置
- 模型选择：根据任务复杂度选择 GPT-5.5、GPT-5.4 等。
- 思考深度：从 Low 到 Extra High 可调（深度越高，代码质量越好但速度越慢）。
- 速度模式：启用"Fast"模式可提速 1.5 倍（消耗更多 token）。
4. Git 版本控制
4.1 初始化 Git 仓库
- 按
Command+J在 Codex 中打开终端。 - 运行以下命令：
git init
git add .
git commit -m "first commit"4.2 提交更改
- 使用 Codex 内置的 Git 界面：
- 点击"Changes"图标 → "Unstaged"查看修改文件。
- 点击"Commit"，输入提交信息（如"Change theme to blue"），点击"Continue"。
4.3 用 Fork 回滚
- 使用"Fork"功能回滚对话和代码：
- Fork into Local：创建新对话但保留当前代码（需手动 git reset 回滚代码）。
- Fork into New Worktree：创建新对话和独立项目文件夹（不回滚代码，但隔离更改）。
5. 跨项目配置：agent.md
5.1 创建 agent.md
- 在项目文件夹中创建名为
agent.md的文件。 - 添加规则，例如：
- 每次代码变更后用描述性信息执行 git commit。
- 所有新组件使用 React + TypeScript。
- 遵循项目的蓝色主题配色方案。5.2 测试配置
- 创建新对话，让 Codex 添加功能（如"添加深色/浅色模式切换"）。
- 检查 Git 日志确认 Codex 自动提交了更改。
6. 项目重构与高级功能
6.1 重构为 Electron 桌面应用
- 使用"Plan Mode"让 Codex 创建重构方案：
将此 Web 应用重构为 Electron 桌面应用，使用 React + TypeScript。确保所有功能正常工作。- 审查方案后点击"Yes, implement this plan"。
6.2 添加 Markdown 支持
- 让 Codex 添加 Markdown 编辑和预览模式：
添加 Markdown 支持："编辑"模式支持语法高亮编写，"预览"模式用于渲染。7. 插件与技能扩展
7.1 安装插件
- 点击侧边栏"Plugins"浏览可用插件：
- Chrome：控制 Chrome 浏览器抓取数据或与网页交互。
- Computer Use：控制电脑桌面应用（如日历、文件）。
- Presentations：生成 PowerPoint 演示文稿。
7.2 使用技能（Skills）
- 图片生成：使用"Image Gen"技能基于截图生成图片：
用提供的截图为这个笔记应用生成宣传海报。- 自定义技能：创建自己的技能（如代码审查技能）来自动化重复任务。
7.3 自动化任务
- 设置自动化任务（如每日代码审查）：
- 点击"Automations" → "Add Automation"。
- 定义任务："每天早上 9 点检查项目代码问题"。
- 选择"Local"作为执行环境并保存。
8. 移动端控制：Codex Mobile
8.1 设置 Codex Mobile
- 点击侧边栏"Codex Mobile"。
- 允许移动端控制，用手机扫描二维码连接。
8.2 从手机控制电脑
- 在手机上使用"Computer Use"插件控制桌面应用：
删除 5 月 28 日"讨论 Mark Note 设计"的日历事件。总结
Codex 是一款强大的工具，能从头到尾优化你的开发工作流。通过本指南，你可以高效地构建项目、自动化任务、通过插件和技能扩展能力。尝试不同配置，找到最适合你的工作流。
常见问题
Codex 和 VS Code Copilot 有什么区别？
Codex 是 OpenAI 的独立桌面应用，不仅能辅助编码，还能控制整个桌面环境——打开浏览器、操作文件管理器、运行终端命令、生成 PPT 等。Copilot 是 GitHub 的编辑器插件，专注代码补全和聊天。Codex 的定位更接近"AI 操作员"而非单纯的"代码助手"。如果只需要写代码辅助，Copilot 足够；如果希望 AI 处理跨应用工作流（编码→测试→部署→文档），Codex 更合适。
Codex 的订阅方案怎么选？
Plus（$20/月）是个人开发者的最佳选择——token 额度足够日常编码，价格合理。Free 版 token 极少，主要供试用。Pro 版（$200/月）适合将 Codex 作为主力开发环境的重度用户。API Key 方式需境外信用卡且按量付费，经常使用的话性价比不如订阅。
agent.md 文件必须放在项目根目录吗？
是的，Codex 会自动读取项目根目录下的 agent.md（或 CLAUDE.md）作为系统指令。你可以在里面定义代码规范、Git 提交习惯、技术栈偏好和项目特定规则。Codex 在该项目的每次对话中都会遵守这些规则——这是 Codex 最强大的功能之一：跨会话保持一致行为，无需重复说明。
Fork 功能的两个选项怎么选？
Fork into Local：对话回滚但代码保持不变。适合"讨论方向跑偏了但代码没问题"的情况。如需同时回滚代码，需手动 git reset。Fork into New Worktree：创建完全独立的工作目录，原项目不受任何影响。适合"想试试另一个方向但不影响当前进度"——相当于给整个项目状态开一个"假设"分支。