---
title: "新手必读"
description: "从定位、快速开始、登录认证、术语和安全检查开始，建立 Codex 的第一条安全使用闭环。"
verifiedAt: "2026-05-07"
---

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

> [!TIP]
> 第一次接触 Codex，不要从复杂自动化开始。先完成定位、quickstart、认证、术语和安全清单这 5 步，再让它改真实项目。

这一章只建立第一条安全闭环：知道 Codex 是什么，能跑通一个最小任务，认证方式清楚，术语不混淆，第一次改代码前有检查清单。

## 推荐顺序

```mermaid
flowchart LR
    A[理解定位] --> B[快速上手]
    B --> C[登录认证]
    C --> D[术语速查]
    D --> E[安全清单]
    E --> F[小范围真实任务]

    style E fill:#dcfce7,stroke:#22c55e,stroke-width:2px
```

## 章节速查

<Cards>
  <Card title="理解 Codex 定位" description="先分清 Codex 是 coding agent，不是普通聊天框，也不是无边界自动运维。" href="/docs/codex/official/00-getting-started/00-codex-positioning" />
  <Card title="快速上手 Codex" description="跑通安装、启动、最小任务和结果检查，先建立第一条闭环。" href="/docs/codex/official/00-getting-started/01-quickstart" />
  <Card title="完成登录和认证" description="分清 ChatGPT 登录、API key、CI/CD auth 和凭据安全边界。" href="/docs/codex/official/00-getting-started/02-auth" />
  <Card title="新手术语速查" description="回查 agent、sandbox、approval、MCP、context、diff 等常见术语。" href="/docs/codex/official/00-getting-started/glossary" />
  <Card title="第一次安全使用清单" description="第一次让 Codex 改代码前，逐项确认范围、权限、验证和回滚。" href="/docs/codex/official/00-getting-started/first-safe-use-checklist" />
  <Card title="从原理到实战" description="想先建立完整认知，走 12 篇理解路线。" href="/docs/codex/understanding" />
</Cards>

## 新手判断标准

- 能解释 Codex 会读文件、改文件、跑命令，也会受到当前入口和权限边界限制。
- 能完成一次只读项目理解任务，再进入小范围修改。
- 能说清认证凭据放在哪里、哪些信息不能贴进公开文档或日志。
- 能在任务结束时找到 diff、测试结果、未验证项和剩余风险。
- 能知道遇到陌生词时回术语页，而不是凭感觉理解。

## 学完本章你应该做到什么

学完这章，不要求你掌握所有 Codex 功能，但应该能独立完成这条最小闭环：

1. 选择 App、IDE extension、CLI 或 Cloud 中一个入口。
2. 登录并确认当前项目或 repository。
3. 发起只读项目理解任务。
4. 选择一个低风险小改动。
5. 查看 diff。
6. 跑至少一个验证命令。
7. 记录未验证项。

如果这 7 步做不到，先不要继续学 MCP、subagents、Cloud automation 或团队治理。

## 本章不解决什么

这一章不深入讲：

- 复杂 `config.toml`。
- MCP server 配置。
- skills / subagents / plugins。
- Cloud environment 高级配置。
- 企业治理、SSO、SCIM、managed config。
- 大型迁移和多 agent 协作。

这些放在后续章节。新手阶段先建立正确边界，避免一开始就把 Codex 当成无边界自动化工具。

## 配套从原理到实战

每个新手必读章节都有对应的深度讲解：

- 理解 Codex 定位：[Codex 到底是什么](/docs/codex/understanding/what-is-codex)
- 快速上手：[一次任务是怎么完成的](/docs/codex/understanding/how-a-task-completes)
- 安全清单：[Codex 为什么需要审批和沙箱](/docs/codex/understanding/sandbox-approval)

返回 [官方教程中文版总目录](/docs/codex/official)

## 接下来去哪

<Cards>
  <Card title="先理解定位" description="第一篇先建立边界，避免一开始就用错入口。" href="/docs/codex/official/00-getting-started/00-codex-positioning" />
  <Card title="再跑 Quickstart" description="跑通最小任务，不急着接复杂项目。" href="/docs/codex/official/00-getting-started/01-quickstart" />
  <Card title="补认证" description="把登录、API key、CI/CD 和凭据安全分开理解。" href="/docs/codex/official/00-getting-started/02-auth" />
  <Card title="最后过安全清单" description="第一次真实改代码前，把范围、权限、验证和回滚确认完。" href="/docs/codex/official/00-getting-started/first-safe-use-checklist" />
</Cards>

## 官方资料

- [OpenAI Codex overview](https://developers.openai.com/codex)
- [OpenAI Codex Quickstart](https://developers.openai.com/codex/quickstart)
- [OpenAI Codex App](https://developers.openai.com/codex/app)
- [OpenAI Codex IDE extension](https://developers.openai.com/codex/ide)
- [OpenAI Codex CLI](https://developers.openai.com/codex/cli)
- [OpenAI Codex web](https://developers.openai.com/codex/cloud)
