# Docs

- 💻 Claude Code
  - [Claude Code 中文教程](/docs/claude-code): 基于 Anthropic 官方文档、源码和发布记录重写的 Claude Code 中文教程，连接翔宇工作流的真实项目实践。
  - 🧠 从原理到实战
    - [Claude Code 从原理到实战](/docs/claude-code/understanding): 12 篇翔宇深度讲解的阅读地图：从 Claude Code 是什么，到上下文、记忆、命令文件、SubAgents、MCP、权限和插件。
    - [01 · Claude Code 是什么](/docs/claude-code/understanding/01-what-is-claude-code): 真正改变 Claude Code 体验的不是模型变聪明，而是 AI 从浏览器搬到你电脑里——所以它能看文件、改代码、跑命令、自主规划。理解了这个位置差距，后面的 CLAUDE.md、Skills、SubAgents、MCP、Hooks 全都顺理成章。
    - [02 · 一次能看多少代码](/docs/claude-code/understanding/02-context-window): 上下文窗口不是记忆，是一张会满的工作台。100 万 token 听起来巨大，但用了 78% 你就会觉察 Claude 变笨——理解这张桌子怎么运作、怎么管，操作上的困惑就全解开了。
    - [03 · 怎么记住你的习惯](/docs/claude-code/understanding/03-memory): 上下文是一次性的，关机就清空。Claude Code 怎么跨会话记住你的项目、习惯、偏好？答案是双轨记忆——你写的 CLAUDE.md 持久指令 + 它自己写的 Auto Memory 工作笔记。
    - [04 · 怎么和 AI 说话](/docs/claude-code/understanding/04-prompting): 提示词不是模板游戏，是信息密度游戏。同样意思不同表达，AI 输出天差地别——不是因为语气，是因为信息量。理解信息四件套（目标 / 上下文 / 边界 / 验收），你给的每条指令都会立刻不一样。
    - [05 · AI 怎么决定想多深](/docs/claude-code/understanding/05-thinking-depth): 上篇讲了怎么和 Claude 对话，核心是「给什么信息」。但翔宇在实际使用中碰到一个有趣的现象：让它改个变量名，秒回；让它设计一个缓存架构，它会停下来想很久，而
    - [06 · 把重复的话写成文件](/docs/claude-code/understanding/06-command-files): 翔宇有一段时间每天都在跟 Claude Code 说同样的话：「用 pdfplumber 处理，先提取文本再处理表格，注意扫描件要走 OCR。」说了十几遍之后突
    - [07 · 派助手去干活](/docs/claude-code/understanding/07-subagents): 翔宇第一次用 SubAgents 的时候，脑子里想的是「一个 Claude 变三个，效率翻三倍」。用了几次之后发现，并行确实快了一点，但真正让翔宇离不开它的原因
    - [08 · 多个 AI 怎么协作](/docs/claude-code/understanding/08-multi-agent): 翔宇在做一个前后端分离的项目时遇到了一个场景：后端改了接口字段名，前端不知道，继续用旧的写了半天——最后集成时全对不上，返工。当时用的是 SubAgents，前
    - [09 · 怎么连外部服务](/docs/claude-code/understanding/09-mcp): 翔宇跟了很多人讨论 Claude Code 的局限。多数人觉得是模型不够强。但追到底发现，有一类需求不管模型多强都搞不定——不是脑子的问题，是手不够长。MCP
    - [10 · 怎么让操作 100% 执行](/docs/claude-code/understanding/10-operation-control): 翔宇有一条原则：凡是需要人类记住的事情，都应该让机器来做。反过来，凡是需要 AI「记住」去做的事情，都应该让代码来强制。这不是对 AI 不信任，是工程纪律。Ho
    - [11 · 该给 AI 多少权限](/docs/claude-code/understanding/11-permissions): 很多人第一次用 Claude Code，被各种权限弹窗搞烦了，恨不得全关掉。另一群人正好相反，什么都不敢放行，每个操作都手动确认。翔宇两种都试过，最后发现——两
    - [12 · 怎么给 AI 装插件](/docs/claude-code/understanding/12-plugins): 翔宇一直在想一个问题：为什么有些人用 Claude Code 效率是别人的十倍？技术能力差距没那么大。追到底，发现答案是——他们把自己的经验打包成了可复用的模块
  - 官方教程中文版
    - [Claude Code 官方教程中文版](/docs/claude-code/official): 基于 Anthropic 官方文档、源码和发布记录重写的中文教程。
    - 入门与安装
      - [入门与安装](/docs/claude-code/official/00-getting-started): Claude Code 官方入门路径：入口选择、安装、登录和第一轮会话。
      - [Claude Code 是什么](/docs/claude-code/official/00-getting-started/overview): 从官方定义理解 Claude Code 的产品定位、运行入口和基本工作方式。
      - [安装和更新 Claude Code](/docs/claude-code/official/00-getting-started/install): Claude Code 官方安装方式、系统要求、验证命令和更新策略。
      - [登录与认证](/docs/claude-code/official/00-getting-started/authentication): Claude Code 官方认证方式、登录流程、凭据存储位置和优先级。
      - [选择平台与集成](/docs/claude-code/official/00-getting-started/platforms): Claude Code 官方支持的 CLI、Desktop、IDE、Web、Mobile 和外部集成选择。
    - 核心配置与能力
      - [核心配置与能力](/docs/claude-code/official/01-core-capabilities): Claude Code 的 settings、permissions、CLAUDE.md 记忆和 MCP 连接机制。
      - [配置 Claude Code](/docs/claude-code/official/01-core-capabilities/settings): 基于 Anthropic 官方 Claude Code settings 文档，帮助新手理解 managed、user、project、local scope 和配置验证。
      - [管理权限](/docs/claude-code/official/01-core-capabilities/permissions): 基于 Anthropic 官方 Claude Code permissions 文档，帮助新手理解 allow、ask、deny、权限模式和安全边界。
      - [使用记忆机制](/docs/claude-code/official/01-core-capabilities/memory): 基于官方 Claude Code memory 教程，面向新手讲清 CLAUDE.md、CLAUDE.local.md、.claude/rules、auto memory 和排障方法。
      - [连接 MCP](/docs/claude-code/official/01-core-capabilities/mcp): 基于 Anthropic 官方 MCP 文档，帮助新手判断 Claude Code 什么时候该连接 MCP，以及 local、project、user scope 怎么选。
    - 扩展与自动化
      - [扩展与自动化](/docs/claude-code/official/02-extensions-automation): Claude Code 的 Skills、Subagents、Hooks、Commands 和 Agent SDK 中文教程入口。
      - [查看扩展能力地图](/docs/claude-code/official/02-extensions-automation/extension-map): 基于官方 Claude Code 扩展教程，面向新手讲清 CLAUDE.md、Skills、Subagents、MCP、Hooks、Plugins 和 Agent SDK 的分工。
      - [使用 Skills](/docs/claude-code/official/02-extensions-automation/skills): 用 Claude Code Skills 沉淀重复工作流、参考资料和可调用命令。
      - [配置 Subagents](/docs/claude-code/official/02-extensions-automation/subagents): 用 Claude Code Subagents 隔离上下文、运行专用 worker，并控制工具和模型边界。
      - [使用 Hooks](/docs/claude-code/official/02-extensions-automation/hooks): 用 Claude Code Hooks 在生命周期事件上执行格式化、阻断、通知和审计。
      - [使用 Commands](/docs/claude-code/official/02-extensions-automation/commands): 理解 Claude Code 内置命令、bundled skills、自定义 skill 命令和 MCP prompts。
      - [使用 Agent SDK](/docs/claude-code/official/02-extensions-automation/agent-sdk): 用 Claude Agent SDK 把 Claude Code 的 agent loop、工具和上下文管理嵌入自己的程序。
- 📘 OpenAI Codex
  - [OpenAI Codex 中文教程](/docs/codex): 基于 OpenAI 官方资料、源码和发布记录重写的 Codex 中文教程。
  - 从原理到实战
    - [Codex 从原理到实战](/docs/codex/understanding): 面向新手的 Codex 理解路线：先理解任务、上下文、边界和验证，再进入官方教程中的命令与配置。
    - [01 · Codex 是什么](/docs/codex/understanding/what-is-codex): 你打开项目，想让 AI 帮你修一个登录失败的 bug：
    - [02 · 一次任务是怎么完成的](/docs/codex/understanding/how-a-task-completes): 你想让 Codex 做一个贪吃蛇小游戏。下面三种说法你会用哪种？
    - [03 · Codex 看到的上下文从哪里来](/docs/codex/understanding/context-engineering): 你直接把这句话扔给 Codex 会怎样？看下面四阶段，Codex 给的答案完全不一样：
    - [04 · 为什么 AGENTS.md 能改变 Codex 行为](/docs/codex/understanding/agents-md-guide): 面向新手解释 AGENTS.md 为什么能让 Codex 更稳定：它是项目和 Agent 的协作接口，不是普通 README。
    - [05 · Codex 为什么需要审批和沙箱](/docs/codex/understanding/sandbox-approval): 想象 Codex 没有边界，会发生什么？
    - [06 · App、IDE、CLI、Cloud 怎么选](/docs/codex/understanding/cli-app-ide-cloud): 很多人一上手就把 4 个入口全装上。真相是不需要 —— 翔宇本人就只用 App + CLI 两件套。看一天怎么过的：
    - [07 · 如何让 Codex 调用工具和访问数据](/docs/codex/understanding/mcp-tools-guide): 任务："给我看下 Stripe 的最新 API，按它写一个支付接入"。
    - [08 · Skills、Subagents、Hooks 解决什么问题](/docs/codex/understanding/skills-subagents-hooks): 回想一下你过去一周，Codex 让你重复做过这些事吗？
    - [09 · 如何控制模型、速度、成本和质量](/docs/codex/understanding/model-cost-speed): 假设你一天用 Codex 做了 5 件事，看不同模型选择策略下的成本对比：
    - [10 · 团队协作和生产环境怎么落地](/docs/codex/understanding/team-production): 把个人使用 Codex 升级到团队和生产环境：共识、边界、集成、自动化、治理五层逐步落地。
    - [11 · 从理解到实战场景](/docs/codex/understanding/from-theory-to-practice): 把模糊需求改写成 Codex 能执行、能验证、能交付的工程任务。
    - [12 · 一句话复盘 Codex 全貌](/docs/codex/understanding/complete-overview): 把 Codex 的入口、上下文、工具、边界、验证和团队落地压成一条新手能复用的决策链。
  - 官方教程中文版
    - [Codex 官方教程中文版](/docs/codex/official): 基于 OpenAI 官方资料，按使用场景重写的 Codex 中文查询手册。
    - 新手必读
      - [新手必读](/docs/codex/official/00-getting-started): 每个新手必读章节都有对应的深度讲解：
      - [理解 Codex 定位](/docs/codex/official/00-getting-started/00-codex-positioning): Codex 是 OpenAI 面向软件开发的 coding agent（编程 Agent）。ChatGPT Plus、Pro、Business、Edu 和 En
      - [快速上手 Codex](/docs/codex/official/00-getting-started/01-quickstart): 基于 OpenAI 官方 Quickstart，帮助新手选择 Codex 入口，并完成第一次安全、可验证的使用。
      - [完成登录和认证](/docs/codex/official/00-getting-started/02-auth): 使用 OpenAI 模型时，Codex 支持两种登录方式：
      - [新手术语速查表](/docs/codex/official/00-getting-started/glossary): 这页给第一次使用 Codex 的中文开发者快速查词。先知道这些词在什么场景出现，再去读对应章节，会比一开始背概念更稳。
      - [第一次安全使用清单](/docs/codex/official/00-getting-started/first-safe-use-checklist): 基于官方 Codex 快速开始和安全教程，面向新手讲清第一次把 Codex 放进真实项目时怎么先读懂、再小改、最后验证。
    - 产品入口
      - [产品入口](/docs/codex/official/01-products): 基于官方 Codex 产品教程，帮新手分清 CLI、IDE、App、Web、Windows 和自动化入口各自适合什么任务。
      - [使用命令行版 Codex](/docs/codex/official/01-products/03-cli): Codex CLI 是 OpenAI 的 coding agent（编程 Agent），可以从你的终端本地运行。它能在你选定的目录里读取代码、修改代码，并运行代
      - [使用桌面版 Codex](/docs/codex/official/01-products/04-app): Codex App 是一个专注的桌面体验，用来并行处理 Codex threads（Codex 线程）。它内置 worktree support（worktre
      - [使用网页版 Codex](/docs/codex/official/01-products/17-web): Codex web 是 OpenAI 的 coding agent（编程 Agent）入口。它可以 read（读取）、edit（编辑）和 run code（运行
      - [安装和使用 IDE 扩展](/docs/codex/official/01-products/20-ide-install): Codex IDE extension 让你在编辑器里直接使用 OpenAI 的 coding agent（编程 Agent）。它可以 read（读取）、edi
      - [掌握 IDE 扩展功能](/docs/codex/official/01-products/21-ide-features): Codex IDE extension 让你在 VS Code、Cursor、Windsurf 和其他 VS Code-compatible editors 中
      - [调整 IDE 扩展设置](/docs/codex/official/01-products/22-ide-settings): Codex IDE extension settings 用来调整 IDE 里的 Codex 使用体验。
      - [使用 IDE 命令](/docs/codex/official/01-products/23-ide-commands): IDE extension commands 可以让你从 VS Code Command Palette（命令面板）控制 Codex。你也可以把这些 comma
      - [使用 IDE 斜杠命令](/docs/codex/official/01-products/24-ide-slash): Slash commands 可以让你不离开 chat input（聊天输入框）就控制 Codex。它们适合查看状态、在 local 和 cloud mode
      - [使用 CLI 斜杠命令](/docs/codex/official/01-products/25-cli-slash): Slash commands 让你用键盘快速控制 Codex CLI。你可以在 composer（输入区）里输入 / 打开 slash popup，然后选择命令
      - [掌握 CLI 功能](/docs/codex/official/01-products/26-cli-features): Codex CLI 不只支持聊天。它还支持恢复会话、远程 TUI、子 Agent、图片输入、图片生成、本地 review、web search、非交互脚本和 c
      - [查询 CLI 参数](/docs/codex/official/01-products/27-cli-args): 本篇是 Codex CLI 的命令与参数参考。它把官方 reference 页面里的交互式配置表改成普通 Markdown 表格，便于在 GitHub 上直接阅
      - [跑非交互任务](/docs/codex/official/01-products/28-non-interactive): 基于官方 Codex non-interactive mode 教程，面向新手讲清 codex exec 适合什么自动化任务、权限怎么给、输出怎么验收。
      - [连接 Codex App Server](/docs/codex/official/01-products/32-app-server): 基于官方 Codex App Server 教程，面向新手讲清它适合什么场景、为什么危险、以及如何从安全边界开始使用。
      - [掌握 App 核心功能](/docs/codex/official/01-products/33-app-core): Codex App 是面向桌面端的 Codex 工作台。它适合同时推进多个 Codex threads，并内置 worktree、automations 和 G
      - [调整 App 设置](/docs/codex/official/01-products/34-app-settings): Codex App 的 settings panel 用来调整 App 行为、文件打开方式，以及外部工具连接方式。
      - [设置 App 自动化任务](/docs/codex/official/01-products/35-app-automation): 基于官方 Codex App Automations 教程，面向新手讲清 automations 适合什么重复任务、worktree 怎么选、权限怎么控。
      - [用内置浏览器验收页面](/docs/codex/official/01-products/36-app-browser): In-app browser 让你和 Codex 在同一个 thread 中共享 rendered web pages 的视图。你在构建或调试 web app
      - [使用 App 命令](/docs/codex/official/01-products/37-app-commands): 这篇整理 Codex App 中常用 commands、keyboard shortcuts、slash commands 和 deeplinks。
      - [让 Codex 操作电脑](/docs/codex/official/01-products/38-computer-use): 在 Codex App 中，Computer Use 目前可用于 macOS。launch 时不面向 European Economic Area、United
      - [配置本地运行环境](/docs/codex/official/01-products/39-local-runtime): Local environments 用来为 worktrees 配置 setup steps，也可以为 project 配置常用 actions。
      - [在 App 中审查改动](/docs/codex/official/01-products/40-app-review): Review pane 帮你理解 Codex 改了什么、给出针对性反馈，并决定哪些改动要保留。
      - [排查 App 问题](/docs/codex/official/01-products/41-app-troubleshoot): 这篇整理 Codex App 常见问题、日志位置和恢复方式。
      - [使用 Windows 版 App](/docs/codex/official/01-products/42-windows-app): Windows App 支持核心工作流：
      - [用 Worktrees 并行开发](/docs/codex/official/01-products/43-worktrees): 在 Codex App 中，worktrees 让 Codex 可以在同一个 project 里并行运行多个 independent tasks，彼此不干扰。
      - [在 Windows 上使用 Codex](/docs/codex/official/01-products/120-windows-codex): Codex 在 Windows 上有三个入口：
    - 规则、安全与配置
      - [规则、安全与配置](/docs/codex/official/02-config-security): ⬅️ 返回 官方教程中文版总目录
      - [编写项目规则文件](/docs/codex/official/02-config-security/05-project-rules): 基于官方 Codex AGENTS.md 和 Rules 教程，面向新手讲清全局规则、项目规则、嵌套覆盖、fallback 文件名和排障方式。
      - [配置 Codex 基础选项](/docs/codex/official/02-config-security/06-basic-config): Codex 会从多个位置读取配置。
      - [设置审批和安全边界](/docs/codex/official/02-config-security/07-approval-security): Codex 会帮助保护你的代码和数据，并降低误用风险。
      - [配置高级能力](/docs/codex/official/02-config-security/29-advanced-config): 当你需要更细地控制 providers（模型供应商）、policies（策略）和 integrations（集成）时，使用高级配置。
      - [查询完整配置项](/docs/codex/official/02-config-security/30-all-config-options): 本篇是 Codex 配置文件的可搜索参考。
      - [参考配置样例](/docs/codex/official/02-config-security/31-config-samples): 用少量 config.toml 配置让 Codex 行为稳定，而不是复制一整份巨型配置。
      - [定制 Codex 行为](/docs/codex/official/02-config-security/48-customize-behavior): Customization 的目标，是让 Codex 按你和团队的工作方式运行。
      - [理解沙箱边界](/docs/codex/official/02-config-security/49-sandbox-boundaries): Sandbox 是让 Codex 能自主行动、但不获得机器 unrestricted access 的边界。
      - [理解网络安全边界](/docs/codex/official/02-config-security/50-network-security): 这些 safeguards 包括训练模型拒绝明显 malicious requests，例如窃取 credentials。
      - [迁移自定义提示到新机制](/docs/codex/official/02-config-security/52-migrate-prompts): Custom prompts 已 deprecated。可复用 instructions 推荐使用 skills，因为 skills 可以由 Codex 显式或
      - [用 Rules 控制命令边界](/docs/codex/official/02-config-security/53-rules-command-control): Rules 用来控制 Codex 可以在 sandbox 外运行哪些 commands。
      - [理解 Codex 安全模型](/docs/codex/official/02-config-security/72-security-model): Codex Security 帮助 engineering 和 security teams 在 connected GitHub repositories 中
      - [配置安全运行环境](/docs/codex/official/02-config-security/73-secure-runtime): 这页带你从 initial access 走到 reviewed findings，以及 Codex Security 中的 remediation pull
      - [排查安全常见问题](/docs/codex/official/02-config-security/74-security-troubleshoot): 这页整理 Codex Security 相关常见问题。新手可以先把它理解成：Codex 用隔离环境分析代码，帮助发现、验证和修复安全风险；它能减少排查成本，但不
      - [改进威胁模型](/docs/codex/official/02-config-security/75-threat-model): 这页说明 threat model 是什么，以及编辑它如何改善 Codex Security 的 suggestions。
    - 扩展能力
      - [扩展能力](/docs/codex/official/03-extensions): ⬅️ 返回 官方教程中文版总目录
      - [接入 MCP 工具和上下文](/docs/codex/official/03-extensions/08-mcp-integration): Model Context Protocol（MCP，模型上下文协议）把模型连接到工具和上下文。
      - [用 Skills 复用能力](/docs/codex/official/03-extensions/09-skills-reuse): 使用 agent skills 可以给 Codex 扩展 task-specific capabilities（面向具体任务的能力）。一个 skill 会打包
      - [用 Subagents 拆分任务](/docs/codex/official/03-extensions/10-subagents-split): 基于官方 Codex Subagents 教程，面向新手讲清什么时候应该并行拆任务、什么时候不该拆，以及如何控制上下文、权限和成本。
      - [用 Hooks 接入自动检查](/docs/codex/official/03-extensions/11-hooks-checks): 基于官方 Codex Hooks 教程，面向新手讲清 hooks 能做什么、不能做什么，以及如何从低风险检查开始。
      - [用 Workflows 编排任务](/docs/codex/official/03-extensions/12-workflows-orchestration): Codex 最适合被当作一个 teammate（队友）来使用：你给它明确上下文，也给它清楚的 done definition（完成定义）。
      - [理解 Subagents 的分工模型](/docs/codex/official/03-extensions/51-subagents-model): Codex 可以通过 spawning specialized agents in parallel 来运行 subagent workflows，让它们并发
      - [使用记忆能力](/docs/codex/official/03-extensions/64-memory): Memories 默认关闭。launch 时，European Economic Area、United Kingdom 和 Switzerland 不可用。
      - [了解 Chronicle 记忆](/docs/codex/official/03-extensions/65-chronicle-memory): Chronicle 目前是 opt-in research preview。
      - [安装和管理插件](/docs/codex/official/03-extensions/68-plugins-manage): Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。
      - [构建自己的插件](/docs/codex/official/03-extensions/69-build-plugins): 基于官方 Codex 插件教程，面向新手讲清插件、skill、marketplace 的边界，以及第一版插件应该怎么安全发布。
    - 模型、价格与效率
      - [模型、价格与效率](/docs/codex/official/04-model-pricing): ⬅️ 返回 官方教程中文版总目录
      - [写好 Codex 提示词](/docs/codex/official/04-model-pricing/13-prompting): 你通过发送 prompts（用户消息）和 Codex 交互。Prompt 描述你希望它做什么。
      - [选择 Codex 模型](/docs/codex/official/04-model-pricing/14-model-selection): Codex 支持多种模型。选模型时，不要只看“哪个最强”，还要看你当前用的是 ChatGPT 登录还是 API key、任务是在本地还是云端、你更在意质量还是速
      - [理解价格和用量](/docs/codex/official/04-model-pricing/15-pricing-usage): Codex 的价格和用量限制取决于你的入口：ChatGPT 个人订阅、Business / Enterprise 工作区，或者 API key。新手最容易混淆的
      - [提升 Codex 响应速度](/docs/codex/official/04-model-pricing/16-speed-up): Codex 的 speed（速度）不是只有“换更快模型”一种方式。官方文档里有两个概念需要分清：
      - [判断功能成熟度](/docs/codex/official/04-model-pricing/57-feature-maturity): 部分 Codex features 会带有 maturity label。这个 label 用来说明该 feature 的可靠程度、可能变化的范围，以及你可以期
      - [阅读使用经验和实践建议](/docs/codex/official/04-model-pricing/63-best-practices): 如果你刚开始使用 Codex，或刚开始接触 coding agents，这篇 guide 可以帮助你更快获得稳定结果。
    - 云端与远程环境
      - [云端与远程环境](/docs/codex/official/05-cloud-remote): 基于官方 Codex 教程，帮新手分清 Cloud、联网权限和远程开发环境各自解决什么问题。
      - [配置云端运行环境](/docs/codex/official/05-cloud-remote/18-cloud-runtime): Cloud environments（云端环境）用来控制 Codex 在执行 cloud tasks（云端任务）时安装什么、运行什么。
      - [管理 Agent 联网权限](/docs/codex/official/05-cloud-remote/19-network-permissions): 基于 OpenAI 官方 Agent internet access 文档，学习新手什么时候该给 Codex 联网权限，以及如何降低风险。
      - [连接远程开发环境](/docs/codex/official/05-cloud-remote/70-remote-dev): SSH remote connections 当前处于 alpha。
    - 团队与集成
      - [团队与集成](/docs/codex/official/06-team-integration): ⬅️ 返回 官方教程中文版总目录
      - [在 CI/CD 中维护认证](/docs/codex/official/06-team-integration/44-cicd-auth): 基于官方 Codex CI/CD 认证教程，面向新手讲清 API key 默认路线、ChatGPT-managed auth 高级路线和 auth.json 的安全边界。
      - [用 GitHub Action 跑 Codex](/docs/codex/official/06-team-integration/45-github-action): 基于官方 Codex GitHub Action 教程，面向新手讲清 openai/codex-action@v1 适合什么 CI/CD 任务、权限怎么给、结果怎么验收。
      - [在开源项目中使用 Codex](/docs/codex/official/06-team-integration/46-open-source-use): 开源维护者经常在幕后承担关键工作，让整个软件生态保持健康。
      - [了解开源项目条款](/docs/codex/official/06-team-integration/47-open-source-terms): 这些 Program Terms 管理由 OpenAI OpCo, LLC 及其 affiliates（统称为 "OpenAI," "we," "our," 或
      - [做企业管理员初始化](/docs/codex/official/06-team-integration/54-enterprise-admin): 这篇面向 ChatGPT Enterprise admins，用来在 workspace 中设置 Codex。
      - [下发托管配置](/docs/codex/official/06-team-integration/55-managed-config): 基于官方 Codex managed configuration 教程，面向新手讲清 requirements、managed defaults、cloud-managed requirements 和企业安全边界。
      - [做治理和可观测](/docs/codex/official/06-team-integration/56-governance-observability): Codex 为 enterprise teams 提供两类能力：
      - [将 Codex 接入 Agents SDK](/docs/codex/official/06-team-integration/58-agents-sdk): 把 Codex 作为 MCP server 暴露给 OpenAI Agents SDK，用于可编排的软件工作流。
      - [建设 AI 原生工程团队](/docs/codex/official/06-team-integration/59-ai-native-team): AI models 正在快速扩大自己能完成的任务范围，这对 engineering 有直接影响。
      - [用 Codex 做 GitHub 代码审查](/docs/codex/official/06-team-integration/60-github-code-review): Codex code review 可以为 GitHub pull requests 增加一轮 high-signal review。
      - [从 Linear 使用 Codex](/docs/codex/official/06-team-integration/61-linear-integration): 你可以在 Linear 中使用 Codex，把 issues 里的工作交给它处理。
      - [从 Slack 使用 Codex](/docs/codex/official/06-team-integration/62-slack-integration): 你可以在 Slack 中使用 Codex，从 channels 和 threads 直接启动 coding tasks。
      - [了解开源入口](/docs/codex/official/06-team-integration/67-open-source-entry): OpenAI 会以 open 的方式开发 Codex 的关键部分。
      - [用 Codex SDK 集成 Agent](/docs/codex/official/06-team-integration/71-codex-sdk): 基于官方 Codex SDK 教程，讲清什么时候该用 SDK、什么时候先用 codex exec，以及新手做团队自动化时最容易踩的坑。
    - 学习路线
      - [学习路线](/docs/codex/official/07-learning-paths): ⬅️ 返回 官方教程中文版总目录
      - [游戏开发路线](/docs/codex/official/07-learning-paths/76-game-dev-path): Codex 结合 image generation，用来创建 browser-based games 和其他类型 games 会很有用。
      - [原生应用开发路线](/docs/codex/official/07-learning-paths/77-native-app-path): 当每一次 pass 都配有 build、run 或 simulator loop 时，Codex 很适合 Apple platform projects。
      - [生产系统路线](/docs/codex/official/07-learning-paths/78-production-path): 这组 use cases 适合 Codex 在已有 history、tests、owners 和 production constraints 的 repo 中
      - [效率与协作路线](/docs/codex/official/07-learning-paths/79-productivity-path): Codex 可以帮助你跨多个 apps 和 files 管理工作，并与团队协作。
      - [Web 开发路线](/docs/codex/official/07-learning-paths/80-web-dev-path): Codex 很适合已有 design systems 的 web projects。它可以结合 constraints 和 visual inputs，生成 r
      - [按场景选择学习路线](/docs/codex/official/07-learning-paths/118-scenario-paths): 官方抓取中的 collections.md 和 tracks.md 内容相同，都是 Codex Use Cases 的集合索引页。这里合并整理成一章，保留场景集
    - 实战场景
      - [实战场景](/docs/codex/official/08-scenarios): ⬅️ 返回 官方教程中文版总目录
      - [实战场景总览](/docs/codex/official/08-scenarios/81-scenarios-overview): 这页是 Codex use cases 总索引。
      - [让 Codex 能调用你的命令行工具](/docs/codex/official/08-scenarios/82-cli-tool-use): 当 Codex 总是要访问同一个 API、日志来源、导出文件、本地数据库或团队脚本时，不要每次都把说明重新贴进对话。更好的做法是给它一个可组合的命令行工具，让它
      - [用 Codex 查询表格数据](/docs/codex/official/08-scenarios/83-tabular-data): 当你手里有 CSV、电子表格、dashboard export、Google Sheet 或本地数据文件，并且只想先回答一个明确问题时，可以直接让 Codex
      - [用 Codex 升级 API 接入](/docs/codex/official/08-scenarios/84-api-upgrade): 当 OpenAI 发布新模型和 API 能力时，升级集成通常不只是把 model name 改掉。API 参数、prompt 写法、tool 假设、respon
      - [用 Codex 做 Bug 分诊](/docs/codex/official/08-scenarios/85-bug-triage): 把每天散落在 Sentry、Slack、Linear、GitHub、PR checks、support tickets、logs 和 dashboards 里的
      - [用 Codex 做浏览器游戏](/docs/codex/official/08-scenarios/86-browser-game): 游戏开发是 Codex 不只生成代码、还要持续验证体验的典型场景。一个真正能玩的浏览器游戏，通常需要概念设计、渲染层、前端 shell、后端状态、素材生成，以及
      - [把你的应用接入 ChatGPT](/docs/codex/official/08-scenarios/87-chatgpt-integration): 把产品带进 ChatGPT，不应该从“把整个产品搬进去”开始。更稳的做法是先选一个明确的用户结果，围绕它设计少量 tools，搭建 MCP server，必要时
      - [整理脏数据并生成可用数据集](/docs/codex/official/08-scenarios/88-data-cleaning): 当 CSV 或 spreadsheet 里混着不同日期格式、货币字符串、重复行、空值、别名和复制进去的汇总行时，不要直接覆盖原文件。把文件拖进 Codex，描述
      - [让 Codex 执行代码迁移](/docs/codex/official/08-scenarios/89-code-migration): 代码迁移不要做成一次性大重写。Codex 适合先盘点 legacy system，再把旧概念映射到新栈，按 checkpoint 落地，每个 milestone
      - [让 Codex 快速读懂大型代码库](/docs/codex/official/08-scenarios/90-large-codebase): 进入陌生 repo 或陌生功能区时，先让 Codex 帮你建立可编辑的地图，而不是只要一段高层总结。目标是弄清 request flow、模块职责、数据验证位置
      - [把聊天消息转成可交付任务](/docs/codex/official/08-scenarios/91-chat-to-task): 很多消息线程里藏着待办：订餐、约时间、查选项、提交票据、整理回复材料。Computer Use 可以读取一个 Messages thread，识别具体请求，再跨
      - [从数据集到分析报告](/docs/codex/official/08-scenarios/92-data-to-report): 数据分析的目标不是“分析本身”，而是产出能帮助别人行动的 artifact：给管理层看的图表、给产品团队看的实验读数、给研究者看的模型评估，或指导日常运营的 d
      - [发布应用或网站](/docs/codex/official/08-scenarios/93-deploy-app): Codex 可以从 repo、screenshot、map、design brief、product note、API doc 或 data source 出发
      - [把用户反馈变成开发任务](/docs/codex/official/08-scenarios/94-feedback-to-task): 当反馈散在 Slack channel、survey export、GitHub issues、Linear queue、research notes 或 Go
      - [把 Figma 设计落成前端代码](/docs/codex/official/08-scenarios/95-figma-to-code): 当你有明确的 Figma frame、component 或 variant 时，Codex 可以从 Figma 拉取结构化设计上下文、assets 和 var
      - [构建适配多端的前端界面](/docs/codex/official/08-scenarios/96-multi-platform-ui): 当你有 screenshots、短 design brief 或几个视觉参考时，Codex 可以把它们变成 responsive UI，并尽量贴合当前 repo
      - [生成汇报幻灯片](/docs/codex/official/08-scenarios/97-report-slides): Codex 可以用 $slides 系统 skill 直接操作 PowerPoint deck，通过 PptxGenJS 创建和编辑 .pptx，再用 $ima
      - [让 Codex 审查 GitHub PR](/docs/codex/official/08-scenarios/98-pr-review): Codex code review 可以在 GitHub pull request 上自动指出 regressions、missing tests、docume
      - [为 iOS App 增加系统动作入口](/docs/codex/official/08-scenarios/99-ios-app-intents): App Intents 能把 iOS app 的动作和内容暴露给 Shortcuts、Siri、Spotlight、widgets、controls，以及新的
      - [适配 Apple Liquid Glass 视觉体系](/docs/codex/official/08-scenarios/100-apple-liquid-glass): 把现有 SwiftUI app 迁移到 Liquid Glass，不应该从“整体重设计”开始。更稳的方式是把它当成 iOS 26 + Xcode 26 migr
      - [在 iOS 模拟器里复现和修 Bug](/docs/codex/official/08-scenarios/101-ios-simulator-bug): 用 Codex 调 iOS bug，最好让它拥有完整 simulator loop：选择 app target，启动 Simulator，检查当前屏幕，执行复现
      - [重构 SwiftUI 界面](/docs/codex/official/08-scenarios/102-swiftui-refactor): 当一个 SwiftUI file 长成巨大的 screen，body 里混着 layout、branching、async work 和 inline acti
      - [用 Codex 反复攻克难题](/docs/codex/official/08-scenarios/103-iterate-on-problems): 有些任务不能一次验证完成。build pass、tests green 就结束的任务很简单；但优化类任务、视觉类任务和主观质量任务，经常需要反复评分、观察 ar
      - [用 Codex 学会新概念](/docs/codex/official/08-scenarios/104-learn-concepts): 从 dense paper 或 course 学一个新概念，不是让 Codex 做摘要。目标是建立可工作的 mental model：它解决什么问题，方法实际做
      - [搭建 Mac 应用基础壳](/docs/codex/official/08-scenarios/105-mac-app-skeleton): 基于 OpenAI 官方 Mac app shell use case，学习如何让 Codex 先搭出真正像桌面应用的 SwiftUI 外壳。
      - [给 Mac 应用补遥测能力](/docs/codex/official/08-scenarios/106-mac-telemetry): 基于官方 Codex macOS telemetry 场景教程，面向新手讲清什么时候加 OSLog、怎么控制范围、怎么从日志证明问题。
      - [精修界面细节](/docs/codex/official/08-scenarios/107-ui-polish): 当 app 主结构已经存在，只需要快速做小的 UI 调整时，可以用 Codex-Spark 进入短循环：一个视觉 note，一个 focused edit，一个
      - [整理收件箱和待办入口](/docs/codex/official/08-scenarios/108-inbox-cleanup): Codex 可以用 Gmail 找出需要你处理的邮件，参考你的最近已发送回复或写作样例，用你的语气起草回复；当邮件上下文不足时，再从 Slack、Google
      - [构建 iOS 应用](/docs/codex/official/08-scenarios/109-ios-app): 用 Codex 做 iOS app，建议保持 CLI-first：greenfield 场景先 scaffold SwiftUI app 和 build-and
      - [构建 macOS 应用](/docs/codex/official/08-scenarios/110-macos-app): 用 Codex 构建 macOS app，要先按 Mac 的 scene、window、menus、settings 和 desktop UX 思考，而不是从一
      - [用 Codex 协调新人入职](/docs/codex/official/08-scenarios/111-onboarding): 新员工入职通常横跨多个系统：accepted-hire list、onboarding tracker、manager/team mappings、accoun
      - [为队友初始化工作环境](/docs/codex/official/08-scenarios/112-team-setup): Codex 在能看到你工作的地方时才更像 teammate：Slack、Gmail、calendar、project trackers、docs、code 和
      - [用 Computer Use 做应用验收](/docs/codex/official/08-scenarios/113-computer-use-qa): Computer Use 适合做真实产品流程 QA：它能看见界面、点击流程、输入字段，并记录哪里失败。适合在 release 前跑关键 user journey
      - [让 Codex 重构代码库](/docs/codex/official/08-scenarios/114-codebase-refactor): 当 codebase 里积累了 unused code、duplicated logic、stale abstractions、large files 或 le
      - [把常用流程沉淀成 Skills](/docs/codex/official/08-scenarios/115-flow-to-skills): 当某个 Codex thread、review rules、test commands、release checklist、design conventions
      - [从 Slack 派发编码任务](/docs/codex/official/08-scenarios/116-slack-dispatch): 当一个 Slack thread 已经有足够上下文，可以直接让 @Codex 从线程里启动 cloud task。任务会绑定到正确 repo 和 environ
      - [让 Codex 操作本机应用](/docs/codex/official/08-scenarios/117-local-app-control): Computer Use 让 Codex 像你一样操作 Mac app：看界面、点击、输入、在窗口之间切换。它适合那些没有专用 plugin、但必须通过普通 a
    - 版本与迁移
      - [版本与迁移](/docs/codex/official/09-versions): ⬅️ 返回 官方教程中文版总目录
      - [迁移到 Codex](/docs/codex/official/09-versions/66-migrate-to-codex): Codex 提供 import flow，可以把另一个 agent 的 instructions、configuration、skills、MCP server
      - [看官方演示视频](/docs/codex/official/09-versions/119-demo-videos): 这一页整理 Codex 官方视频入口。它适合做两件事：
      - [查看版本更新脉络](/docs/codex/official/09-versions/121-changelog): Codex changelog 适合用来确认三类信息：
- 🔥 Hermes Agent
  - [Hermes Agent 中文教程](/docs/hermes): 基于 Nous Research Hermes Agent 官方资料重写的中文教程，作为 Agent 框架横向研究资料。
  - 🧠 从原理到实战
    - [🧠 Hermes Agent 从原理到实战](/docs/hermes/understanding): 从学习闭环、配置、工具、记忆、Skills、消息网关和自动化边界理解 Hermes Agent。
    - [01 · Hermes Agent 是什么](/docs/hermes/understanding/01-what-is-hermes-agent): 理解 Hermes Agent 的定位：CLI、消息网关、记忆、技能、工具和自动化组成的自我改进型 Agent 系统。
    - [02 · 先跑通第一个稳定闭环](/docs/hermes/understanding/02-first-stable-loop): 基于官方 Hermes Getting Started 教程，面向新手讲清安装后先验证 provider、普通对话、session 恢复和最小工具能力。
    - [03 · 配置、Provider 与目录结构](/docs/hermes/understanding/03-configuration-provider): 理解 Hermes 的 ~/.hermes 目录、config.yaml、.env、provider 配置和终端后端。
    - [04 · 工具系统与终端后端](/docs/hermes/understanding/04-tools-terminal-backends): 基于官方 Hermes Tools & Toolsets 教程，面向新手讲清 toolset 和 terminal backend 的分工、风险和选择顺序。
    - [05 · 记忆与召回](/docs/hermes/understanding/05-memory-and-recall): 区分 Hermes 的 curated memory、USER.md、MEMORY.md、session_search 和外部 memory provider。
    - [06 · Skills 系统](/docs/hermes/understanding/06-skills-system): 基于官方 Hermes Skills 教程，面向新手讲清 skill、本地正本、渐进加载、slash command、Hub 安装和 agent-managed skills。
    - [07 · 消息网关](/docs/hermes/understanding/07-messaging-gateway): 基于官方 Hermes Messaging Gateway 教程，面向新手讲清 gateway、session、allowlist、background session 和消息平台风险。
    - [08 · 自动化边界](/docs/hermes/understanding/08-automation-boundaries): 使用 Hermes cron、background、delegation 和 hooks 前，先理解权限、失败面和人工确认边界。
  - 官方教程中文版
    - [Hermes Agent 官方教程中文版](/docs/hermes/official): 基于 Nous Research 官方资料重写的 Hermes Agent 中文查询手册。
    - 入门
      - [安装 Hermes Agent](/docs/hermes/official/00-getting-started/installation): 用一行命令在 Linux、macOS、WSL2 或 Termux 上安装 Hermes Agent，并理解安装后的目录和排障入口。
      - [快速上手 Hermes Agent](/docs/hermes/official/00-getting-started/quickstart): 基于官方 Hermes Getting Started 教程，面向新手讲清安装、模型供应商、第一次对话、session 恢复和下一层能力的最短路径。
      - [规划 Hermes Agent 学习路径](/docs/hermes/official/00-getting-started/learning-path): 按经验等级和使用场景选择 Hermes Agent 文档阅读顺序，避免从 200 多篇官方文档里迷路。
    - 使用手册
      - [使用手册](/docs/hermes/official/01-user-guide): Hermes Agent 配置、消息网关、工具系统、记忆和技能的中文核心要点。
      - [配置 Hermes Agent](/docs/hermes/official/01-user-guide/configuration): 基于 Nous Research 官方 Configuration 文档，帮助新手理解 ~/.hermes、config.yaml、.env 和终端后端的分工。
      - [接入消息网关和平台](/docs/hermes/official/01-user-guide/messaging): 基于官方 Hermes Messaging Gateway 教程，面向新手讲清 Telegram、Discord、Slack、Email 等平台接入、allowlist 和后台任务边界。
      - [配置工具系统和终端后端](/docs/hermes/official/01-user-guide/tools): 基于 Nous Research 官方 Tools & Toolsets 文档，帮助新手理解 Hermes toolset、终端后端、后台进程和权限边界。
      - [使用记忆系统](/docs/hermes/official/01-user-guide/memory): 理解 Hermes 的 MEMORY.md、USER.md、session_search、容量限制和外部 memory provider。
      - [使用技能系统](/docs/hermes/official/01-user-guide/skills): 基于 Nous Research 官方 Skills System 文档，帮助新手理解 Hermes skill 解决什么问题、何时使用、如何安全安装。
- 🦞 OpenClaw 小龙虾
  - [OpenClaw 小龙虾中文教程](/docs/openclaw): 翔宇自研多 Agent 协作框架的中文教程，连接主站个人实践和开源内容源。
  - 🧠 从原理到实战
    - [OpenClaw 从原理到实战](/docs/openclaw/understanding): 10 篇 OpenClaw 小龙虾深度讲解的阅读地图：从 AI 为什么需要一个家，到消息旅程、记忆、Workspace、多 Agent、心跳、安全和设计复盘。
    - [01 · 为什么 AI 需要一个家](/docs/openclaw/understanding/01-ai-home): 从无状态聊天出发，解释 OpenClaw 为什么需要 Gateway、Memory 和 Channel 这三个基础设施。
    - [02 · 一条消息的旅程](/docs/openclaw/understanding/02-message-journey): 拆解一条消息从渠道进入 OpenClaw 到 Agent 回复的完整链路，包括防抖、队列、上下文组装和返回。
    - [03 · Agent 的大脑是怎么工作的](/docs/openclaw/understanding/03-agent-brain): 解释 OpenClaw Agent 的推理、行动、观察循环，以及 Tools、Skills、Hooks 在执行过程中的分工。
    - [04 · 记忆——AI 怎么记住你](/docs/openclaw/understanding/04-memory-system): 用日志层、提炼层和身份层解释 OpenClaw 记忆系统，区分上下文、长期记忆和身份文件。
    - [05 · 上下文——最贵的资源](/docs/openclaw/understanding/05-context-management): 从 token 预算、压缩和剪枝角度理解 OpenClaw 上下文管理，避免关键规则在长会话中丢失。
    - [06 · Workspace——Agent 的灵魂容器](/docs/openclaw/understanding/06-workspace): 讲清 OpenClaw Workspace 的角色，说明 SOUL、AGENTS、USER、TOOLS、HEARTBEAT 和 MEMORY 的边界。
    - [07 · 多 Agent——什么时候拆、怎么协作](/docs/openclaw/understanding/07-multi-agent): 解释 OpenClaw 多 Agent 的拆分信号、绑定路由和协作方式，避免为了复杂而复杂。
    - [08 · Session 与心跳——时间的维度](/docs/openclaw/understanding/08-session-heartbeat): 说明 OpenClaw Session、重置、心跳和 Cron 的区别，帮助新手理解 Agent 如何从被动走向主动。
    - [09 · 渠道与安全——谁能进来、能做什么](/docs/openclaw/understanding/09-channel-security): 从 Channel、allowlist、权限和 prompt injection 出发，建立 OpenClaw 消息入口的安全边界。
    - [10 · 全景设计复盘——为什么 OpenClaw 长这样](/docs/openclaw/understanding/10-design-review): 复盘 OpenClaw 的关键设计取舍，把 Gateway、Memory、Channel、Workspace 和多 Agent 串成完整系统。
  - 官方教程中文版
    - [OpenClaw 官方教程中文版](/docs/openclaw/official): 基于 OpenClaw 官方文档重写的中文教程：安装、Gateway、配置、workspace 和后续开发文档。
    - 入门与安装
      - [入门与安装](/docs/openclaw/official/00-getting-started): 按 OpenClaw 官方文档重写的中文入门路径：安装、onboarding、Gateway、配置和 workspace。
      - [安装 OpenClaw](/docs/openclaw/official/00-getting-started/installation): 基于官方 OpenClaw 安装教程，面向新手讲清推荐安装、Node 要求、替代路径、源码安装和安装后验证。
      - [快速上手 OpenClaw](/docs/openclaw/official/00-getting-started/quickstart): 用 OpenClaw onboarding 跑通 Gateway、Dashboard 和第一条消息。
      - [理解配置结构](/docs/openclaw/official/00-getting-started/configuration): 基于 OpenClaw 官方 Configuration 文档，帮助新手理解 openclaw.json、schema 校验、热加载、密钥和排障顺序。
      - [配置 Agent Workspace](/docs/openclaw/official/00-getting-started/workspace): 基于官方 OpenClaw workspace 教程，面向新手讲清 workspace、运行时状态、记忆文件、私有备份和迁移边界。
    - Gateway 运行时
      - [Gateway 运行时](/docs/openclaw/official/01-gateway-runtime): OpenClaw Gateway、Agent、Channel、安全和自动化的官方教程中文版。
      - [理解 Gateway 架构](/docs/openclaw/official/01-gateway-runtime/architecture): OpenClaw Gateway 的长驻进程模型、WebSocket 控制面、nodes、pairing、远程访问和运行不变量。
      - [配置 Gateway](/docs/openclaw/official/01-gateway-runtime/gateway-configuration): 基于官方 OpenClaw Gateway 配置教程，面向新手讲清 openclaw.json、严格 schema、热加载、重启边界和排障顺序。
      - [配置 Agent](/docs/openclaw/official/01-gateway-runtime/agents): 基于 OpenClaw 官方 agents 配置文档，帮助新手理解 workspace、skills、bootstrap、session 和多 Agent 路由。
      - [配置 Channel](/docs/openclaw/official/01-gateway-runtime/channels): 基于 OpenClaw 官方 channels 配置文档，帮助新手理解 DM、群组、mention、账号和模型覆盖的安全边界。
      - [配置安全与远程访问](/docs/openclaw/official/01-gateway-runtime/security-remote): 基于官方 OpenClaw 安全与远程访问教程，面向新手讲清信任边界、审计、Control UI、Tailscale、SSH tunnel 和共享入口风险。
      - [配置自动化](/docs/openclaw/official/01-gateway-runtime/automation): OpenClaw cron、tasks、task flow、standing orders、hooks 和 heartbeat 的选择边界。
- 🤖 OpenCode
  - [OpenCode 中文教程](/docs/opencode): 基于 OpenCode 官方资料和源码重写的中文教程。
  - 🧠 从原理到实战
    - [🧠 OpenCode 从原理到实战](/docs/opencode/understanding): 从定位、终端工作流、配置、Agent、模型、工具和安全边界理解 OpenCode。
    - [01 · OpenCode 是什么](/docs/opencode/understanding/01-what-is-opencode): 理解 OpenCode 的定位：开源、终端优先、多模型可换、配置开放的 AI Coding Agent。
    - [02 · 安装、连接模型与第一次运行](/docs/opencode/understanding/02-install-first-run): 从安装 OpenCode 到启动 TUI、连接模型供应商、跑通第一轮会话。
    - [03 · 终端 TUI 工作流](/docs/opencode/understanding/03-terminal-workflow): 理解 OpenCode 的 TUI：文件引用、shell 命令、斜杠命令、会话、压缩与 attach。
    - [04 · 配置、Rules 与自定义命令](/docs/opencode/understanding/04-config-rules-commands): 基于官方 OpenCode Config、Rules、Commands 教程，面向新手讲清配置、规则和命令各自沉淀什么经验。
    - [05 · Agents、Skills 与 Plugins](/docs/opencode/understanding/05-agents-skills-plugins): 区分 OpenCode 中的 agent、skill、plugin：角色、能力包和运行时扩展不要混在一起。
    - [06 · 模型与供应商策略](/docs/opencode/understanding/06-model-provider-strategy): 在 OpenCode 中按任务选择 provider 和 model，而不是只追最新模型。
    - [07 · 工具、MCP、LSP 与格式化器](/docs/opencode/understanding/07-tools-mcp-lsp): 理解 OpenCode 如何连接文件系统、shell、MCP server、LSP 和 formatter。
    - [08 · 安全、分享与团队使用](/docs/opencode/understanding/08-security-share-team): 使用 OpenCode 时如何控制权限、网络、会话分享和团队配置边界。
  - 官方教程中文版
    - [OpenCode 官方教程中文版](/docs/opencode/official): 基于 OpenCode 官方资料重写的中文查询手册，按功能分类组织。
    - 入门
      - [入门](/docs/opencode/official/00-getting-started): 开始使用 OpenCode。
      - [使用 CLI](/docs/opencode/official/00-getting-started/cli): OpenCode CLI 选项和命令。
      - [使用 TUI](/docs/opencode/official/00-getting-started/tui): 使用 OpenCode 终端用户界面。
      - [连接 IDE](/docs/opencode/official/00-getting-started/ide): 适用于 VS Code、Cursor 及其他 IDE 的 OpenCode 扩展
      - [分享会话](/docs/opencode/official/00-getting-started/share): 分享您的 OpenCode 对话。
    - 个性化
      - [切换主题](/docs/opencode/official/01-customization/themes): 选择内置主题，或用少量颜色定义自己的 OpenCode 主题。
      - [配置快捷键](/docs/opencode/official/01-customization/keybinds): 用 tui.json 调整少数真正影响效率的 OpenCode 快捷键。
      - [创建自定义命令](/docs/opencode/official/01-customization/commands): 用自定义命令把重复提示词沉淀成可复用入口。
      - [配置 OpenCode](/docs/opencode/official/01-customization/config): 基于 OpenCode 官方 Config 文档，帮助新手理解 opencode.json、配置合并、优先级和最小配置策略。
    - Agents & Skills
      - [配置 Agents](/docs/opencode/official/02-agents-skills/agents): 理解 OpenCode 里的 Build、Plan、Explore、General，以及什么时候创建自己的 Agent。
      - [使用 Agent Skills](/docs/opencode/official/02-agents-skills/skills): 理解 OpenCode Agent Skills：放在哪里、怎么写、什么时候加载，以及权限如何控制。
      - [安装插件](/docs/opencode/official/02-agents-skills/plugins): 理解 OpenCode 插件什么时候该用，以及如何安全扩展运行行为。
      - [编写规则](/docs/opencode/official/02-agents-skills/rules): 基于 OpenCode 官方 Rules 文档，帮助新手理解 AGENTS.md、全局规则、Claude Code 兼容和外部指令文件。
    - 模型与供应商
      - [选择模型](/docs/opencode/official/03-models/models): 基于 OpenCode 官方 Models 文档，帮助新手理解 provider、model、variant 和默认模型的选择边界。
      - [配置模型供应商](/docs/opencode/official/03-models/providers): 基于官方 OpenCode Providers 教程，面向新手讲清 provider、凭据、模型选择、本地模型和自定义 endpoint 的边界。
    - 工具与 MCP
      - [连接 MCP 服务器](/docs/opencode/official/04-tools-mcp/mcp-servers): 为 OpenCode 添加外部工具，并控制上下文和权限成本。
      - [创建自定义工具](/docs/opencode/official/04-tools-mcp/custom-tools): 在 OpenCode 里给模型提供可控、可复用的项目动作。
      - [管理工具](/docs/opencode/official/04-tools-mcp/tools): 管理 LLM 可以使用的工具。
      - [连接 LSP 服务器](/docs/opencode/official/04-tools-mcp/lsp): OpenCode 与你的 LSP 服务器集成。
      - [配置格式化工具](/docs/opencode/official/04-tools-mcp/formatters): OpenCode 使用特定语言的格式化工具。
    - 安全与网络
      - [管理权限](/docs/opencode/official/05-security/permissions): 基于官方 OpenCode Permissions 教程，面向新手讲清 allow、ask、deny、外部目录和 Agent 级权限边界。
      - [配置网络](/docs/opencode/official/05-security/network): 理解 OpenCode 的代理变量、NO_PROXY 和企业自定义证书配置。
    - 集成
      - [接入 GitHub](/docs/opencode/official/06-integrations/github): 在 GitHub Issue 和 Pull Request 中安全地使用 OpenCode。
      - [接入 GitLab](/docs/opencode/official/06-integrations/gitlab): 在 GitLab Issue、Merge Request 和 CI/CD 中使用 OpenCode。
      - [了解生态系统](/docs/opencode/official/06-integrations/ecosystem): 基于 OpenCode 构建的项目与集成。
      - [配置企业版](/docs/opencode/official/06-integrations/enterprise): 在您的组织中安全地使用 OpenCode。
    - SDK & 服务
      - [使用 SDK](/docs/opencode/official/07-sdk/sdk): 基于官方 OpenCode SDK 教程，面向新手讲清 SDK 适合什么集成场景、server/client 怎么理解、结构化输出和错误处理怎么验收。
      - [启动服务器](/docs/opencode/official/07-sdk/server): 通过 HTTP 与 opencode 服务器交互。
      - [在 Web 中使用 OpenCode](/docs/opencode/official/07-sdk/web): 在浏览器中使用 OpenCode。
    - 平台与故障
      - [在 Windows WSL 中使用 OpenCode](/docs/opencode/official/08-platform/windows-wsl): 通过 WSL 在 Windows 上运行 OpenCode 以获得最佳体验。
      - [使用 Zen 模型列表](/docs/opencode/official/08-platform/zen): 由 OpenCode 提供的精选模型列表。
      - [排查故障](/docs/opencode/official/08-platform/troubleshooting): 常见问题及其解决方法。
      - [接入 ACP](/docs/opencode/official/08-platform/acp): 理解 Agent Client Protocol：如何把 OpenCode 接入 Zed、JetBrains 和 Neovim 等编辑器。