Codex

官方覆盖地图

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

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

当前状态:

项目数量本地位置
官方 manual source 区块91Codex manual 中的 Source: 条目
本地 Codex 页面27content/docs/codex/*.mdx
主要接入口2安装教程,配置教程
参考与审计入口2本页,常见问题

#覆盖分区

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

#Passion8 口径

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

客户端Passion8 Base URL说明
Codexhttps://passion8.cc/v1OpenAI / Responses API 兼容路径,带 /v1
Claude Codehttps://passion8.ccAnthropic 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: 区块数量:

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

本地页面数量:

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

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

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

#官方参考

Support / 支持

Need help? / 需要帮助?

接入、计费与模型异常可邮件联系;服务可用性以状态页为准。For setup, billing, or model issues, email us. Check the status page for uptime.

也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right