Claude Code Cookbook
面向小白到 Platform Engineer 的 Claude Code 系统学习、日常手册、Agent Engineering 与企业部署参考。内容以 Claude Code 官方文档为准。
Claude Code Cookbook
一份面向从第一次使用用户到企业平台工程师的 Claude Code 系统学习手册。内容覆盖：安装登录、日常开发、Agentic 扩展（Skills / Subagents / Hooks / MCP / Plugins）、多 Agent 编排、Agent SDK、以及企业级部署与安全治理。
所有技术事实以 Claude Code 官方文档（https://code.claude.com/docs）为准，验证日期 2026-08-11。
怎么读（Start Here）
- 完全新手 → 安装与首次运行、Mental Model、交互模式
- 日常开发者 → CLAUDE.md、权限、沙箱、日常开发工作流
- 高级开发者 → Skills、Subagents、Hooks、MCP、Plugins
- Agent 工程师 → Agent SDK、构建自定义 Agent、Headless
- 平台工程师 → 企业级管理、企业级基础设施、可观测性、安全
按问题查找（Search by Problem）
| 你想解决 | 看这篇 |
|---|---|
| Claude 总是不遵守项目规范 | CLAUDE.md、Auto Memory |
| Context 太大 | Context Engineering、大型代码库 |
| 复用一套 Prompt | Skills |
| 要一个 Code Review Agent | Subagents、Code Review & CI |
| 并行处理多个任务 | Parallel Agents、Worktrees |
| 连接公司 API | MCP |
| 每次修改后自动检查 | Hooks |
| 做自己的 Agent App | Agent SDK |
| 限制危险操作 | Permissions、Sandbox、Security |
学习路线（Learning Paths）
- 🟢 Beginner：安装 → 首次会话 → 修改代码 → Review Diff → 理解权限 → 恢复会话
- 🟡 Practitioner：CLAUDE.md → Rules → Auto Memory → Settings → Permissions → Sandbox → Skills → Sessions
- 🔴 Advanced：Subagents → Parallel Agents → Worktrees → Hooks → MCP → Plugins → Scheduling
- 🟣 Enterprise：Authentication → Providers → Managed Settings → Managed MCP → Security → Gateway → Observability
目录
全部文章见左侧目录（tree）。全书分为：
- 开始（Getting Started） — 概念、安装、平台、交互
- 日常开发（Daily Development） — CLI、CLAUDE.md、记忆、Context、设置、工具、权限、沙箱、会话、检查点、工作流、Prompt、自主执行
- 扩展与自动化（Extensions & Automation） — Skills、Subagents、多 Agent、Hooks、MCP、Plugins、Channels、调度
- 平台与集成（Platform & Integrations） — Git、Code Review & CI、Web/Desktop/Mobile、Browser & Computer Use
- Agent 工程（Agent Engineering） — Headless、Agent SDK、自定义 Agent、模型配置
- 企业级（Enterprise） — 认证、成本、性能、安全、安全画像、管理、基础设施、可观测性
- 参考（Reference） — 故障排查、最佳实践、反模式、Recipe、实战项目、速查表、术语表
维护
- 本 wiki 依据项目根目录的
CLAUDE.md/AGENTS.md约束维护。 - 想更新到最新官方文档：把
docs/00-research/UPDATE-PROMPT.md的提示词发给 Claude，或用/update-cookbook。 - 版本敏感内容记录在
references/version-audit.md。
