Deep Dive into Claude Code
从官方源码到逆向学习，全面理解 Anthropic 的 AI 编程 Agent 是如何构建的。
两套内容，一个目标：掌握 Agent Harness Engineering。
Official · 512K lines · 42 tools · 67 commands
Learn · 12 sessions · Python · Progressive
Star on GitHub · 开源共建
核心理念：Agent 就是模型本身，不是框架，不是 prompt chain。开发者要做的不是「开发 Agent」，而是构建 Harness——让模型与真实世界交互的执行环境：工具、知识、权限和协作机制。
42
Built-in Tools
67
Slash Commands
6
Permission Modes
12
Learning Sessions
390+
UI Components
4
MCP Transports
两套内容体系
Official Source Analysis
基于 Claude Code 官方源码（1,884 TypeScript 文件）的深度拆解。不是抄目录和行号，而是站在用户角度解释每个功能是什么、怎么运行的、机制是什么。
Learn Claude Code (Third-party)
由 ShareAI Lab 打造的逆向学习课程。从 30 行 Python 代码开始，逐步添加 12 层 Harness 机制，最终构建出完整的多 Agent 协作系统。每一课映射回官方实现。
阅读导航
建议顺序：先理解整体架构 → 再看工具和命令的完整功能 → 然后理解上下文和权限 → 最后用 Learn 课程反推机制。
快速概览：一次请求怎么跑完
用户输入
→
命令路由
→
上下文装配
→
LLM + Tool Loop
→
权限检查
→
执行 & 回灌
↻
User Surfaces: CLI / VS Code / JetBrains / Desktop / Web / Remote Control
Slash Command Router
Local Panels & Session Controls
Context Builder
QueryEngine / Agent Loop
Tool Runtime & MCP (42+ tools)
Permissions / Hooks / Classifier
Memory & Transcript
Tasks & Agents
Git Worktree & IDE Bridge
常见问题速答
| 问题 | 答案 |
|---|---|
为什么 / 里只看到十几个命令？ |
67 个命令经过可用性、平台、feature flag、认证和远程安全多层过滤后，当前环境下可见的只是子集。→ 详细解释 |
| 为什么工具列表不是固定 42 个？ | MCP 工具动态加载，ToolSearch 延迟发现，feature flag 控制，deny rules 裁剪。→ 详细解释 |
| Claude 为什么知道我的项目规范？ | 不只是 system prompt——还有 CLAUDE.md、rules、auto memory、skills 和 MCP。→ 详细解释 |
| 为什么有时候像「忘了以前说的话」？ | auto-compact 会把历史替换为摘要。没写进 CLAUDE.md 或 memory 的内容会丢失。→ 详细解释 |
| 6 种权限模式怎么选？ | 日常开发用 plan 或 auto，敏感仓库用 default，CI 用 dontAsk。→ 详细对比 |
| 「Agent 就是模型」是什么意思？ | 不要把智能写在框架里——模型自己会推理和决策。你的工作是构建 Harness（环境）。→ Learn S01 |
关于数据来源：
本手册基于 Claude Code 的公开源码快照（2026-03-31 npm 分发中的 source map 暴露）和 shareAI-lab/learn-claude-code 教学仓库。官方文档参考：code.claude.com/docs。