---
title: "Codex 官方教程中文版"
description: "基于 OpenAI 官方资料，按入口、配置、安全、扩展、Cloud、团队和实战场景重写的 Codex 中文查询手册。"
verifiedAt: "2026-05-06"
---

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

> [!NOTE]
> 这一页是功能手册入口。它不替代 OpenAI 官方文档，而是把官方资料按中文开发者的查询路径重排：先选入口，再设边界，再接扩展，最后进入 Cloud、团队和真实场景。

Codex 的官方事实变化很快，所以本系列正文只固定稳定结构：App、IDE extension、CLI、Cloud 四类入口；`AGENTS.md` / `config.toml` / sandbox / approval 这条安全配置主线；MCP、Skills、Subagents、Hooks 这组扩展能力；以及 Cloud、GitHub、Slack、Linear、CI 这类团队集成。模型、价格、版本更新和功能成熟度以官方页面为准。

```mermaid
flowchart TB
  Start[新手必读] --> Entry[产品入口<br/>App / IDE / CLI / Cloud]
  Entry --> Guard[规则、安全与配置<br/>AGENTS.md / config.toml / sandbox / approvals]
  Guard --> Extend[扩展能力<br/>MCP / Skills / Subagents / Hooks]
  Extend --> Runtime[云端与远程环境]
  Runtime --> Team[团队企业与集成]
  Team --> Scenarios[实战场景与学习路线]
  Scenarios --> Versions[版本、迁移与官方视频]
```

## 官方事实基准

- Quickstart 当前把 Codex 入门拆成 App、IDE extension、CLI 和 Cloud。
- Codex App 官方面向 macOS 和 Windows；平台差异以对应官方页面为准。
- Codex CLI 官方支持 macOS、Windows 和 Linux，安装入口包括 `npm install -g @openai/codex` 和 Homebrew。
- IDE extension 官方入口覆盖 Visual Studio Code、Cursor、Windsurf 和 Visual Studio Code Insiders。
- Codex Cloud 在 `chatgpt.com/codex` 运行，也可以通过 GitHub PR 评论里的 `@codex` 触发任务。
- 安全边界由 sandbox mode、approval policy 和 network access 共同决定；默认网络访问关闭，本地运行通常受 OS sandbox 限制。

## 按问题选入口

<Cards>
  <Card title="第一次跑通" description="从 quickstart、登录认证、术语和安全清单开始，先建立最小闭环。" href="/docs/codex/official/00-getting-started" />
  <Card title="选择使用入口" description="查 App、IDE、CLI、Web、Windows、worktree、本地运行时和浏览器能力。" href="/docs/codex/official/01-products" />
  <Card title="设置安全边界" description="查 AGENTS.md、config.toml、approval、sandbox、network 和受保护路径。" href="/docs/codex/official/02-config-security" />
  <Card title="扩展 Codex 能力" description="查 MCP、Skills、Subagents、Hooks、memory、plugins 和 workflow 组合方式。" href="/docs/codex/official/03-extensions" />
  <Card title="控制成本和速度" description="查提示词、模型选择、用量入口、提速方法和功能成熟度；具体价格以官方为准。" href="/docs/codex/official/04-model-pricing" />
  <Card title="使用 Cloud 和远程环境" description="查 Cloud runtime、网络权限和远程开发环境边界。" href="/docs/codex/official/05-cloud-remote" />
  <Card title="团队与企业落地" description="查 GitHub、Slack、Linear、CI/CD、SDK、企业治理和托管配置。" href="/docs/codex/official/06-team-integration" />
  <Card title="按场景学习" description="按 Web、游戏、原生应用、生产系统和效率路线选择学习顺序。" href="/docs/codex/official/07-learning-paths" />
  <Card title="真实任务模板" description="把 bug 分诊、PR review、数据查询、UI 构建、部署等需求改写成 Codex 任务。" href="/docs/codex/official/08-scenarios" />
  <Card title="版本与迁移" description="只用来查官方演示、迁移说明和变更入口；不把高波动时间线当长期教程。" href="/docs/codex/official/09-versions" />
</Cards>

## 推荐学习顺序

1. 先读 [从原理到实战](/docs/codex/understanding)，理解任务、上下文、工具、边界和验证。
2. 再跑 [Quickstart](/docs/codex/official/00-getting-started/01-quickstart)，只做一个可回滚的小任务。
3. 立刻补 [第一次安全使用清单](/docs/codex/official/00-getting-started/first-safe-use-checklist)，不要让第一次体验变成大范围改动。
4. 写 [AGENTS.md](/docs/codex/official/02-config-security/05-project-rules)，把项目约定沉淀成 Codex 能稳定读取的规则。
5. 根据入口选择 [CLI / App / IDE / Cloud](/docs/codex/understanding/cli-app-ide-cloud)，不要所有入口同时上手。
6. 需要复用和集成时，再进入 MCP、Skills、Subagents、Hooks 和团队集成。

## 不硬写的信息

- 价格、用量、套餐、模型默认值和上下文窗口。
- 平台下载按钮、支持系统的细小差异和版本发布日期。
- GitHub、Slack、Linear、CI 集成的开关状态和企业权限策略。
- changelog、demo video 和迁移时间线。

这些内容只在对应文章里给官方入口和判断方法，不在索引页伪装成长期事实。

## 官方资料

- OpenAI Codex 文档：[https://developers.openai.com/codex](https://developers.openai.com/codex)
- Codex quickstart：[https://developers.openai.com/codex/quickstart](https://developers.openai.com/codex/quickstart)
- Agent approvals & security：[https://developers.openai.com/codex/agent-approvals-security](https://developers.openai.com/codex/agent-approvals-security)
- OpenAI Codex GitHub：[https://github.com/openai/codex](https://github.com/openai/codex)

## 接下来去哪

<Cards>
  <Card title="新手必读" description="先完成定位、quickstart、认证、术语和安全清单。" href="/docs/codex/official/00-getting-started" />
  <Card title="产品入口" description="按任务选择 App、IDE、CLI、Cloud、Windows 或 worktree。" href="/docs/codex/official/01-products" />
  <Card title="规则安全与配置" description="把 AGENTS.md、config.toml、approval、sandbox 和 network 一次性理清。" href="/docs/codex/official/02-config-security" />
  <Card title="实战场景" description="从真实任务模板反推 Codex 的提示词、边界和验收方式。" href="/docs/codex/official/08-scenarios" />
</Cards>
