Codex 入门指南：把 AI 当成会执行任务的代码与文档助手

Codex 是 OpenAI 的编码与任务执行 Agent。和普通聊天工具不同，Codex 可以在你授权的工作区里读取文件、修改代码、运行命令、查看结果，并把过程和改动交给你审核。

对企业团队来说，Codex 的价值不只是“帮程序员写代码”。它更像一个可以进入项目现场的执行助手：整理文档、检查配置、修复问题、生成脚本、跑测试、做代码审查、写变更说明。

Codex 适合做什么

Codex 适合处理边界相对清晰、可以验证结果的任务：

• 解释一个代码仓库的结构。
• 根据需求修改页面、接口或脚本。
• 修复一个明确报错。
• 为已有功能补测试。
• 把散乱文档整理成结构化说明。
• 批量检查链接、配置、路由或 SEO 元数据。
• 根据现有代码风格新增小功能。
• 生成部署步骤、变更记录或 Pull Request 描述。

不适合一开始就交给 Codex 的任务：

• 目标非常模糊，没有验收标准。
• 涉及高风险生产数据和不可逆操作。
• 需要大量商业判断、法务判断或财务判断。
• 需要访问尚未授权的外部系统。

第一次使用时，先给 Codex 四类信息

一个清晰的任务提示，最好包含四部分：

1. 目标：你希望它完成什么？
2. 上下文：相关文件、页面、报错、需求文档在哪里？
3. 约束：不能改什么？要遵守什么风格？是否需要保留旧逻辑？
4. 验收标准：什么状态算完成？需要跑什么测试？需要给什么结果？

示例：

请检查这个 Next.js 网站的 /blog 页面为什么没有显示最新文章。
上下文：内容仓库在 ../crazyaigc-content，主站读取逻辑在 lib/content/source.ts。
约束：不要改 UI 样式，不要删除旧内容仓库 fallback。
完成标准：找到原因，修复后本地 /blog 能显示新文章，并说明改了哪些文件。

权限和审批：为什么 Codex 经常会问你确认

Codex 默认会通过沙箱和审批机制保护你的代码与数据。常见规则包括：

• 当前工作区内的文件，可以在允许范围内读取和修改。
• 写入工作区外的路径，通常需要额外批准。
• 网络访问、安装依赖、部署服务器等动作，通常需要确认。
• 破坏性操作，例如删除文件、重置 Git 历史、覆盖数据，需要特别谨慎。

这不是麻烦，而是企业使用 AI Agent 的关键安全机制。你应该把 Codex 当成一个能干活的同事，而不是一个没有权限边界的脚本。

什么情况下先让 Codex 规划

如果任务复杂、需求还不清楚，先让 Codex 规划，而不是直接修改文件。

适合先规划的情况：

• 网站整体改版。
• 多仓库内容迁移。
• 涉及数据库、部署、权限或生产环境。
• 你自己还没有完全想清楚需求。
• 需要比较多个方案。

可以这样说：

先不要改代码。请先阅读相关文件，给我一个执行计划，列出会影响哪些页面、哪些风险、如何验证。

AGENTS.md：把反复说的要求写进项目

如果你每次都要提醒 Codex：

• 使用哪个包管理器。
• 测试命令是什么。
• 哪些目录不能动。
• 提交前要检查什么。
• UI 风格要遵守什么组件规范。

就可以把这些长期规则写进项目里的 AGENTS.md。Codex 会在工作开始前读取这些项目说明。

对企业团队来说，AGENTS.md 相当于给 AI Agent 的项目工作手册。

Skills：把重复工作变成可复用流程

如果你经常让 Codex 做同一类工作，例如：

• 每天抓 AI 新闻并写日报。
• 检查网站 SEO。
• 发布内容到某个平台。
• 部署某个固定系统。
• 按固定格式生成周报。

就可以把这类流程做成 Skill。Skill 是一组说明、参考资料和可选脚本，让 Codex 在类似任务中按固定方法执行。

企业使用 Codex 时，不应该只依赖临时提示词。越重复、越标准化的任务，越适合沉淀成 Skill。

企业团队使用 Codex 的基本流程

1. 先定义一个低风险任务。
2. 给出目标、上下文、约束和完成标准。
3. 让 Codex 读取代码和文档。
4. 对复杂任务先看计划。
5. 批准必要的文件修改或命令执行。
6. 要求它运行测试或做页面验证。
7. 审查 diff，再决定是否提交。

常见误区

误区一：把 Codex 当聊天工具

Codex 更适合带着文件、命令和验收标准工作。只问“帮我优化一下”通常效果不稳定。

误区二：不给上下文

如果你不告诉它文件位置、业务背景和约束，它只能自己猜。大型项目里，猜测会带来风险。

误区三：不看 diff

Codex 可以提高效率，但企业项目仍然需要人审核。尤其是权限、支付、客户数据、部署和 SEO 相关改动，必须检查。

误区四：所有事情都让一个会话做

复杂任务可以拆成多个阶段：调研、计划、实现、验证、提交。每一步都更清楚，风险更小。

资料来源

• OpenAI Codex Manual: Quickstart
• OpenAI Codex Manual: Best practices
• OpenAI Codex Manual: Agent approvals & security
• OpenAI Codex Manual: Agent Skills
• OpenAI Codex Manual: Custom instructions with AGENTS.md

本文由 CRAZYAIGC AI 学院基于 OpenAI 官方 Codex manual 整理，面向企业 AI 落地和团队协作场景改写。