Codex完全指南:从安装到实战的终极教程

OpenAI Codex 作为当前最强大的AI编程助手之一，正在改变开发者的工作方式。本教程将带你从零开始，全面掌握Codex的安装、配置、技能管理，以及实际项目开发流程。无论你是初学者还是有一定经验的用户，都能从中获得实用价值。

一、环境准备与安装

1.1 前置条件

在开始之前，请确保你具备以下条件：

网络环境：

需要能够访问OpenAI服务

OpenAI账号：

需要有有效的ChatGPT账号

订阅计划：

推荐使用Plus套餐（$20/月）或Pro套餐（$100/月），不同套餐对应不同的使用额度

💡 额度建议：如果你需要进行大量开发工作，建议选择$100/月的Pro套餐。对于轻度使用，$20/月的Plus套餐也能满足基本需求。额度会在5小时窗口内重置。

1.2 下载与安装

访问OpenAI Codex官网下载页面：

https://chatgpt.com/zh-Hans-CN/codex/

Codex支持以下操作系统：

macOS：

推荐系统版本 macOS 12 或更高

Windows：

支持Windows 10/11（部分功能受限，详见第六节）

下载完成后，按照安装向导完成安装。首次启动时需要登录你的OpenAI账号。

1.3 数据迁移（可选）

如果你之前使用过其他AI编程工具（如Claude Code、Cursor等），Codex支持一键导入原有配置和记忆：

📥 导入步骤：

启动Codex后，在欢迎界面选择"导入现有配置"

选择源平台（Claude Code / Cursor / 其他）

授权Codex访问源平台数据

等待导入完成（通常包括：对话历史、自定义指令、Skills等）

如果初次 setup 时跳过了此步骤，也可以在后续通过设置菜单补导入。

二、界面与核心概念

2.1 界面布局

Codex的界面设计简洁高效，主要分为以下几个区域：

🗨️ 对话区域（中央）

主要的交互区域，在这里输入需求、查看Codex的回复和生成代码。

📁 侧边栏（左侧）

管理所有对话和项目。分为"对话"和"项目"两个视图。

⚙️ 设置入口（左下角）

访问配置选项、查看使用额度、管理Skills等。

2.2 核心概念：对话 vs 项目

类型	适用场景	特点
对话（Chat）	临时性任务、调研、规划、问答	不绑定特定文件夹，轻量级，适合快速交互
项目（Project）	正式开发工作、多轮迭代任务	绑定本地文件夹，所有生成文件自动保存，支持多轮对话共享上下文

⚠️ 最佳实践：避免在单个对话中混杂多个不同任务。建议为 each 独立任务创建新的对话，这样可以保持上下文清晰，避免混淆。

2.3 权限管理（重要）

在对话框左下角，有三个权限级别可选：

默认权限（Conservative）：

每次执行操作前都需要你的审批。适合不熟悉Codex的新手。

自动审查（Balanced）：

大部分安全操作自动执行，风险操作（如删除文件、访问敏感目录）需要审批。适合日常开发。

完全访问（Full Access）：

所有操作自动执行，无需审批。适合信任Codex且有经验的用户。

🚨 安全提示：如果你选择"完全访问"模式，请确保你理解Codex正在执行的操作。建议初次使用时先选择"自动审查"模式。

2.4 模型与推理等级选择

在对话框右下角，可以切换模型和推理等级：

模型选择：

推荐使用 GPT-5.5（当前最强模型）

推理等级：

速度模式：

三、关键配置优化

⚠️ 重要提示：在开始实际项目开发前，请务必完成以下配置。这些设置将显著影响你的使用体验。

3.1 常规设置

进入设置 → 常规，确保以下选项已开启：

启用计划模式（Plan Mode）：

在执行复杂任务前，让Codex先制定计划供你确认。

启用交互式批准（Interactive Approval）：

关键操作需要你的确认。

启用自动记忆（Auto Memory）：

Codex会自动总结对话内容并保存为长期记忆。

3.2 行为模式设置

找到设置 → 常规 → 跟进行为，将其设置为引导（Guided）。

为什么这样设置？

在"引导"模式下，Codex会在任务执行过程中主动询问你的意见，而不是一直执行到结束。这样你可以随时插入新指令或调整方向。

3.3 自定义指令（AGENTS.md）

AGENTS.md 是Codex的"家法"，用于定义全局行为规则。设置路径：设置 → 个性化 → 自定义指令。

以下是一个经过验证的优质模板（改编自Andrej Karpathy的配置）：

Codex 行为准则

1. 编码前先思考

明确陈述你的假设
如果存在多种理解，先列出再选择
如果遇到不确定的情况，立即停止并询问

2. 简化优先

只写解决当前问题的代码，不要过度设计
避免为单次使用的代码创建抽象层
如果能用50行代码解决，就不要写200行

3. 精准修改

只修改必须改动的部分
不要"顺手"改进相邻代码
保持原有代码风格

4. 目标驱动执行

明确定义成功标准
分步骤执行，每步验证
避免模糊的目标描述

💡 提示：你可以根据个人或团队偏好调整这份指令。设置完成后，所有新对话都会自动继承这些规则。

3.4 记忆功能配置

在设置 → 个性化 → 记忆中，开启以下选项：

自动保存记忆：

对话结束或闲置一段时间后，Codex会自动总结并保存关键信息。

上下文记忆：

在后续对话中，Codex会自动调用相关记忆片段。

这功能特别适合长期项目，Codex会"记住"你的偏好、项目背景等信息。

四、Skills与插件生态

4.1 核心概念

Skill（技能）：

单个功能模块，用于扩展Codex的能力（如：部署网站、操作数据库等）。

Plugin（插件）：

一组Skill、工具、配置的集合，更完整的解决方案。

4.2 管理Skills与插件

点击左侧边栏的 Skills 标签页，你可以：

浏览已安装的Skills：

查看当前可用的技能列表。

安装新Skill：

点击"添加Skill"，输入GitHub仓库URL或Skill名称。

创建自定义Skill：

点击"创建Skill"，用自然语言描述你想要的功能。

批量管理：

点击右上角"管理"，可以启用/禁用、删除多个Skills。

4.3 推荐Skills（供参考）

🌐 网页部署

快速将本地网页部署到服务器，支持多种平台（Vercel、Netlify等）。

🗄️ 数据库操作

连接并操作MySQL、PostgreSQL、MongoDB等数据库。

📊 数据分析

上传CSV/Excel文件，进行数据清洗、可视化、统计分析。

五、实战案例：开发一个产品介绍网页

通过这个完整案例，你将学会使用Codex进行实际的网页开发。

5.1 创建项目

在左侧边栏点击"新建项目"

选择本地文件夹作为项目目录（如：~/Projects/codex-demo）

为项目命名（如："Codex功能介绍页"）

5.2 启用计划模式

在对话框左侧找到"计划模式"开关，将其打开。此时对话框左侧会出现一个小图标，表示当前处于计划模式。

💡 为什么要用计划模式？对于复杂任务，让Codex先制定计划的好处是：你可以提前了解它将要做什么，有修改机会，避免返工。

5.3 描述需求

在对话框中输入以下需求（示例）：

请帮我开发一个介绍Codex功能的网页，要求：

1. 现代化设计风格，使用渐变色和卡片布局

2. 将所有功能按层级分类展示（基础功能、高级功能、特色功能）

3. 响应式设计，适配手机和桌面

4. 添加动画效果提升用户体验

5. 使用中文内容

Codex会询问一些澄清问题（如：配色偏好、参考网站等），回答即可。

5.4 审核与执行

Codex会生成一份详细的实施计划，包括：

文件结构

技术方案（使用的框架、库等）

实施步骤

仔细阅读计划，如果有需要修改的地方，直接提出。确认无误后，输入"开始实施"或点击"批准"。

5.5 实时预览与批注

开发完成后，Codex会提供预览链接。点击即可在内置浏览器中查看效果。

核心功能：批注模式

如果需要对生成的结果进行调整，可以使用批注功能：

点击预览窗口上方的"批注"按钮

在页面上直接框选要修改的元素

输入修改意见（如："把标题改成官方Logo"、"调整卡片间距"）

点击"发送"，Codex会自动应用修改

💡 进阶技巧：对于样式调整（颜色、字体、间距等），你可以直接在批注中使用自然语言描述，Codex会理解并执行。无需手动编写CSS。

5.6 部署上线

本地开发完成后，你可能需要将网页部署到服务器。如果你安装了部署相关的Skill，可以直接在对话框中输入：

/deploy

Codex会调用对应的Skill，完成部署流程。不同Skill的支持平台不同，常见选项包括：

Vercel

Netlify

GitHub Pages

自建服务器（需要配置SSH等信息）

六、进阶实战：开发一个用药提醒APP

接下来看一个更复杂的案例：开发一个移动端APP。

场景设定：你需要一个APP来提醒你按时服药，避免忘记或重复用药。

6.1 需求分析

向Codex描述需求：

我想开发一个用药提醒APP，功能包括：

1. 添加药品信息（名称、剂量、服用时间）

2. 设置提醒通知

3. 记录用药历史

4. 支持iOS和Android

Codex会询问更多细节，如：UI风格、是否需要账号系统、数据存储方案等。

6.2 技术方案

对于移动端APP开发，Codex通常会选择以下技术栈：

框架：

React Native 或 Flutter（跨平台）

通知：

使用系统级推送通知API

存储：

本地数据库（SQLite）或云端（Firebase等）

6.3 编译与安装（macOS）

⚠️ 注意：编译iOS APP需要macOS系统和Xcode。Windows用户只能开发Android版本。

自动化方案：使用Computer Use插件

Codex提供了Computer Use插件，可以自动控制你的电脑完成复杂操作（如：下载Xcode、配置签名、编译APP等）。

在设置中开启Computer Use功能

在对话框中输入：@Computer Use 帮我下载并安装Xcode

Codex会控制你的电脑完成下载和安装（此过程可能需要输入密码等敏感操作，Codex会暂停等待你处理）

6.4 真机调试

编译完成后，需要将APP安装到手机上进行测试：

使用数据线连接手机和电脑

在手机上开启"开发者模式"（iOS需要在设置中开启，Android需要开启USB调试）

信任开发者证书（首次安装时）

Codex会自动完成安装

之后，你就可以在手机上正常使用这个APP了！

6.5 远程继续开发（新功能）

Codex支持在手机上继续操控开发！这意味着你可以：

在通勤路上用手机查看代码

远程触发重新编译

查看BUG报告

设置方法：

在手机上安装Codex配套APP（目前仅支持iOS，Android版本开发中）

扫码配对电脑端的Codex

即可在手机上查看项目状态、发送指令

七、平台差异：Mac vs Windows

目前Codex在macOS上的功能最完整，Windows版本存在一些限制。

功能	Mac OS	Windows
Computer Use插件	✅ 完整支持	❌ 不支持
远程手机连接	✅ 支持（iOS/Android）	❌ 不支持
Appshots（截图快捷方式）	✅ 双击Command键即可	❌ 不支持
Locked Computer Use	✅ 锁屏后仍能操控	❌ 不支持
Chronicle（屏幕记忆）	✅ 后台自动记录屏幕内容	❌ 不支持
iOS APP开发	✅ 需要Xcode	❌ 无法原生开发
基础代码生成	✅ 完整支持	✅ 支持
网页开发	✅ 完整支持	✅ 完整支持

💡 给Windows用户的建议：虽然部分高级功能受限，但Codex的核心能力（代码生成、网页开发、Skills调用等）在Windows上完全可用。如果预算允许，建议配备一台Mac用于完整开发流程。

八、使用技巧与最佳实践

8.1 提示词（Prompt）优化

与Codex交互的质量取决于你的提示词。以下是一些技巧：

具体明确：

避免模糊描述，提供具体需求、示例、约束条件。

分步引导：

复杂任务拆解为多个子任务，逐步完成。

提供上下文：

如果是已有项目，先让Codex读取相关文件，了解现有代码结构。

使用@引用：

在提示词中使用@文件名来引用特定文件。

8.2 项目管理

合理组织项目：

相关功能放在同一个项目中，避免创建过多零散项目。

定期清理对话：

过长的对话会占用大量token，建议适时开启新对话。

利用记忆功能：

让Codex自动保存项目关键信息，方便后续接续工作。

8.3 成本控制

选择合适的推理等级：

日常任务用"高"，复杂任务才用"超高"。

避免不必要的快速模式：

标准模式已经足够快，除非紧急否则不需开启快速模式。

监控额度使用：

定期在设置中查看剩余额度，合理安排任务。