---
title: "规则、安全与配置"
description: "理解 Codex 项目规则、配置、安全审批、沙箱边界和 Security 相关能力。"
verifiedAt: "2026-05-06"
---

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

> [!IMPORTANT]
> 规则不是安全边界，配置也不是审查替代品。Codex 的可控运行依赖三件事同时成立：规则说清楚、配置设正确、审批和沙箱真正限制高风险动作。

这一章负责把 Codex 从“能干活”变成“在边界内干活”。核心主线是 `AGENTS.md` / Rules 负责项目约定，`config.toml` 负责本地行为开关，approval、sandbox、network 和安全模型负责风险控制。

## 三层防线

```mermaid
flowchart TB
    L1["规则层<br/>AGENTS.md / Rules<br/>项目约定沉淀"]
    L2["配置层<br/>config.toml<br/>工具行为开关"]
    L3["边界层<br/>approval / sandbox / network<br/>技术限制 + 人工决策"]
    L4["治理层<br/>安全模型 / 威胁模型 / 排障<br/>团队可审查"]

    L1 --> L2 --> L3 --> L4 --> Done[Codex 受控运行]

    style L1 fill:#dcfce7,stroke:#22c55e
    style L2 fill:#dbeafe,stroke:#3b82f6
    style L3 fill:#fef3c7,stroke:#f59e0b
    style L4 fill:#fee2e2,stroke:#ef4444
```

## 先读这四类

<Cards>
  <Card title="项目规则" description="用 AGENTS.md / Rules 让项目自己说明运行方式、禁区、验证和交付格式。" href="/docs/codex/official/02-config-security/05-project-rules" />
  <Card title="基础配置" description="从 config.toml 的基础选项开始，避免一上来复制完整配置清单。" href="/docs/codex/official/02-config-security/06-basic-config" />
  <Card title="审批与沙箱" description="理解 approval、sandbox、network 三者如何共同限制危险操作。" href="/docs/codex/official/02-config-security/07-approval-security" />
  <Card title="安全排障" description="遇到权限、网络、路径、命令被拒绝时，按安全边界逐层定位。" href="/docs/codex/official/02-config-security/74-security-troubleshoot" />
</Cards>

## 章节速查

### 规则层：让项目自己说话

- [编写项目规则文件](/docs/codex/official/02-config-security/05-project-rules)
- [定制 Codex 行为](/docs/codex/official/02-config-security/48-customize-behavior)
- [迁移自定义提示到新机制](/docs/codex/official/02-config-security/52-migrate-prompts)
- [用 Rules 控制命令边界](/docs/codex/official/02-config-security/53-rules-command-control)

### 配置层：`config.toml` 行为开关

- [配置 Codex 基础选项](/docs/codex/official/02-config-security/06-basic-config)
- [配置高级能力](/docs/codex/official/02-config-security/29-advanced-config)
- [查询完整配置项](/docs/codex/official/02-config-security/30-all-config-options)
- [参考配置样例](/docs/codex/official/02-config-security/31-config-samples)

### 边界层：sandbox、approval、network

- [设置审批和安全边界](/docs/codex/official/02-config-security/07-approval-security)
- [理解沙箱边界](/docs/codex/official/02-config-security/49-sandbox-boundaries)
- [理解网络安全边界](/docs/codex/official/02-config-security/50-network-security)
- [理解 Codex 安全模型](/docs/codex/official/02-config-security/72-security-model)
- [配置安全运行环境](/docs/codex/official/02-config-security/73-secure-runtime)
- [排查安全常见问题](/docs/codex/official/02-config-security/74-security-troubleshoot)
- [改进威胁模型](/docs/codex/official/02-config-security/75-threat-model)

## 配套从原理到实战

- AGENTS.md 怎么用：[为什么 AGENTS.md 能改变 Codex 行为](/docs/codex/understanding/agents-md-guide)
- sandbox + approval：[Codex 为什么需要审批和沙箱](/docs/codex/understanding/sandbox-approval)

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

## 接下来去哪

<Cards>
  <Card title="AGENTS.md 指南" description="先把项目规则写清楚，再让 Codex 长期稳定工作。" href="/docs/codex/official/02-config-security/05-project-rules" />
  <Card title="基础配置" description="从少量关键配置开始，避免复制不可解释的大配置。" href="/docs/codex/official/02-config-security/06-basic-config" />
  <Card title="审批安全" description="把危险命令、文件写入、联网和权限升级放到明确边界内。" href="/docs/codex/official/02-config-security/07-approval-security" />
  <Card title="沙箱边界" description="确认 Codex 能读写哪里、能不能联网、失败时该查哪一层。" href="/docs/codex/official/02-config-security/49-sandbox-boundaries" />
</Cards>

## 官方资料

- [OpenAI Codex configuration reference](https://developers.openai.com/codex/config-reference)
- [OpenAI Codex agent approvals and security](https://developers.openai.com/codex/agent-approvals-security)
- [OpenAI Codex sandboxing](https://developers.openai.com/codex/concepts/sandboxing)
