Claude From Scratch
从零开始构建你的 AI 编程助手。不是阅读源码，而是亲手实现—— 13 章渐进式教程，从第一个可运行的 CLI 程序到企业级功能， 深入理解 Claude Code 的架构设计、实现原理与工程哲学。
为什么学习这个项目？
AI 编程助手正在改变软件开发的方式。但使用工具和理解工具是完全不同的层次——当你亲手构建一个 Claude Code，你不仅学会了一门技术，更掌握了一种思考方式。
🎯 理解本质，而非 API
不是学习如何调用 API，而是理解 LLM 如何与代码交互、如何设计 Tool 系统、如何实现 Agent 协作。这些知识在任何技术栈都适用。
🏗️ 系统架构思维
从权限设计到配置管理，从缓存策略到流式渲染，学习如何构建可维护、可扩展的系统级应用。
🔧 解决真实问题
每个章节都解决一个真实问题：如何让 AI 安全地执行命令？如何管理上下文窗口？如何实现并发 Agent？
学习路径
本教程分为三个阶段，循序渐进地构建你的 AI 编程助手：
基础篇
从零开始，5 章内容构建可运行的 MVP。你会理解 Claude Code 最核心的工作原理。
- CLI 框架 — 搭建命令行交互骨架
- LLM 连接 — 实现流式对话与响应处理
- 文件操作 — 让 AI 读懂你的项目
- Bash 执行 — 安全地执行系统命令
- 代码编辑 — 实现 Diff 与文件修改
核心篇
构建生产级基础设施。这是 Claude Code 区别于简单 Demo 的核心能力。
- 工具系统 — 类型安全、可扩展的 Tool 框架
- 权限管理 — 多层安全体系与审批流程
- Agent 系统 — Fork/Resume 与并行执行
- 配置系统 — 企业级分层配置管理
- 消息流 UI — 流式渲染与交互组件
高级篇
性能优化与生产部署。让你的助手在真实环境中稳定运行。
- 性能优化 — 智能缓存、Token 优化、成本监控
- MCP 协议 — 连接外部系统与数据源
- 企业部署 — 私有化部署与运维监控
设计思想
Claude Code 的设计遵循几个核心原则，这些原则贯穿整个教程：
Fail Closed 默认安全
任何可能危险的操作默认需要确认。不是选择性地添加安全检查，而是默认拒绝、显式允许。
工具即接口
LLM 通过 Tools 与外部世界交互。良好的 Tool 设计是系统能力的边界。
Context 即货币
Token 是有限的资源。每一次调用都需要考虑：这是否值得？是否有更优方式？
人机协作
AI 不是替代人类，而是增强人类。好的设计让人在关键节点做出决策。
适合谁学习？
- 有 Node.js/TypeScript 基础的开发者 — 想深入理解 AI 编程助手的工作原理
- 技术团队负责人 — 需要评估或内部部署 AI 辅助编程工具
- 全栈工程师 — 希望掌握 LLM 应用开发的系统架构知识
- 开源爱好者 — 想贡献或定制自己的 AI 编程工具
技术栈
- TypeScript — 类型安全，良好的 IDE 支持
- Node.js — 成熟的运行时生态
- CLI 框架 — Commander.js 处理命令解析
- LLM API — Anthropic / OpenAI / DeepSeek 兼容
开始学习
无需准备复杂的开发环境，只需 Node.js 和一个 API Key，你就可以开始构建。
📚 快速导航
- Ch1: 搭建 CLI 骨架 — 创建项目结构，完成第一次运行
- Ch2: 连接大脑 — 接入 LLM，实现流式对话
- Ch3: 读取世界 — 文件系统操作
- Ch4: 执行命令 — 安全执行 Bash
- Ch5: 编辑代码 — 完成 MVP
- Ch6: 工具系统 — 类型安全的工具框架
- Ch7: 权限管理 — 多层安全体系
- Ch8: Agent 系统 — 并行与协调
- Ch9: 配置系统 — 企业级配置
- Ch10: 消息流 UI — 流式渲染
- Ch11: 性能优化 — 缓存与 Token 优化
- Ch12: MCP 协议 — 连接外部系统
- Ch13: 企业部署 — 私有化部署