---
title: "Codex 从原理到实战"
description: "面向新手的 Codex 理解路线：先理解任务、上下文、边界和验证，再进入官方教程中的命令与配置。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

> [!NOTE]
> 这条线不背参数。它解决的是“为什么 Codex 有时好用、有时不稳”：任务有没有拆清、上下文有没有给足、权限有没有收住、结果有没有验证。

官方教程中文版告诉你“功能怎么用”。从原理到实战解决另一个问题：新手应该按什么顺序建立判断力。Codex 能读文件、改代码、跑命令、调用工具，也可能接入 Cloud、IDE、MCP 和团队系统。能力越多，越需要先把目标、上下文、边界和验收讲清。

```mermaid
flowchart LR
  Goal[目标] --> Context[上下文]
  Context --> Tools[工具]
  Tools --> Boundary[边界]
  Boundary --> Verify[验证]
  Verify --> Review[审查]
  Review --> Rules[沉淀规则]
  Rules --> Goal
```

## 这条线怎么读

完全新手先读 01、02、03。你要先知道 Codex 不是聊天框，而是能在项目现场执行工程任务的 coding agent。

已经在用但经常不稳，先读 02、04、05、11。多数问题不是模型不行，而是任务不清、规则没沉淀、权限边界不明确、验收标准缺失。

想做团队落地，先读 04、05、10。团队场景最重要的是共识、边界、审查和治理。

想做自动化和复用，先读 07、08、09。不要一开始就堆 MCP、Subagents、Skills 和 Hooks，先判断它们各自解决什么问题。

## 章节路线

<Cards>
  <Card title="01 Codex 是什么" description="分清 coding agent、聊天助手、本地工具和云端任务的边界。" href="/docs/codex/understanding/what-is-codex" />
  <Card title="02 一次任务怎么完成" description="从需求、计划、读代码、改动、验证到交付，理解完整链路。" href="/docs/codex/understanding/how-a-task-completes" />
  <Card title="03 上下文工程" description="理解 Codex 能看到什么、应该先看什么、哪些信息不能靠猜。" href="/docs/codex/understanding/context-engineering" />
  <Card title="04 AGENTS.md 指南" description="把项目约定、运行方式和禁止事项沉淀成 Codex 的长期接口。" href="/docs/codex/understanding/agents-md-guide" />
  <Card title="05 沙箱和审批" description="理解 read-only、workspace-write、approval 和 network access 的风险边界。" href="/docs/codex/understanding/sandbox-approval" />
  <Card title="06 入口选择" description="比较 CLI、App、IDE 和 Cloud，按任务选择最合适的工作面。" href="/docs/codex/understanding/cli-app-ide-cloud" />
  <Card title="07 MCP 和工具" description="判断什么时候需要外部上下文、工具服务器和数据系统。" href="/docs/codex/understanding/mcp-tools-guide" />
  <Card title="08 Skills / Subagents / Hooks" description="区分流程复用、隔离执行和确定性自动检查。" href="/docs/codex/understanding/skills-subagents-hooks" />
  <Card title="09 模型、成本和速度" description="建立选择模型和控制用量的原则，具体价格回官方页核验。" href="/docs/codex/understanding/model-cost-speed" />
  <Card title="10 团队与生产" description="把个人体验升级成可审查、可回滚、可治理的团队流程。" href="/docs/codex/understanding/team-production" />
  <Card title="11 从理论到实战" description="把一句模糊需求拆成目标、范围、边界、验证和交付物。" href="/docs/codex/understanding/from-theory-to-practice" />
  <Card title="12 全貌复盘" description="用一张总图检查自己是否真的理解 Codex 的工作方式。" href="/docs/codex/understanding/complete-overview" />
</Cards>

## 第一条推荐提示词

第一次在项目里使用 Codex，不要让它一上来改代码。先发一个只读任务，让它理解项目用途、技术栈、运行方式、主要目录、潜在风险和下一步适合做的小任务。

```text
请先阅读当前项目，不要修改文件。
帮我理解项目用途、技术栈、运行方式、主要目录和潜在风险。
如果需要运行命令，先说明原因和影响。
最后给出三个适合下一步做的小任务。
```

这个提示词的重点不是措辞，而是把 Codex 从“马上动手”拉回“先理解现场”。

## 和官方教程中文版怎么配合

- 遇到“为什么、怎么判断、怎么取舍”，看从原理到实战。
- 遇到“具体命令、配置字段、入口步骤、官方限制”，看官方教程中文版。
- 遇到价格、模型、版本、平台支持差异，直接回官方文档核验。

## 怎么验收自己读懂了

- 能用一句话说明 Codex 是什么。
- 能把一个模糊需求改写成目标、范围、边界、验证和交付物。
- 能解释为什么 `AGENTS.md` 能改善长期效果。
- 能判断该用 read-only、workspace-write，还是需要审批。
- 能说清什么时候该用 MCP、Skills、Subagents、Hooks。
- 能在任务结束时要求 diff、测试结果、未验证项和剩余风险。

## 官方资料

- Codex quickstart：[https://developers.openai.com/codex/quickstart](https://developers.openai.com/codex/quickstart)
- AGENTS.md：[https://developers.openai.com/codex/guides/agents-md](https://developers.openai.com/codex/guides/agents-md)
- Agent approvals & security：[https://developers.openai.com/codex/agent-approvals-security](https://developers.openai.com/codex/agent-approvals-security)
- Codex CLI features：[https://developers.openai.com/codex/cli/features](https://developers.openai.com/codex/cli/features)

## 接下来去哪

<Cards>
  <Card title="Codex 是什么" description="第一篇先建立核心定义，避免把 Codex 当普通聊天框。" href="/docs/codex/understanding/what-is-codex" />
  <Card title="一次任务怎么完成" description="理解需求到验证的完整链路，再开始查命令。" href="/docs/codex/understanding/how-a-task-completes" />
  <Card title="沙箱和审批" description="能力越强，越要先理解安全边界和默认限制。" href="/docs/codex/understanding/sandbox-approval" />
  <Card title="官方教程中文版" description="理解主线之后，回到官方教程查具体入口、配置和场景。" href="/docs/codex/official" />
</Cards>
