主题
官方覆盖地图
这页用于审计 Codex 文档迁移范围。当前官方对照来自 https://developers.openai.com/codex/codex-manual.md。本站不是逐篇翻译官方页面,而是按中文用户的安装、配置、权限、安全、扩展、自动化、企业治理和 Gushen888 接入边界重新聚合。
当前状态:
| 项目 | 数量 | 本地位置 |
|---|---|---|
| 官方 manual source 区块 | 91 | Codex manual 中的 Source: 条目 |
| 本地 Codex 页面 | 27 | content/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 Use | Codex 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.md | Agent 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 |
Gushen888 口径
Codex 和 Claude Code 的 Base URL 规则不同:
| 客户端 | Gushen888 Base URL | 说明 |
|---|---|---|
| Codex | https://api.gushen888.cloud/v1 | OpenAI / Responses API 兼容路径,带 /v1 |
| Claude Code | https://api.gushen888.cloud | Anthropic Messages 兼容路径,不带 /v1 |
Codex 本地 CLI、桌面 App 和 IDE 扩展可以读取本机 ~/.codex 配置。Codex Cloud、Slack、Linear、GitHub 托管 review 等云端能力运行在 OpenAI 官方环境,不要假设它们会继承本机 Gushen888 配置。
什么时候新增页面
优先新增页面的情况:
- 官方能力属于独立工作流,例如 hooks、rules、CI、SDK、managed configuration。
- 内容影响安全边界,例如 sandbox、network、Computer Use、cloud secrets。
- 需要单独解释 Gushen888、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