# Claude Code 官方覆盖地图

> Claude Code 官方 163 个 Markdown 页面在本站中文文档里的聚合位置、维护口径和命令缓存覆盖情况。

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

这页用于审计迁移范围。当前官方缓存来自 `https://code.claude.com/docs/llms.txt`,manifest 共 163 个 Markdown 页面。本站不是按英文页面逐篇照搬,而是按中文用户的接入、配置、治理、扩展、SDK、成本和排错路径重新聚合。

当前状态:

| 项目 | 数量 | 本地位置 |
| --- | ---: | --- |
| 官方 Markdown 页面 | 163 | `/tmp/claude-docs-current/manifest.json` |
| 本地 Claude Code 页面 | 73 | `content/docs/claude-code/*.mdx` |
| 已有直接官方引用 | 163 / 163 | 每个官方 URL 至少出现在一个本地页面 |
| 官方 slash commands | 101 | [命令大全](https://docs.passion8.cc/docs/claude-code/commands) 与 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache) 均覆盖 101 / 101 |

## 覆盖分区

| 范围 | 本地入口 | 主要官方来源 |
| --- | --- | --- |
| 基础接入与命令 | [工作原理](https://docs.passion8.cc/docs/claude-code/how-it-works),[安装与接入](https://docs.passion8.cc/docs/claude-code/install),[命令大全](https://docs.passion8.cc/docs/claude-code/commands),[CLI 与终端参考](https://docs.passion8.cc/docs/claude-code/cli-terminal-reference) | [Overview](https://code.claude.com/docs/en/overview.md),[Quickstart](https://code.claude.com/docs/en/quickstart.md),[Setup](https://code.claude.com/docs/en/setup.md),[CLI reference](https://code.claude.com/docs/en/cli-reference.md),[Commands](https://code.claude.com/docs/en/commands.md),[Interactive mode](https://code.claude.com/docs/en/interactive-mode.md),[Keybindings](https://code.claude.com/docs/en/keybindings.md),[Terminal config](https://code.claude.com/docs/en/terminal-config.md),[Fullscreen](https://code.claude.com/docs/en/fullscreen.md),[Voice dictation](https://code.claude.com/docs/en/voice-dictation.md),[Deep links](https://code.claude.com/docs/en/deep-links.md) |
| 配置与 Provider | [设置与环境变量](https://docs.passion8.cc/docs/claude-code/settings),[配置调试](https://docs.passion8.cc/docs/claude-code/configuration-debugging),[模型与 Fast Mode](https://docs.passion8.cc/docs/claude-code/model-fast-mode),[功能可用性](https://docs.passion8.cc/docs/claude-code/feature-availability),Provider 认证 | [Authentication](https://code.claude.com/docs/en/authentication.md),[Settings](https://code.claude.com/docs/en/settings.md),[Environment variables](https://code.claude.com/docs/en/env-vars.md),[Debug your configuration](https://code.claude.com/docs/en/debug-your-config.md),[Claude directory](https://code.claude.com/docs/en/claude-directory.md),[Model configuration](https://code.claude.com/docs/en/model-config.md),[Fast mode](https://code.claude.com/docs/en/fast-mode.md),[Feature availability](https://code.claude.com/docs/en/feature-availability.md),[Amazon Bedrock](https://code.claude.com/docs/en/amazon-bedrock.md),[Google Vertex AI](https://code.claude.com/docs/en/google-vertex-ai.md),[Microsoft Foundry](https://code.claude.com/docs/en/microsoft-foundry.md),[Claude Platform on AWS](https://code.claude.com/docs/en/claude-platform-on-aws.md) |
| 企业治理与网关 | [企业部署总览](https://docs.passion8.cc/docs/claude-code/enterprise-deployment-overview),[企业网络与集中管控](https://docs.passion8.cc/docs/claude-code/enterprise-admin),[企业控制面](https://docs.passion8.cc/docs/claude-code/enterprise-controls),[企业 rollout](https://docs.passion8.cc/docs/claude-code/enterprise-rollout),[组织推广与沟通套件](https://docs.passion8.cc/docs/claude-code/adoption-communications),[Gateway 运维](https://docs.passion8.cc/docs/claude-code/gateway-operations),[Claude apps gateway 部署](https://docs.passion8.cc/docs/claude-code/gateway-cloud-deployment) | [Admin setup](https://code.claude.com/docs/en/admin-setup.md),[Enterprise deployment overview](https://code.claude.com/docs/en/third-party-integrations.md),[Network config](https://code.claude.com/docs/en/network-config.md),[Server-managed settings](https://code.claude.com/docs/en/server-managed-settings.md),[Managed MCP](https://code.claude.com/docs/en/managed-mcp.md),[Analytics](https://code.claude.com/docs/en/analytics.md),[Champion kit](https://code.claude.com/docs/en/champion-kit.md),[Communications kit](https://code.claude.com/docs/en/communications-kit.md),[Claude apps gateway](https://code.claude.com/docs/en/claude-apps-gateway.md),[Gateway config](https://code.claude.com/docs/en/claude-apps-gateway-config.md),[Gateway deploy](https://code.claude.com/docs/en/claude-apps-gateway-deploy.md),[Gateway on GCP](https://code.claude.com/docs/en/claude-apps-gateway-on-gcp.md),[Gateway spend limits](https://code.claude.com/docs/en/claude-apps-gateway-spend-limits.md) |
| 安全、隐私与沙箱 | [权限与模式](https://docs.passion8.cc/docs/claude-code/permissions),[Auto mode 策略参考](https://docs.passion8.cc/docs/claude-code/auto-mode-policy),[沙箱与隔离环境](https://docs.passion8.cc/docs/claude-code/sandboxing),[Sandbox 与 Dev Container](https://docs.passion8.cc/docs/claude-code/sandbox-devcontainers),[数据使用与隐私](https://docs.passion8.cc/docs/claude-code/data-usage),[Zero Data Retention](https://docs.passion8.cc/docs/claude-code/zero-data-retention) | [Permissions](https://code.claude.com/docs/en/permissions.md),[Permission modes](https://code.claude.com/docs/en/permission-modes.md),[Configure auto mode](https://code.claude.com/docs/en/auto-mode-config.md),[Sandboxing](https://code.claude.com/docs/en/sandboxing.md),[Sandbox environments](https://code.claude.com/docs/en/sandbox-environments.md),[Devcontainer](https://code.claude.com/docs/en/devcontainer.md),[Security](https://code.claude.com/docs/en/security.md),[Security guidance](https://code.claude.com/docs/en/security-guidance.md),[Data usage](https://code.claude.com/docs/en/data-usage.md),[Legal and compliance](https://code.claude.com/docs/en/legal-and-compliance.md),[Zero data retention](https://code.claude.com/docs/en/zero-data-retention.md) |
| 扩展、自动化与并行工作 | [工具参考](https://docs.passion8.cc/docs/claude-code/tools),[子代理](https://docs.passion8.cc/docs/claude-code/subagents),[多代理与 Workflows](https://docs.passion8.cc/docs/claude-code/parallel-agents),[高级工作流](https://docs.passion8.cc/docs/claude-code/advanced-workflows-cloud),[Routines 与调度](https://docs.passion8.cc/docs/claude-code/routines-scheduling),[Worktrees](https://docs.passion8.cc/docs/claude-code/worktrees),[MCP](https://docs.passion8.cc/docs/claude-code/mcp),[Hooks](https://docs.passion8.cc/docs/claude-code/hooks),[插件与 Skills](https://docs.passion8.cc/docs/claude-code/plugins) | [Tools reference](https://code.claude.com/docs/en/tools-reference.md),[Sub-agents](https://code.claude.com/docs/en/sub-agents.md),[Agents](https://code.claude.com/docs/en/agents.md),[Agent view](https://code.claude.com/docs/en/agent-view.md),[Workflows](https://code.claude.com/docs/en/workflows.md),[Goal](https://code.claude.com/docs/en/goal.md),[Advisor](https://code.claude.com/docs/en/advisor.md),[Routines](https://code.claude.com/docs/en/routines.md),[Scheduled tasks](https://code.claude.com/docs/en/scheduled-tasks.md),[Worktrees](https://code.claude.com/docs/en/worktrees.md),[MCP](https://code.claude.com/docs/en/mcp.md),[Hooks guide](https://code.claude.com/docs/en/hooks-guide.md),[Plugins](https://code.claude.com/docs/en/plugins.md),[Skills](https://code.claude.com/docs/en/skills.md) |
| Agent SDK | [Agent SDK](https://docs.passion8.cc/docs/claude-code/sdk),[API 参考](https://docs.passion8.cc/docs/claude-code/sdk-api-reference),[Agent 能力](https://docs.passion8.cc/docs/claude-code/sdk-agent-features),[能力矩阵](https://docs.passion8.cc/docs/claude-code/sdk-capabilities),[运行时模式](https://docs.passion8.cc/docs/claude-code/sdk-runtime-patterns),[Streaming 与插件](https://docs.passion8.cc/docs/claude-code/sdk-streaming-plugins),[生产部署](https://docs.passion8.cc/docs/claude-code/sdk-production) | [Agent SDK overview](https://code.claude.com/docs/en/agent-sdk/overview.md),[Quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart.md),[TypeScript](https://code.claude.com/docs/en/agent-sdk/typescript.md),[Python](https://code.claude.com/docs/en/agent-sdk/python.md),[Agent loop](https://code.claude.com/docs/en/agent-sdk/agent-loop.md),[Claude Code features](https://code.claude.com/docs/en/agent-sdk/claude-code-features.md),[Custom tools](https://code.claude.com/docs/en/agent-sdk/custom-tools.md),[MCP](https://code.claude.com/docs/en/agent-sdk/mcp.md),[Hooks](https://code.claude.com/docs/en/agent-sdk/hooks.md),[Plugins](https://code.claude.com/docs/en/agent-sdk/plugins.md),[Streaming output](https://code.claude.com/docs/en/agent-sdk/streaming-output.md),[Streaming input](https://code.claude.com/docs/en/agent-sdk/streaming-vs-single-mode.md),[Structured outputs](https://code.claude.com/docs/en/agent-sdk/structured-outputs.md),[Secure deployment](https://code.claude.com/docs/en/agent-sdk/secure-deployment.md) |
| Desktop、Web、IDE 与平台 | [桌面版与 IDE 扩展](https://docs.passion8.cc/docs/claude-code/desktop),[Desktop、Web 与 IDE 工作流](https://docs.passion8.cc/docs/claude-code/desktop-web-ide),[平台与集成](https://docs.passion8.cc/docs/claude-code/platforms-integrations),[Code Review 与 CI](https://docs.passion8.cc/docs/claude-code/review-ci),[Chrome 与 Computer Use](https://docs.passion8.cc/docs/claude-code/chrome-computer-use),[Web、远程控制与移动端](https://docs.passion8.cc/docs/claude-code/remote-web) | [Desktop](https://code.claude.com/docs/en/desktop.md),[Desktop quickstart](https://code.claude.com/docs/en/desktop-quickstart.md),[Desktop Linux](https://code.claude.com/docs/en/desktop-linux.md),[Desktop scheduled tasks](https://code.claude.com/docs/en/desktop-scheduled-tasks.md),[Claude Code on the web](https://code.claude.com/docs/en/claude-code-on-the-web.md),[Web quickstart](https://code.claude.com/docs/en/web-quickstart.md),[Remote Control](https://code.claude.com/docs/en/remote-control.md),[VS Code](https://code.claude.com/docs/en/vs-code.md),[JetBrains](https://code.claude.com/docs/en/jetbrains.md),[Platforms](https://code.claude.com/docs/en/platforms.md),[Code Review](https://code.claude.com/docs/en/code-review.md),[GitHub Actions](https://code.claude.com/docs/en/github-actions.md),[GitLab CI/CD](https://code.claude.com/docs/en/gitlab-ci-cd.md),[Chrome](https://code.claude.com/docs/en/chrome.md),[Computer Use](https://code.claude.com/docs/en/computer-use.md) |
| 成本、缓存与排错 | [监控与分析](https://docs.passion8.cc/docs/claude-code/monitoring),[Prompt 缓存](https://docs.passion8.cc/docs/claude-code/prompt-caching),[成本优化](https://docs.passion8.cc/docs/claude-code/cost-saving),[错误参考](https://docs.passion8.cc/docs/claude-code/error-reference),[常见问题](https://docs.passion8.cc/docs/claude-code/troubleshooting) | [Monitoring](https://code.claude.com/docs/en/monitoring-usage.md),[Costs](https://code.claude.com/docs/en/costs.md),[Prompt caching](https://code.claude.com/docs/en/prompt-caching.md),[Errors](https://code.claude.com/docs/en/errors.md),[Troubleshooting](https://code.claude.com/docs/en/troubleshooting.md),[Troubleshoot install](https://code.claude.com/docs/en/troubleshoot-install.md),[Glossary](https://code.claude.com/docs/en/glossary.md) |

## 命令与缓存覆盖

[命令大全](https://docs.passion8.cc/docs/claude-code/commands) 保留官方命令表的完整命令名、用途和可见性边界。[命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache) 对同一组 101 个 slash commands 逐项补充 5 分钟和 1 小时 TTL 影响。

缓存口径:

| 类型 | 解释 |
| --- | --- |
| 5 分钟 TTL | 常见 API 路径、Console 或普通网关路径的默认观察窗口 |
| 1 小时 TTL | Claude subscription、部分官方账号能力或支持 extended TTL 的 upstream |
| 命令动作 | 配置、导航、权限、UI、会话管理等命令不一定调用主模型,但会改变后续 prompt、tools、provider 或上下文 |
| Provider 切换 | Base URL、model pin、region、upstream 或缓存 key 变化后,不要假设可跨 provider 复用 |

## 维护脚本

刷新官方缓存后,用下面脚本检查是否还有官方页面没有在本地文档中直接引用:

```bash
node - <<'NODE'
const fs=require('fs');
const manifest=JSON.parse(fs.readFileSync('/tmp/claude-docs-current/manifest.json','utf8')).entries;
const localFiles=fs.readdirSync('content/docs/claude-code').filter(f=>f.endsWith('.mdx')).map(f=>'content/docs/claude-code/'+f);
const localText=localFiles.map(f=>({f,text:fs.readFileSync(f,'utf8')}));
const missing=[];
for(const e of manifest){
  const hits=[];
  for(const lf of localText){
    if(lf.text.includes(e.url)) hits.push(lf.f);
  }
  if(!hits.length) missing.push({slug:e.slug,title:e.title,url:e.url});
}
console.log(JSON.stringify({official:manifest.length,directReferenced:manifest.length-missing.length,missingCount:missing.length,missing},null,2));
NODE
```

命令覆盖用官方 `commands.md` 表格抽取:

```bash
node - <<'NODE'
const fs=require('fs');
function official(){
  const s=fs.readFileSync('/tmp/claude-docs-current/commands.md','utf8');
  return [...new Set([...s.matchAll(/^\|\s*`([^`]+)`/gm)].map(m=>m[1].split(/\s+/)[0]).filter(x=>x.startsWith('/')))].sort();
}
const off=official();
for(const file of ['content/docs/claude-code/commands.mdx','content/docs/claude-code/command-cache.mdx']){
  const s=fs.readFileSync(file,'utf8');
  const missing=off.filter(c=>!s.includes(c));
  console.log(file, JSON.stringify({official:off.length,missingCount:missing.length,missing},null,2));
}
NODE
```

## 什么时候新增页面

优先新增页面的情况:

- 官方新增的是一个独立工作流,例如新的 gateway 部署、SDK runtime 或企业控制面。
- 原页面已经过长,继续塞内容会降低中文用户找答案的效率。
- 需要单独说明 Passion8 网关、5m/1h 缓存、Provider 差异或国内团队部署边界。

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

- 官方新增只是某个命令、环境变量、限制或排错条目。
- 内容属于已有中文路径的一个小节。
- 只需要补一个官方引用和中文解释,不需要新导航入口。