该资源是一个面向 AI 编程智能体研究的技术资料集合,目标是帮助开发者理解 Claude Code 的内部工作方式,并以此为基础构建自己的编程助手。
用途
该项目定位为“学术研究型”参考集合,重点在于剖析智能体架构,而非提供开箱即用的应用。适用场景包括:研究智能体主循环设计、参考工具系统的组织方式、理解记忆管理与上下文压缩策略,以及借鉴多智能体协调的实现思路。
主要构成
仓库包含四个部分。original-source-code 为原始 TypeScript 源码,共 1,884 个文件。claude-code-source-code 为反编译的 v2.1.88 源码,带有较详尽文档(中英文),约 163,318 行。claw-code 是以 Python 完成的清洁室架构重写,含 109 个文件。nano-claude-code 为最小化的多提供商重实现,约 30 个文件。主源码位于子目录中,仅阅读无需构建;运行 Python 重实现时需要安装依赖。
涉及的核心架构内容
资料中展示了主智能体循环(query.ts 中的异步生成器模式),包含系统提示组装、流式工具执行器、循环调用模型、并行执行工具调用,以及在需要时自动压缩上下文。工具系统方面,介绍了 40 多种工具按类别组织的方式,以及基于 buildTool 的工具定义写法,类别覆盖文件系统、代码、终端、记忆等。记忆系统被描述为分层结构,包括短期、工作上下文、情景、语义、程序性、元认知与离线整合层,并给出向量检索示例。此外还涉及斜杠命令体系(资料称共 87 个命令)及部分命令实现示例。
使用方式
先克隆仓库并进入目录,阅读源码位于各子目录;要运行 Python 重实现,需进入 claw-code 或 nano-claude-code 目录执行 pip install -e 。资料中给出多提供商适配、自定义工具继承 Tool 类、多智能体协调(规划者/执行者/审查者)、记忆增强智能体、技能管理与令牌限制处理等示例代码。相关环境变量示例包括 ANTHROPIC_API_KEY、OPENAI_API_KEY、GOOGLE_AI_API_KEY、GROQ_API_KEY,以及 CLAUDE_MEMORY_DIR、CLAUDE_VECTOR_DB 等记忆配置项。
限制
资料未提供关于收费、价格、平台支持范围、运行效果或性能指标的确切说明;项目描述中提到的源码获取方式与法律合规性未作说明,使用者需自行评估。本介绍仅依据所给资料整理,缺失事实均暂未提供。