本文档集整合了 Claude Code 官方最佳实践仓库的全部内容，按"从安装到精通"的学习路径组织。无论你是第一天安装 Claude Code，还是想掌握 Agent Teams、跨模型工作流等高级用法，都能在这里找到对应的入口。

Claude Code 最佳实践：完整知识体系导航

学习路径

初学者路径:  install → settings → commands → skills → subagents → memory
进阶路径:    orchestration → agent-command-skill → why-harness → agent-teams
工作流路径:  scheduled-tasks → cross-model-workflow → tips-boris → tips-thariq

---

一、入门

文档	核心内容
install.md	macOS/Windows/Linux 安装步骤 + 三种登录认证方式
cli-startup-flags.md	claude 命令行参数详解：-p、--model、--add-dir、--bare 等
settings.md	四层 settings 体系、37 个配置项、84 个环境变量、team/enterprise 策略

---

二、核心功能

2.1 扩展能力

文档	核心内容
commands.md	Slash Commands 的创建、触发方式、参数传递、嵌套调用
skills.md	Skills 的文件夹结构、frontmatter 配置、9 种类型分类、与 Commands 的区别
subagents.md	Subagents 的调用方式、上下文隔离机制、工具限制、模型路由
memory.md	CLAUDE.md + Auto-memory + /memory 命令的三层记忆体系
mcp.md	MCP 服务器配置、.mcp.json 多范围设置、常用 MCP 清单
power-ups.md	Hooks 配置、Plan Mode、Sandbox、Output Styles、Status Line 等进阶功能

2.2 Agent 记忆与团队

文档	核心内容
agent-memory.md	Agent memory frontmatter 配置、user/project/local 三种 scope、MEMORY.md 自动注入机制
agent-teams.md	Agent Teams（实验性）vs Subagents 的核心区别、tmux 分屏配置、协调机制

---

三、架构与高阶用法

文档	核心内容
orchestration.md	Command → Agent → Skill 三层调用架构、编排模式设计
agent-command-skill.md	Command/Agent/Skill 三者的精确定位、何时选哪个、组合方式
why-harness.md	Harness 层的 10 种独有能力（上下文隔离/工具限制/懒加载/Hooks/模型路由/并行等），为什么强 Prompt 无法替代

---

四、工作流进阶

文档	核心内容
scheduled-tasks.md	/loop（本地 session 级、最长 7 天）vs /schedule（云端 Routines）的选择与配置
cross-model-workflow.md	Claude Code + Codex CLI 四阶段协作工作流（Plan → QA Review → Implement → Verify）

---

五、实战经验精选

文档	核心内容
tips-boris.md	Boris Cherny（Claude Code 创始人）50+ 条实战 Tips 的主题整合：并行化、Plan Mode、CLAUDE.md 投资、Hooks、PR 管理、Opus 4.7 新功能
tips-thariq.md	Thariq（Claude Code 团队）Session 管理决策树（rewind/compact/clear/subagent）+ Skill 工程 9 类型 9 原则

---

快速参考：选哪个扩展机制？

需要做什么？
├─ 把常用操作变成一条命令（/commit-push-pr）
│   └─ Slash Command（.claude/commands/）
│
├─ 封装可复用的领域知识 + 脚本 + 按需 Hooks
│   └─ Skill（.claude/skills/）
│
├─ 将子任务在隔离上下文中执行，只要结论
│   └─ Subagent（.claude/agents/ + Agent 工具）
│
├─ 需要跨 session 持久化记忆
│   └─ Agent Memory（frontmatter memory: user/project/local）
│
├─ 集成外部服务（Slack/GitHub/数据库）
│   └─ MCP 服务器（.mcp.json）
│
└─ 需要确定性生命周期行为（格式化/拦截/路由审批）
    └─ Hooks（settings.json hooks 字段）

---

快速参考：Session 管理决策

情境	操作
同一任务，上下文仍有价值	Continue（继续）
Claude 走了错路，想保留文件读取	Rewind（双击 Esc）
任务继续但 session 被调试噪音撑大	/compact <hint>
开始全新任务	/clear + 手写 brief
下一步只需要子任务的结论	Subagent

---

快速参考：何时用 Plan Mode

任务复杂度评估
├─ 简单 bug 修复 / 单文件修改 → 直接实现
├─ 中等功能（影响 2-5 个文件）→ 可选 Plan Mode
└─ 复杂功能（多模块/数据迁移/关键路径）→ 必须 Plan Mode
    ├─ Shift+Tab × 2 进入
    ├─ 与 Claude 来回讨论直到计划满意
    └─ 切换 auto-accept-edits 实现

---

关于本文档集

本文档集基于 claude-code-best-practice 官方仓库整理，来源包括：

• Best Practice 文档（命令/技能/子代理/内存/设置/MCP）
• Tutorial Day 0（安装指南）
• Boris Cherny 在 2026 年 1—4 月间发布的 7 个 Tips 线程
• Thariq 在 2026 年 3—4 月间发布的 2 篇实践指南
• 特别专题（orchestration、harness、agent-teams、跨模型工作流、定时任务）

所有文档均保留完整的技术深度，不是摘要，而是可供直接参考的操作指南。