# Codex 官方覆盖地图

> Codex 官方 manual 的中文聚合范围、本站本地页面映射、维护口径和新增页面判断标准。

URL: https://docs.passion8.cc/docs/codex/official-coverage-map
Language: zh-CN
Publisher: Passion8

这页用于审计 Codex 文档迁移范围。当前官方对照来自 `https://developers.openai.com/codex/codex-manual.md`。本站不是逐篇翻译官方页面,而是按中文用户的安装、配置、权限、安全、扩展、自动化、企业治理和 Passion8 接入边界重新聚合。

当前状态:

| 项目 | 数量 | 本地位置 |
| --- | ---: | --- |
| 历史快照 manual source 区块(刷新后需重数) | 91 | Codex manual 中的 `Source:` 条目 |
| 本地 Codex 页面 | 27 | `content/docs/codex/*.mdx` |
| 主要接入口 | 2 | [安装教程](https://docs.passion8.cc/docs/codex/install),[配置教程](https://docs.passion8.cc/docs/codex/config) |
| 参考与审计入口 | 2 | 本页,[常见问题](https://docs.passion8.cc/docs/codex/troubleshooting) |

## 覆盖分区

| 范围 | 本地入口 | 主要官方来源 |
| --- | --- | --- |
| 基础接入与配置 | [安装教程](https://docs.passion8.cc/docs/codex/install),[配置教程](https://docs.passion8.cc/docs/codex/config),[配置参考](https://docs.passion8.cc/docs/codex/config-reference) | Quickstart, Authentication, Config basics, Advanced Configuration, Configuration Reference, Sample Configuration, Models |
| CLI 与日常使用 | [命令大全](https://docs.passion8.cc/docs/codex/commands),[CLI 与终端参考](https://docs.passion8.cc/docs/codex/cli-terminal-reference),[标准工作流](https://docs.passion8.cc/docs/codex/workflow),[代码管理](https://docs.passion8.cc/docs/codex/git),[Review、GitHub 与 PR 工作流](https://docs.passion8.cc/docs/codex/review-github) | CLI command reference, CLI features, Slash commands, Best practices, Workflows, Prompting, Review, Codex code review in GitHub |
| App、IDE 与运行入口 | [桌面 App](https://docs.passion8.cc/docs/codex/app),[IDE 扩展](https://docs.passion8.cc/docs/codex/ide),[功能可用性](https://docs.passion8.cc/docs/codex/feature-availability),[平台与集成](https://docs.passion8.cc/docs/codex/platforms-integrations),[Browser 与 Computer Use](https://docs.passion8.cc/docs/codex/browser-computer-use) | Codex app, App features, App settings, IDE extension, Codex web, Chrome extension, Computer Use, In-app browser, Remote connections, Sites |
| 权限、安全与网络 | [权限、沙箱与安全](https://docs.passion8.cc/docs/codex/permissions-sandboxing),[安全说明](https://docs.passion8.cc/docs/security),[常见问题](https://docs.passion8.cc/docs/codex/troubleshooting) | Agent approvals & security, Sandbox, Permissions, Auto-review, Cyber Safety, Agent internet access, Codex Security |
| 扩展与自定义 | [MCP:连接外部工具](https://docs.passion8.cc/docs/codex/mcp),[Skill 与插件](https://docs.passion8.cc/docs/codex/skills),[Hooks、Rules 与自定义](https://docs.passion8.cc/docs/codex/customization-hooks-rules),[记忆与 AGENTS.md](https://docs.passion8.cc/docs/codex/memory) | Agent Skills, Plugins, Model Context Protocol, Hooks, Rules, Custom instructions with AGENTS.md, Custom Prompts, Memories, Import to Codex |
| 多代理与并行 | [多代理、Subagents 与 Worktrees](https://docs.passion8.cc/docs/codex/subagents-worktrees),[代码管理](https://docs.passion8.cc/docs/codex/git) | Subagents, Worktrees, Automations, CLI features |
| 自动化、CI 与 SDK | [自动化与云端运行](https://docs.passion8.cc/docs/codex/automation),[非交互、CI 与 SDK](https://docs.passion8.cc/docs/codex/noninteractive-ci-sdk),[Review、GitHub 与 PR 工作流](https://docs.passion8.cc/docs/codex/review-github) | Automations, Cloud environments, Non-interactive mode, GitHub Action, Codex SDK, Codex App Server, Use Codex with the Agents SDK |
| 企业与平台 | [企业与治理](https://docs.passion8.cc/docs/codex/enterprise-governance),[功能可用性](https://docs.passion8.cc/docs/codex/feature-availability),[平台与集成](https://docs.passion8.cc/docs/codex/platforms-integrations) | Admin Setup, Governance, Managed configuration, Access tokens, Environment variables, Remote connections, Windows, Amazon Bedrock |

## Passion8 口径

Codex 和 Claude Code 的 Base URL 规则不同:

| 客户端 | Passion8 Base URL | 说明 |
| --- | --- | --- |
| Codex | `https://passion8.cc/v1` | OpenAI / Responses API 兼容路径,带 `/v1` |
| Claude Code | `https://passion8.cc` | Anthropic Messages 兼容路径,不带 `/v1` |

Codex 本地 CLI、桌面 App 和 IDE 扩展可以读取本机 `~/.codex` 配置。Codex Cloud、Slack、Linear、GitHub 托管 review 等云端能力运行在 OpenAI 官方环境,不要假设它们会继承本机 Passion8 配置。

## 什么时候新增页面

优先新增页面的情况:

- 官方能力属于独立工作流,例如 hooks、rules、CI、SDK、managed configuration。
- 内容影响安全边界,例如 sandbox、network、Computer Use、cloud secrets。
- 需要单独解释 Passion8、OpenAI 官方云端和本地配置之间的边界。
- 原页面已经承担太多任务,继续合并会让新手找不到答案。

优先合并到现有页面的情况:

- 只是一个命令、一个配置键、一个排错条目。
- 内容属于现有路径的小节,例如命令页里的新增 slash command。
- 不需要新的左侧导航入口。

## 维护脚本

刷新官方 manual 后,可用下面脚本查看官方 `Source:` 区块数量:

```bash
rg -n '^Source: ' /tmp/openai-docs-cache/codex-manual.md | wc -l
```

本地页面数量:

```bash
find content/docs/codex -maxdepth 1 -type f -name '*.mdx' | wc -l
```

检查左侧导航是否引用不存在的本地页面:

```bash
node - <<'NODE'
const fs = require('fs');
const path = require('path');
const root = 'content/docs';
function walk(dir) {
  return fs.readdirSync(dir, { withFileTypes: true }).flatMap((d) => {
    const p = path.join(dir, d.name);
    return d.isDirectory() ? walk(p) : p;
  });
}
const pages = new Set(walk(root).filter((f) => f.endsWith('.mdx')).map((f) => {
  const rel = path.relative(root, f).replace(/\.mdx$/, '');
  if (rel === 'index') return '/docs';
  return `/docs/${rel.replace(/\/index$/, '')}`;
}));
const nav = fs.readFileSync('src/lib/docs-nav.ts', 'utf8');
const links = [...nav.matchAll(/href: "([^"]+)"/g)].map((m) => m[1]).filter((href) => href.startsWith('/docs'));
const missing = links.filter((href) => !pages.has(href));
console.log({ pages: pages.size, links: links.length, missing });
NODE
```

## 官方参考

- [Codex manual](https://developers.openai.com/codex/codex-manual.md)
- [Codex Quickstart](https://developers.openai.com/codex/quickstart)
- [Codex Configuration Reference](https://developers.openai.com/codex/config-reference)