用途
how-claude-code-works-analysis 是一个面向 Claude Code 内部架构的专家知识技能，隶属于 reason-machines/claude-code-skills 合集（来源标注为 ara.so 的 Claude Code Skills 集合）。它基于对 Claude Code 超过 512,000 行 TypeScript 代码库的深入分析，目标是帮助使用者理解生产级 AI 编程智能体的设计、参照其思路实现类似功能，并利用 Claude Code 的高级能力。
项目构成
资料显示该项目包含以下几部分：
- 15 个专题章节，覆盖架构、智能体循环、上下文工程、工具、权限、多智能体系统与 UX 等；
- 带图示与代码引用的交互式文档站点；
- 配套实现项目 claude-code-from-scratch，包含可运行的 TypeScript/Python 示例；
- 经数百万日活用户验证的生产级模式。
主要能力与核心概念
核心智能体循环
资料描述为双层架构：高层的 QueryEngine 管理会话（把消息加入历史、构建带压缩的上下文、调用 Claude API、解析响应流、并行执行工具、处理 7 个续接点）；底层的 StreamingToolExecutor 处理并发（并行执行只读工具、串行化写操作、在模型仍在生成时预执行工具）。
7 个续接点用于故障恢复：ContextLengthExceeded（压缩后重试）、MaxTokensReached（从 4K 升级到 64K 上限）、ToolError（注入错误并继续循环）、UserInterrupt（保存状态、允许恢复）、RateLimitHit（指数退避）、ValidationFailure（回滚并重新规划）、CompactionNeeded（触发压缩管线）。
4 级上下文压缩管线
接近上下文上限时逐步执行：
- Trim（快速、0 次 API 调用）：截断旧工具输出到 1000 字符；
- Dedupe（近乎零成本）：按内容哈希去重；
- Fold（保留原始内容、可展开）：折叠不活跃对话片段并保留元数据；
- Summarize（1 次 API 调用）：由子智能体压缩对话，并在压缩后自动恢复最近 5 个被编辑的文件等内容。
资料强调压缩后需自动恢复：最近 5 个被编辑文件（完整内容）、正在使用的活跃技能、当前工作上下文。
工具系统架构
66+ 工具遵循统一接口，包含 name、description、parameters（ZodSchema）、execute 方法，以及 execution engine 所需元数据：readonly（为真可并行）、requiresApproval（触发权限检查）、tokenBudget（最大输出大小）。示例 read_file 工具在内容超过 100K 字符时自动压缩，将完整内容写入临时文件并返回摘要与访问说明。
5 层安全模型
- 权限模式（Full / Limited / ReadOnly / Ask）；
- 基于规则的过滤（allowPatterns、denyPatterns）；
- 基于 AST 的 shell 分析（23 项检查，含命令注入、环境变量泄漏、文件系统风险、网络访问、提权等）；
- 带防抖（200ms）的用户确认；
- Hook 校验（用户自定义规则，可拒绝或修改工具输入，如添加 --dry-run）。
多智能体协调
三种模式：子智能体（父等待子，隔离 worktree，可继承上下文后合并）、协调者（不能直接使用工具，只能委派）、群体（对等消息传递）。
使用方式
资料说明可通过在项目根目录放置 CLAUDE.md 自定义行为，内容包括项目上下文、自定义工具、权限规则（ALLOW / DENY / REQUIRE_CONFIRM）、技能优先级与记忆。文档还给出常见模式示例：流式查询与工具预执行、上下文预算管理、编辑前强制读取（Edit-Before-Read、反幻觉校验）。
高级用法与排查
高级部分涉及自定义 Hook 实现（如禁止周五部署）与提示缓存策略（对系统提示和 CLAUDE.md 标记 cache_control、检测缓存失效）。故障排查覆盖：上下文超限（诊断压缩管线各层并强制压缩）、工具未执行（检查注册工具与权限模式）、记忆未持久（检查记忆系统并手动触发提取）、启动缓慢（确保并行初始化）。
资源与环境变量
资料列出的资源包括文档站点、源码分析仓库、实现指南仓库与 15 个深入章节主题。环境变量包括 ANTHROPIC_API_KEY（API 访问所需）、CLAUDE_MODEL（可选自定义模型）、DEBUG_AGENT_LOOP / DEBUG_COMPRESSION / DEBUG_TOOLS（可选调试）。
限制
资料未提供该项目的价格、收费方式、平台支持范围、具体性能数据或实测效果等信息，上述内容暂未提供。本简介仅依据现有资料整理，未对其功能做额外推断。