Codex 项目实战训练营：把 AI 编程变成可展示的业务资产

Codex 是什么

Codex 是 OpenAI 的编码智能体。它不只是回答问题，还能在你授权的范围内读取文件、修改代码、运行命令、做代码审查、整理资料、生成报告，并把结果留在你当前项目里。

对新手来说，最重要的理解是：Codex 不是一次性问答工具，更像一个需要上下文、规则和验收标准的队友。你给它的目标越清楚，它能检查自己工作的机会越多，结果就越稳定。

选择入口：App、CLI、IDE、Web

Codex 现在有多个使用入口。你不需要全部掌握，先选一个最贴近你当前工作的入口即可。

准备 3 样东西

安装与登录

如果你使用 Codex App，下载并安装 Windows 或 macOS 版本，打开后登录 ChatGPT 账号，选择一个项目文件夹，然后发送第一条消息。App 适合新手，因为它把线程、文件改动、审查面板和自动化放在同一个地方。

如果你使用 CLI，官方文档给出的 npm 安装方式如下：

npm i -g @openai/codex
codex

Windows 用户可以在 PowerShell 中原生运行 Codex；如果你需要 Linux 原生工具链，也可以用 WSL2。第一次运行时按提示用 ChatGPT 账号或 API Key 登录。

第一条成功任务

学 Codex 的第一步不是背命令，而是跑通一个完整闭环：描述目标，让它读项目，让它做最小修改，让它验证，再让它汇报结果。

这条消息之所以适合新手，是因为它包含了目标、上下文探索、具体产物、验收动作和交付说明。你能清楚看见 Codex 是否真的做完了。

完整实操课：从打开 Codex 到交付结果

这一课是一条从进入 Codex、选择环境、连接仓库、发起任务、查看执行日志、处理结果到复盘修正的完整实操路线。用户照着做完后，应当知道每个界面解决什么问题、应该检查什么、失败时从哪里回退。

Codex 国内站使用教程

这一节讲国内用户如何用第三方国内站跑通 Codex：先确认入口和服务规则，再完成注册、订阅、客户端安装、CC-Switch 接入，最后用一个小任务验证配置是否可用。

注册、订阅与下载

CC-Switch 接入

第一次国内站任务

第一次不要直接让 Codex 改真实项目。建一个空文件夹，明确告诉它要做什么、不要碰什么、怎么验证。任务越小，越容易判断国内站、Key、模型和客户端是否配置正确。

帮我修改首页文案
帮我整理 README
帮我加一个英文版页面
帮我修复样式问题
帮我把项目推送到 GitHub

国内站常见问题

Codex 指令保姆级教程

这个话题整理自 Oldeng 的 X 文章。它的核心提醒很实用：Codex 不是单纯聊天机器人，更像坐在项目目录里的 AI 编程同事。普通 prompt 是让它干活，斜杠指令则是管理它怎么工作。

先记一句话

普通 prompt = 让 Codex 干什么活，斜杠指令 = 管理 Codex 这个工具。指令必须放在输入开头；忘了有哪些指令，就先输入 / 看本机列表。

新手先掌握这 10 条

/side 和 /fork 别混

第一次用 Codex，照这个顺序走

直接可复制的提示

/plan 帮我修复登录页提交后 loading 状态不消失的问题。
先定位相关文件，给出最小改动方案，不要直接改代码。

按方案实现，保持改动尽量小。

/diff
/review

操控浏览器：让 Codex 帮你看页面、点页面、验页面

这个项目适合做成第一篇实战文章：目标不是讲浏览器概念，而是让学员看到 Codex 如何打开本地页面、检查按钮、验证画面、定位布局问题，并把发现转成可执行修改。

询盘外贸独立站：从产品展示到表单线索

这篇文章把 Codex 当成外贸站搭建助手：先确定产品、客户国家、卖点和询盘字段，再生成首页、产品区、信任背书、FAQ、联系表单和移动端布局。重点是让页面服务于询盘，不做空泛展示。

一人公司微信小程序：把业务入口做轻

一人公司不适合一开始做复杂系统。这篇文章可以演示如何用 Codex 规划小程序页面：服务介绍、预约咨询、案例展示、资料领取、客服入口和后台数据结构。先做能获客和承接咨询的版本。

个人网站：把你是谁、能做什么、怎么联系你讲清楚

个人网站项目适合用来练“从模糊需求到完整页面”。文章可以让学员准备个人定位、作品、服务、社交链接和联系方式，然后让 Codex 生成一个简洁可信的单页网站。

重点不是炫技，而是让访问者在一分钟内明白你的专业方向、代表作品和下一步联系动作。

产品宣传视频：从卖点到脚本、分镜和成片素材

这篇文章展示 Codex 如何辅助做视频前期：提炼产品卖点、写 30 秒脚本、拆分镜、生成字幕文案、列素材清单，再把这些内容整理成可交给剪辑工具或视频生成工具的制作说明。

PPT：把想法整理成能讲的演示稿

PPT 项目适合教用户把散乱资料交给 Codex 整理成结构化表达。文章可以覆盖：确定听众、提炼标题、搭建 8 到 12 页大纲、写每页讲稿、生成视觉建议，并检查逻辑断点。

Codex 终极实战：Agent 超级应用上手手册

Codex 看起来像 Claude Code，因为它也能围绕代码和项目工作；它也像 ChatGPT，因为你可以开对话。但它最重要的定位是本地化 Agent 超级应用：上传、读取、生成和修改的文件都围绕你的电脑展开。这个差异让它能做很多普通聊天窗口不适合做的事，比如生成落地页、制作动态图形视频、开发小应用、整理 Excel 和 Word 文档、创建演示文稿，甚至把结果继续导入 Canva。

这篇手册按原文逻辑梳理 Codex 的核心能力：完整的文件访问权限、Project 管理文件、agents.md 和 memories 记忆系统、插件生态、Skill 系统、GPT Image 图像生成、浏览器控制和电脑控制、自动化，以及研究预览功能 Chronicle。重点不是堆概念，而是理解每个能力在工作流里的位置。

能力 1：完整的文件访问权限

Codex 的第一个关键能力，是它能在授权范围内访问本地文件。ChatGPT 的文件通常存在云端对话里，Codex 则围绕你的电脑和项目目录工作。也就是说，它不只是“读一个附件”，而是可以找到文件夹、读取一批文件、生成新文件，并把产物留在你的本地目录里。

用 Project 管理文件

既然 Codex 的文件都落在电脑上，就需要用 Project 管理。直接创建 Chat 时，对话会显示在侧边栏，但不一定归入一个具体项目；创建 Project 时，它会连接到你电脑上的一个文件夹。以后 Agent 在这个项目对话中创建的文档、脚本、表格或页面，都会更自然地留在这个项目文件夹里。

能力 2：持久化记忆，agents.md 记偏好，memories 记过程

Codex 有两类记忆。第一类是手动记忆，常见载体是 agents.md。你可以告诉 Agent 以后遇到某类任务要遵守什么风格、流程或限制，它会把这些偏好写进去。比如你喜欢某种落地页结构，可以让它记住：以后没有指定样式时默认使用这种版式，文本多时要加目录。

第二类是自动记忆，常见位置是 memories 文件夹。它记录 Agent 做过的任务和过程经验，随着时间自动优化。这个文件夹可以观察，但不建议手动修改。简单说，agents.md 是你主动写给 Codex 的规则，memories 是 Codex 自动积累的过程记录。

能力 4：Skill 系统，把工作流程沉淀成 SOP

Skill 系统是 Codex 最值得重视的能力之一。你可以把 Skill 理解成可复用的工作流程配方：每次 Agent 使用某个 Skill，都会按里面的说明执行同一套流程。它不是普通提示词，而是能被反复调用、持续优化的 SOP。

原文里的例子是品牌合作邮件整理。先让 Codex 把品牌合作邮件整理成电子表格，表格按优先级做颜色标记，等输出质量满意后，再沉淀成 brand deal researcher。以后按斜杠键调用这个 Skill，就能复用同样的研究和整理流程。

Skill 也可以持续优化。每次使用技能，如果你发现某种格式更好、某个字段应该固定出现、某个插件应该一起调用，就可以让 Codex 更新这个 Skill。长期看，Skill 是把一次好结果变成稳定生产力的关键。

能力 3：插件生态，用 @ 调用外部工具

插件生态让 Codex 不只停留在本地文件夹里。插件是可安装、可重用的包，可以把 Codex 连接到 Gmail、Notion、Slack 等外部工具和工作流程。调用方式通常是用 @ 符号提及插件。

能力 5：GPT Image 直接生成图片

Codex 内置 GPT Image，可以直接在项目里生成图片。原文的例子是产品照片：用户创建 content 项目，上传一张毛衣图片，然后要求生成 5 张不同国籍模特穿着毛衣的产品照片，其中有单人照、三人照和五人照。生成结果会直接存储在 content 项目文件夹里。

能力 6：浏览器控制和电脑控制

Codex 可以像人一样控制浏览器和电脑。一个案例是用 @computer use 打开 Canva，创建 Canva 演示文稿，并把 5 张图片分别放进 5 页幻灯片。另一个案例是用 @browser use 自动测试网页应用：打开页面、点击开始按钮、滚动、选择测验、测试侧边栏，确认按钮和导航都能正常工作。

能力 7：自动化，把任务变成定时任务

当一个任务可以重复执行，就可以变成自动化。比如前面创建了品牌合作分析 Skill，就可以让 Codex 每周五上午 9 点运行一次：扫描 Gmail 里的付费推广、赞助和品牌合作邮件，更新品牌合作表格。自动化页面里可以看到运行时间、状态、上次运行时间，也可以随时编辑。

补充能力：Chronicle 实时监控屏幕上下文

Chronicle 是一个研究预览功能，需要在设置中手动开启。它会持续记录屏幕，从你最近打开的页面、演示文稿或工作内容里提取上下文。比如你打开了一个 Codex 视觉演示文稿，它可以根据屏幕内容建议补充“Codex 超级应用地图”“提示词文件的完整控制循环图”“Chronicle 演示幻灯片”等内容。

最后的判断

Codex 不是“更好的 ChatGPT”。ChatGPT 是云端对话工具，适合问问题、讨论思路、改写文本；Codex 是本地化 Agent 超级应用，适合处理本地文件、构建可复用工作流程、控制浏览器和电脑，并把成果留在你的项目里。如果只是偶尔问问题，用 ChatGPT 就够了；如果要把 AI 接进真实工作流，Codex 才是主要工具。

Hermes Agent 是什么

Hermes 是一个更适合大多数人使用的通用 Agent。原文把它和小龙虾 OpenClaw 做了对比：OpenClaw 更像某个具体方向的工具，Hermes 则更像可以长期陪伴、处理多类任务的全能秘书。它的关键特点是发挥稳定、记忆能力强、能够自我进化。

文章里的典型场景是微信消息管理。亦仁问 Hermes：“刘小排最近一周都说过啥？”Hermes 可以把共同微信群里刘小排说过的话总结出来。这说明它不只是一个聊天机器人，而是能围绕真实信息源做读取、总结和提醒的 Agent。

一句话安装 Hermes Agent

文章强调：安装 Hermes 并不难，关键是先准备好前提条件，然后把安装、配置、测试交给 Codex。

原文给出的核心提示词是：

在当前文件夹安装Hermes Agent，
让它使用我系统中的codex的GPT-5.5 xhigh模型
然后配置好，测试通过，并且让我扫码就可以直接绑定微信Clawdbot

发出这条指令后，Codex 会在当前文件夹里完成 Hermes 的安装、配置和测试。原文提到整个过程大概需要 10 分钟，完成后会出现扫码绑定界面。

扫码绑定微信 Clawdbot

Hermes 安装完成后，下一步是用微信扫码绑定 Clawdbot。绑定后，它就可以作为微信里的 Agent 入口使用。原文还提到，微信 Clawdbot 可以改头像、改名字，所以它可以伪装成一个更自然的微信联系人形态。

绑定之后，可以直接问 Hermes：“我有哪些重要的微信消息需要回复和关注？”这类问题体现的是它作为微信全能秘书的价值：不是替你泛泛聊天，而是帮你从消息流里找到重点，整理需要处理的事项。

文章最后也提醒，读取和总结微信消息存在一定风险，不适合大范围公开传播。这个项目真正要理解的是：Codex 不只是写代码工具，它可以成为安装、配置和测试其他 Agent 的入口；而 Hermes 则把 Agent 能力延伸到微信消息管理场景里。

提示词模板

让 Codex 解释项目

请先阅读当前项目结构和关键文件，然后用中文说明：
1. 这个项目是做什么的。
2. 主要入口文件在哪里。
3. 本地运行、构建、测试命令分别是什么。
4. 新手继续开发时最需要注意的 3 件事。

让 Codex 修 bug

现象：描述 bug 如何出现。
复现：列出具体步骤和输入。
期望：说明正确行为。
约束：请先定位根因，不要大范围重构。
完成：修复后运行相关测试，并说明为什么这个修复覆盖了复现路径。

让 Codex 做教程内容

请基于官方文档和当前项目内容，整理一篇中文教程。
要求：
- 先给目录，再写正文。
- 每一节都要有“做什么、为什么、怎么验证”。
- 把不确定或会随时间变化的信息标注为“以官方页面为准”。
- 最后列出资料来源链接。

常见问题

我不会写代码，可以用 Codex 吗？

可以，但要从小任务开始。让 Codex 解释文件、生成简单页面、整理表格、写教程，比一上来让它重构大型系统更合适。

Codex 会不会乱改我的文件？

本地工作时它会在当前项目和权限范围内行动。新手应该使用练习目录、版本控制、默认审批和沙箱设置；在最终接受改动前查看 diff。

什么时候用 Cloud，什么时候用 Local？

本地适合你要立刻看文件、运行本机工具、检查页面的任务。Cloud 适合委托后台任务、并行尝试、从 GitHub 仓库开 PR 的任务。

教程里要不要写模型价格和限额？

可以写入口和查询方法，但具体价格、限额、包含计划变化很快，页面中应提示以官方定价页和帮助中心为准。

调研来源

这一版内容优先整合官方资料，再补充开源仓库信息。后续你加入自己的实操经验时，可以把“官方事实”和“个人经验”分开标注。