05AICoding-ClaudeCode整体架构与功能概览
05AICoding-ClaudeCode整体架构与功能概览
- 0 Claude Code 架构全景
- 1 内置工具系统： Agent的执行引擎
- 2 多级记忆系统：跨会话的知识沉淀
- 3 项目管理系统：Checkpoint回滚与安全保障
- 4 斜杠命令系统：Agent的控制面板
- 4.1 会话管理
- 4.2 模型与模式
- 4.3 项目与上下文
- 4.4 配置与状态
- 4.5 扩展与Agent
- 4.6 账户与平台
- 4.7 信息与反馈
- 4.8 内置 Skills（以斜杠命令形式触发）
- 5 扩展能力系统：MCP、Skills与Plugin
- 6 多 Agent 协作系统：从独狼到团队
- 小结
安装Claude Code后，在逐一深入每个功能之前，有必要先建立一个全局视角——Claude Code作为一个工业级 Agent 系统，内部到底由那些模块构成？它们之间如何协作？本文将以“快速巡览”的方式，介绍每个核心模块。
0 Claude Code 架构全景
从宏观上看，Claude Code 的架构图可以拆分为六大核心系统，各自承担不同的职责，共同构成一个完整的 Agent 工作闭环：
| 系统 | 核心职责 | 类比 |
|---|---|---|
| 内置工具系统 | 读写文件、执行命令、搜索代码——Agent的“手脚” | 工人手中的工具箱 |
| 多级记忆系统 | 跨会话保留项目规范、开发偏好——Agent的“长期记忆” | 工人的笔记本和经验手册 |
| 扩展能力系统 | MCP / Skills / Plugin 三套扩展机制——Agent的“技能树” | 工人获取新技能的培训体系 |
| 项目管理系统 | Checkpoint 回滚、Git集成、安全沙箱——Agent的“安全网” | 工地的安全绳和施工记录 |
| 斜杠命令系统 | 50+内置命令控制 Agent 行为——Agent的“控制面板” | 驾驶舱的仪表盘和操控杆 |
| 多 Agent 协作系统 | Sub-Agent 委托、后台任务、Team协作——Agent 的“团队” | 项目经理分派任务给专业团队 |
理解这张架构图的关键在于：**这六大系统并非各自独立运行，而是以 LLM （大语言模型）为中枢，在每一次任务执行中动态协作。**举一个直观的例子：
当你对 Claude Code 说“帮我给这个项目添加一个用户功能”时，实际发生的过程是：
- 1.记忆系统先读取 CLAUDE.md，了解项目的技术栈和代码规范
- 2.内置工具（Grep/Glob/Read）扫描代码库，理解现有架构
- 3.斜杠命令判断是否进入 Plan Mode 先规划再执行
- 4.内置工具（Write/Edit/Bash）创建文件、编写代码、运行测试
- 5.项目管理系统在每次文件变更时自动创建 Checkpoint
- 6.如果任务复杂，可能委托 Sub-Agent并行处理前端和后端
- 7.如果需要查询数据库 Schema，可能调用MCP Server获取信息
接下来逐一巡览每个系统的核心能力。在每个系统的介绍中，都安排了一个简单的动手实验——这些实验彼此关联，串成一条完整的体验链路，帮你快速建立对 Claude Code 核心能力的直观感受。
实验准备：在开始之前，请先创建一个练习项目目录，后续所有实验都在这里进行：
mkdir41claude-labcd41claude-lab claude
1 内置工具系统： Agent的执行引擎
内置工具是 Claude Code 与外部世界交互的唯一通道——模型本身不能直接操作文件系统或执行命令，所有操作都必须通过工具调用（Tool Use）完成。Claude Code 内置了以下核心工具：
| 工具 | 功能 | 典型场景 |
|---|---|---|
| Read | 读取文件内容（支持代码、图片、PDF） | 阅读代码、查看配置文件、分析截图 |
| Write | 创建新文件或完整覆写 | 创建新组件、写入配置文件 |
| Edit | 精准编辑文件的指定部分（基于字符串匹配替换） | 修改函数逻辑、更新导入语句 |
| Bash | 在 Shell 中执行任意命令 | 运行测试、安装依赖、Git操作 |
| Grep | 基于正则表达式搜索文件内容 | 查找函数定义、追踪变量引用 |
| Glob | 按文件名模式匹配搜索文件 | 查找所有.tsx组件、定位配置文件 |
| Think | 模型内部推理（不产生外部操作） | 复杂逻辑规划、多方案权衡 |
| Agent | 启动 Sub-Agent 处理子任务 | 并行处理独立任务、深度代码探索 |
| WebSearch | 搜索互联网获取最新信息 | 查询 API 文档、搜索错误解决方案 |
| WebFetch | 获取指定 URL 的内容 | 读取在线文档、下载配置模版 |
实际效果示例：当你说“帮我把utils/format.ts里的日期格式从YYYY-MM-DD改成DD/MM/YYYY”，Claude Code实际会依次调用Read(读取文件)->Edit（定位并替换格式字符串）->Bash(运行pnpm test确认测试通过)，整个过程在几秒内完成。
动手试一试：用 Claude Code 生成你的第一个页面
在41claude-lab目录的 Claude Code 会话中，输入一下内容：
请在当前目录创建一个 index.html 文件——一个“Claude Code学习实验室”页面。 要求：深色主题（背景色 #13111C，文字白色），包含一个大标题、当前日期、以及一个“实验进度”列表区域（暂时留空，后续实验会逐步填充）。观察终端输出——你会看到 Claude Code 调用了Write工具创建文件，可能还会调用Bash工具确认文件是否正确生成。整个过程不到 10 秒。双击打开 index.html ，一个深色主题的页面已经呈现在浏览器中。