claude-code-handbook

一句话定位

把 Claude Code 从"会用"推到"造得出"的实战知识库。

不是官方文档的复读，也不是学术论文的堆砌。这里有三样东西：

1. 使用手册 — 让你把 Claude Code 用得更稳、更快、更省心
2. 实践配方 — 直接可用的 Skill、Agent 示例和配置模板
3. Agent Runtime 工坊 — 手把手从零实现一个 Claude Code 风格的 Coding Agent

适合谁

• 👨‍💻 个人开发者：想建立一套稳定的 AI 辅助开发工作流
• 🏗️ AI 全栈工程师：需要把 Claude Code 接入复杂项目和企业流程
• 🚀 团队负责人：想参考小米等组织的 AI Coding 工程化实践
• 🔧 Agent builders：计划深入 Agent Runtime，从使用者走向建造者

四大板块

📘 使用手册

8 部分 24 章，从安装配置到高级技巧。

• 核心工作流（刘小排 / Matt Pocock / 徐文浩）
• 小米 AI Coding 工程化实践
• 记忆、上下文、Skills、Hooks、MCP
• 权限、隔离、失败模式

→ 进入手册

🧰 实践配方

可直接用的代码、配置和模板。

• Agent 示例代码
• SKILL.md 模板（agent-builder / code-review / mcp-builder / pdf）
• Claude Code 中英学习文档
• 主流 Agent Harness 对照参考

→ 查看配方

🛠️ Agent Runtime 工坊

10 章教程 + Python 参考实现。

• 从 LLM 客户端到 Agent 主循环
• 工具系统、权限、上下文、记忆
• Skill、SubAgent、Agent Teams

→ 开始工坊

🏗️ Harness 笔记

Agent Harness 架构学习与整理。

• OpenCode / Codex / DeerFlow 对照
• Claude Code Runtime 机制拆解
• Harness 设计模式总结

→ 查看笔记

📚 内容地图

使用手册

实践配方

Agent Runtime 工坊

参考实现：mewcode/

🚀 快速开始

完全新手：

手册第1章（认识它）
  → 第4章（会话管理）
  → 第5章（项目级配置）
  → 第6章（核心工作流）

想亲手造一个 Agent：

工坊 ch-01 → ch-02 → ch-03 → ch-04
        ↓
  ch-06 → ch-08 → ch-09
        ↓
  ch-11 → ch-13 → ch-15

想提升稳定性：

手册第7章（五层安全开发闭环）
  → 第10章（记忆系统）
  → 第11章（上下文窗口管理）
  → 第24章（常见失败模式与修复）

团队落地：

手册第9章（小米 AI Coding 工程化实践）
  → 第17-19章（多任务 / Worktree / 流水线）
  → 第20-21章（权限与隔离）

📁 仓库结构

.
├── docs/
│   ├── assets/          # 横幅、插图、小米实践配图
│   ├── manual/          # 8 部分使用手册
│   ├── recipes/         # 可复用配方：agents / skills / docs / source-analysis
│   └── workshop/        # Agent Runtime 工坊教程
│       └── chapters/
├── harness/             # Agent Harness 学习笔记
├── mewcode/             # Python 版 Agent Runtime 参考实现
├── AGENTS.md            # 仓库维护规范
├── LICENSE              # MIT
└── README.md            # 本文件

📝 命名规范

• 目录：kebab-case（part-01-overview、query-loop-deep-dive）
• Markdown 文件：kebab-case
• Python 模块：snake_case
• 避免：中文文件名、空格

⚠️ 声明

本仓库内容为学习、实践与经验沉淀，所有引用素材均已标注来源。本仓库不包含任何受版权保护的原始商业源码。

⭐ Star History