claude-code-from-scratch
从零构建类Claude Code的智能体系统架构
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-code-from-scratch。 它的用途是：从零构建类Claude Code的智能体系统架构 完整的 Skill 内容见：https://321skill.com/skills/claude-code-from-scratch/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请参考s05_skill_loading.py，为我解释一下按需加载技能模块是如何减少初始上下文长度的？” 它会引导你分析代码，理解如何通过动态导入工具来优化Token消耗。或者，你可以说：“我想实现一个能并行处理文件分析和网络请求的代理，应该看哪个示例？” 它会建议你重点研究s18_parallel_tools.py中如何使用asyncio.gather来并发执行工具调用。
介绍
这个Skill旨在解决开发者希望构建一个类似Claude Code那样强大、可扩展的AI智能体系统，而非仅仅依赖提示词工程的问题。它提供了一套完整的代码实现，通过从最简单的感知-行动循环开始，逐步迭代到包含工具调度、权限管理、会话持久化等23个模块的生产级系统，展示了如何通过“缰绳工程”来约束和增强AI模型的能力。
使用方式非常直接：开发者可以克隆仓库，按照从01到22的步骤顺序学习和运行代码。每个文件都是一个独立的演进阶段，你可以从最基础的循环开始，逐步添加如子代理隔离、上下文压缩、并行工具执行等高级功能，最终搭建起自己的智能体框架。
它非常适合对AI智能体架构有深度兴趣的开发者，特别是那些不满足于使用现成框架，希望理解底层原理并能够进行定制化开发的工程师、架构师或技术研究者。对于想要将AI深度集成到复杂工作流中的团队，这也是一个极佳的学习和参考项目。
需要注意的是，这不是一个开箱即用的“黑盒”工具，而是一个教学和构建的蓝图。你需要具备一定的Python编程基础，并准备好投入时间理解其架构思想。建议在开发环境中逐步运行和修改代码，以深刻理解每个模块的设计意图。
核心特点
与大多数提供现成API或简单封装的智能体框架不同，本Skill通过23个循序渐进的代码示例，完整揭示了Claude Code背后“缰绳工程”的核心架构思想，让开发者能够从第一性原理理解并亲手搭建一个复杂的生产级智能体系统。
注意事项
不适合希望快速调用一个现成API来完成简单任务的用户，或缺乏Python编程基础的学习者。
常见问题
我需要Anthropic的API密钥才能运行吗？
不完全需要。虽然项目是为配合Claude模型设计的，但其架构思想是模型无关的，你可以替换为其他LLM的接口来学习和运行核心的缰绳逻辑。
这个和直接使用LangChain或AutoGen有什么区别？
LangChain等是封装好的框架，而这是从零开始的构建过程，更侧重于揭示底层架构原理和设计决策，适合深度定制和教学，而非快速应用开发。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-code-from-scratch/raw/index.md 读取 claude-code-from-scratch 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-code-from-scratch/raw/index.md（查看排版版本）