尧图网页设计 
Dive into Claude Code 学习路径全清单从逆向分析到开源复现AI Agent新人快速上手指南【免费下载链接】Dive-into-Claude-CodeA Systematic Analysis and Discussion of Claude Code for Designing Todays and Future AI Agent Systems项目地址: https://gitcode.com/gh_mirrors/di/Dive-into-Claude-CodeDive into Claude Code 是一个对 Claude CodeAI 编程智能体进行源码级逆向分析的开源项目它剖析了约 51.2 万行 TypeScript 代码的架构设计并整理了面向 AI Agent 新人的完整学习路径。本文带你按论文 → 架构 → 循环 → 权限 → 复现五步走完这条学习路线从看懂一个 while 循环到理解生产级智能体的全部工程细节。一句话核心发现Claude Code 代码库里只有1.6% 是 AI 决策逻辑其余98.4% 都是确定性基础设施——权限门控、上下文管理、工具路由和恢复逻辑。智能体循环本身只是一个 while 循环真正的工程复杂度在它周围的系统里。3 分钟上手获取仓库与定位你的起点如果你是第一次接触这个项目只需两步1️⃣ 克隆仓库只读学习即可无需修改任何内容git clone https://gitcode.com/gh_mirrors/di/Dive-into-Claude-Code2️⃣ 打开中文总入口 README_zh.md它把全部内容分成了来自论文和论文之外两大板块并附有一份按角色分流的阅读指南如果你是……建议从这里开始然后深入️ Agent 构建者架构总览 → 架构深度剖析docs/architecture_zh.md 安全研究员安全与权限章节七个独立安全层 产品经理关键亮点价值观与设计原则 研究人员完整论文 PDFpaper/Dive_into_Claude_Code.pdf下面这张高层结构图是全文的地图先记住这 7 个组件的位置关系后面每一步都是对其中一块的放大第一步架构总览 —— 5 层 21 个子系统全景拿到地图后先建立分层概念。整个系统自上而下分为 5 层每一层都有明确的职责边界层职责关键组件表层 Surface入口与渲染交互 CLI、Headless CLI、Agent SDK、IDE核心层 Core上下文组装与循环queryLoop、5 阶段压缩管道安全/行动层权限与工具7 个权限模式、auto 模式分类器、27 个钩子事件、Shell 沙箱状态层 State运行时状态与持久化JSONL 转录稿、CLAUDE.md 层级、记忆后端层 Backend执行环境Shell 执行、MCP 连接、外部资源新人要点所有入口CLI、SDK、IDE最终都汇聚到同一个queryLoop。这意味着理解一个执行引擎就等于理解了整个产品——这是学习时最值得抓的主线。第二步智能体循环 —— 10 分钟看懂 ReAct while 循环很多教程一上来就讲多智能体、讲编排其实第一步该看懂的是最简单的东西一轮对话是怎么跑完的。Claude Code 的核心循环是一个经典的ReAct 模式 while 循环组装上下文 → 调用模型 → 分派工具 → 检查权限 → 执行 → 重复直到模型不再调用工具。每轮遵循一条9 步管道设置解析 → 状态初始化 → 上下文组装 → 条件式上下文管理 → 模型调用 → 工具分派 → 权限门控 → 工具执行 → 停止条件检查。图中有三个细节值得注意它们正是98.4% 基础设施的缩影上下文压力触发压缩模型调用前会依次检查 5 个阶段——预算缩减 → Snip → Microcompact → Context Collapse → Auto-Compact各阶段按自己的条件生效而不是一刀切截断权限被拒不是死路Deny会带着拒绝反馈进入下一轮迭代模型据此调整路径5 种恢复机制兜底token 上限放宽最多重试 3 次、反应式压缩、提示过长处理、流式回退、备用模型切换。 想深挖每一步的源码落点直接读 docs/architecture_zh.md 的轮次执行9 步管道一节。第三步权限系统 —— 7 个模式与拒绝优先原则Agent 能执行命令、改文件权限设计就是安全设计。Claude Code 的答案是拒绝优先deny ask allow宽范围的拒绝规则永远覆盖窄范围的允许规则最严格的规则获胜。系统提供了7 个权限模式构成一条渐进式信任光谱用户随使用深入逐步爬坡模式行为信任级别plan执行前用户批准所有计划⭐ 最低default标准交互批准⭐⭐acceptEdits文件编辑自动批准⭐⭐⭐autoML 分类器评估工具安全性⭐⭐⭐⭐dontAsk无提示仍强制执行拒绝规则⭐⭐⭐⭐⭐bypassPermissions跳过大多数提示保留关键安全检查最高bubble内部模式子智能体向父级上报特殊新人要点权限检查一共布了7 个独立安全层工具预过滤 → 规则评估 → 模式约束 → auto 分类器 → Shell 沙箱 → 会话级状态 → 钩子拦截任何一层独立失效都不致命——这种深度防御思路值得在设计自己的 Agent 时直接借鉴。第四步上下文、记忆与子智能体委托模型每次调用能看到什么决定了它做多长的任务不迷路。这部分是区分玩具 Agent和生产级 Agent的关键。上下文窗口由 9 个有序来源拼装其中项目指令通过4 级 CLAUDE.md 层级注入托管/etc/→ 用户~/.claude/→ 项目CLAUDE.md→ 本地CLAUDE.local.md记忆采用文件式设计而非向量数据库LLM 扫描记忆文件的文件头最多挑选 5 个相关文件注入上下文——没有嵌入、没有向量相似度内容可以打开、编辑、纳入版本管理。子智能体Subagent委托则解决大任务拆小任务的问题6 种内置类型Explore、Plan、General-purpose、Guide、Verification、Statusline 自定义.claude/agents/*.md。子智能体拥有隔离的上下文侧链转录稿单独保存其历史只把简短结论返回给父级从而控制进入主上下文的信息量。新人要点SkillTool 与 AgentTool 是两套不同的扩展原语——前者把指导注入当前上下文后者把工作委派到隔离上下文。理解这个区别是理解多智能体系统成本模型的第一步。第五步可扩展性与开源复现 —— 从看懂到动手4 种扩展机制3 个注入点Hooks、Skills、Plugins、MCP 四种机制作用于循环中的三个位置assemble()模型看到什么、model()能调用哪些工具、execute()动作如何执行。工具池按 5 步组装基础枚举最多 54 个工具→ 模式过滤 → 拒绝预过滤 → MCP 集成 → 去重。开源复现对照源码加深理解读懂分析后社区已有大量净室重写和可构建的研究分支可供对照练习如 Rust 净室实现、Python 重写、可运行逆向 CLI 等。仓库 README 中按类别整理了完整清单包括类别适合做什么架构分析逆向工程报告、prompt 语料库对照本文理解各模块边界开源重新实现找一个小规模实现跑起来验证循环与权限设计指南与学习课程19 章 0-to-1 课程等从零写一个最小 AgentHarness 工程资料把循环外围系统当作一门学科来学 完整索引见 README_zh.md 的社区项目与研究章节版本核查与证据边界记录在 docs/agent-design-space-source-notes_zh.md学术论文原文见 paper/Dive_into_Claude_Code.pdf。学习路径速查表一页记住五步步骤学什么对应资料1️⃣ 全景5 层架构、7 组件、四个设计问题README_zh.md · docs/architecture_zh.md2️⃣ 循环ReAct while 循环、9 步管道、5 压缩阶段架构文档轮次执行节3️⃣ 权限拒绝优先、7 模式、7 安全层、auto 分类器架构文档权限系统深度剖析节4️⃣ 记忆9 来源上下文、CLAUDE.md 层级、子智能体隔离架构文档上下文与记忆节5️⃣ 动手开源复现 论文精读社区资源清单 · paper/Dive_into_Claude_Code.pdf最后提醒这个项目的真正价值不是Claude Code 有多复杂而是给你一套可迁移的方法论——5 个价值观 → 13 条设计原则 → 具体实现任何 AI Agent 新人设计自己的系统时都可以用同样的框架去追问每个决策为什么这么做。按上面五步走完你就具备了从使用 Agent进阶到设计 Agent的完整视角。【免费下载链接】Dive-into-Claude-CodeA Systematic Analysis and Discussion of Claude Code for Designing Todays and Future AI Agent Systems项目地址: https://gitcode.com/gh_mirrors/di/Dive-into-Claude-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Dive into Claude Code 学习路径全清单：从逆向分析到开源复现，AI Agent新人快速上手指南
Dive into Claude Code 学习路径全清单从逆向分析到开源复现AI Agent新人快速上手指南【免费下载链接】Dive-into-Claude-CodeA Systematic Analysis and Discussion of Claude Code for Designing Todays and Future AI Agent Systems项目地址: https://gitcode.com/gh_mirrors/di/Dive-into-Claude-CodeDive into Claude Code 是一个对 Claude CodeAI 编程智能体进行源码级逆向分析的开源项目它剖析了约 51.2 万行 TypeScript 代码的架构设计并整理了面向 AI Agent 新人的完整学习路径。本文带你按论文 → 架构 → 循环 → 权限 → 复现五步走完这条学习路线从看懂一个 while 循环到理解生产级智能体的全部工程细节。一句话核心发现Claude Code 代码库里只有1.6% 是 AI 决策逻辑其余98.4% 都是确定性基础设施——权限门控、上下文管理、工具路由和恢复逻辑。智能体循环本身只是一个 while 循环真正的工程复杂度在它周围的系统里。3 分钟上手获取仓库与定位你的起点如果你是第一次接触这个项目只需两步1️⃣ 克隆仓库只读学习即可无需修改任何内容git clone https://gitcode.com/gh_mirrors/di/Dive-into-Claude-Code2️⃣ 打开中文总入口 README_zh.md它把全部内容分成了来自论文和论文之外两大板块并附有一份按角色分流的阅读指南如果你是……建议从这里开始然后深入️ Agent 构建者架构总览 → 架构深度剖析docs/architecture_zh.md 安全研究员安全与权限章节七个独立安全层 产品经理关键亮点价值观与设计原则 研究人员完整论文 PDFpaper/Dive_into_Claude_Code.pdf下面这张高层结构图是全文的地图先记住这 7 个组件的位置关系后面每一步都是对其中一块的放大第一步架构总览 —— 5 层 21 个子系统全景拿到地图后先建立分层概念。整个系统自上而下分为 5 层每一层都有明确的职责边界层职责关键组件表层 Surface入口与渲染交互 CLI、Headless CLI、Agent SDK、IDE核心层 Core上下文组装与循环queryLoop、5 阶段压缩管道安全/行动层权限与工具7 个权限模式、auto 模式分类器、27 个钩子事件、Shell 沙箱状态层 State运行时状态与持久化JSONL 转录稿、CLAUDE.md 层级、记忆后端层 Backend执行环境Shell 执行、MCP 连接、外部资源新人要点所有入口CLI、SDK、IDE最终都汇聚到同一个queryLoop。这意味着理解一个执行引擎就等于理解了整个产品——这是学习时最值得抓的主线。第二步智能体循环 —— 10 分钟看懂 ReAct while 循环很多教程一上来就讲多智能体、讲编排其实第一步该看懂的是最简单的东西一轮对话是怎么跑完的。Claude Code 的核心循环是一个经典的ReAct 模式 while 循环组装上下文 → 调用模型 → 分派工具 → 检查权限 → 执行 → 重复直到模型不再调用工具。每轮遵循一条9 步管道设置解析 → 状态初始化 → 上下文组装 → 条件式上下文管理 → 模型调用 → 工具分派 → 权限门控 → 工具执行 → 停止条件检查。图中有三个细节值得注意它们正是98.4% 基础设施的缩影上下文压力触发压缩模型调用前会依次检查 5 个阶段——预算缩减 → Snip → Microcompact → Context Collapse → Auto-Compact各阶段按自己的条件生效而不是一刀切截断权限被拒不是死路Deny会带着拒绝反馈进入下一轮迭代模型据此调整路径5 种恢复机制兜底token 上限放宽最多重试 3 次、反应式压缩、提示过长处理、流式回退、备用模型切换。 想深挖每一步的源码落点直接读 docs/architecture_zh.md 的轮次执行9 步管道一节。第三步权限系统 —— 7 个模式与拒绝优先原则Agent 能执行命令、改文件权限设计就是安全设计。Claude Code 的答案是拒绝优先deny ask allow宽范围的拒绝规则永远覆盖窄范围的允许规则最严格的规则获胜。系统提供了7 个权限模式构成一条渐进式信任光谱用户随使用深入逐步爬坡模式行为信任级别plan执行前用户批准所有计划⭐ 最低default标准交互批准⭐⭐acceptEdits文件编辑自动批准⭐⭐⭐autoML 分类器评估工具安全性⭐⭐⭐⭐dontAsk无提示仍强制执行拒绝规则⭐⭐⭐⭐⭐bypassPermissions跳过大多数提示保留关键安全检查最高bubble内部模式子智能体向父级上报特殊新人要点权限检查一共布了7 个独立安全层工具预过滤 → 规则评估 → 模式约束 → auto 分类器 → Shell 沙箱 → 会话级状态 → 钩子拦截任何一层独立失效都不致命——这种深度防御思路值得在设计自己的 Agent 时直接借鉴。第四步上下文、记忆与子智能体委托模型每次调用能看到什么决定了它做多长的任务不迷路。这部分是区分玩具 Agent和生产级 Agent的关键。上下文窗口由 9 个有序来源拼装其中项目指令通过4 级 CLAUDE.md 层级注入托管/etc/→ 用户~/.claude/→ 项目CLAUDE.md→ 本地CLAUDE.local.md记忆采用文件式设计而非向量数据库LLM 扫描记忆文件的文件头最多挑选 5 个相关文件注入上下文——没有嵌入、没有向量相似度内容可以打开、编辑、纳入版本管理。子智能体Subagent委托则解决大任务拆小任务的问题6 种内置类型Explore、Plan、General-purpose、Guide、Verification、Statusline 自定义.claude/agents/*.md。子智能体拥有隔离的上下文侧链转录稿单独保存其历史只把简短结论返回给父级从而控制进入主上下文的信息量。新人要点SkillTool 与 AgentTool 是两套不同的扩展原语——前者把指导注入当前上下文后者把工作委派到隔离上下文。理解这个区别是理解多智能体系统成本模型的第一步。第五步可扩展性与开源复现 —— 从看懂到动手4 种扩展机制3 个注入点Hooks、Skills、Plugins、MCP 四种机制作用于循环中的三个位置assemble()模型看到什么、model()能调用哪些工具、execute()动作如何执行。工具池按 5 步组装基础枚举最多 54 个工具→ 模式过滤 → 拒绝预过滤 → MCP 集成 → 去重。开源复现对照源码加深理解读懂分析后社区已有大量净室重写和可构建的研究分支可供对照练习如 Rust 净室实现、Python 重写、可运行逆向 CLI 等。仓库 README 中按类别整理了完整清单包括类别适合做什么架构分析逆向工程报告、prompt 语料库对照本文理解各模块边界开源重新实现找一个小规模实现跑起来验证循环与权限设计指南与学习课程19 章 0-to-1 课程等从零写一个最小 AgentHarness 工程资料把循环外围系统当作一门学科来学 完整索引见 README_zh.md 的社区项目与研究章节版本核查与证据边界记录在 docs/agent-design-space-source-notes_zh.md学术论文原文见 paper/Dive_into_Claude_Code.pdf。学习路径速查表一页记住五步步骤学什么对应资料1️⃣ 全景5 层架构、7 组件、四个设计问题README_zh.md · docs/architecture_zh.md2️⃣ 循环ReAct while 循环、9 步管道、5 压缩阶段架构文档轮次执行节3️⃣ 权限拒绝优先、7 模式、7 安全层、auto 分类器架构文档权限系统深度剖析节4️⃣ 记忆9 来源上下文、CLAUDE.md 层级、子智能体隔离架构文档上下文与记忆节5️⃣ 动手开源复现 论文精读社区资源清单 · paper/Dive_into_Claude_Code.pdf最后提醒这个项目的真正价值不是Claude Code 有多复杂而是给你一套可迁移的方法论——5 个价值观 → 13 条设计原则 → 具体实现任何 AI Agent 新人设计自己的系统时都可以用同样的框架去追问每个决策为什么这么做。按上面五步走完你就具备了从使用 Agent进阶到设计 Agent的完整视角。【免费下载链接】Dive-into-Claude-CodeA Systematic Analysis and Discussion of Claude Code for Designing Todays and Future AI Agent Systems项目地址: https://gitcode.com/gh_mirrors/di/Dive-into-Claude-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考