Build Your Own
Claude Code

从零构建 Claude Code 的核心引擎 — 你写的代码，驱动真实的 Claude Code。
6 个渐进式 Lab，亲手实现 Agent Harness。

开始学习 → GitHub

AI Coding Agent 是怎么工作的？

Claude Code、Cursor Agent 这些 AI 编程工具的能力 = 大模型 + Agent Harness。 大模型提供智能，而 Harness — 消息协议、工具系统、Agent Loop、上下文管理 — 才是让 Agent 真正能完成复杂编码任务的关键。

60% 大模型 (Model) 提供智能、理解意图、生成代码
40% Agent Harness 消息协议 · 工具系统 · Agent Loop · 上下文管理

本项目通过 6 个渐进式 Lab，带你亲手实现这个 Harness。

6 个 Lab，渐进式掌握

每个 Lab 完成后，Claude Code TUI 的能力都会发生可见变化。

Lab 0 环境与体验 安装运行完整 Claude Code。先体验终点，再动手构建。 Lab 1 让 Agent 会说话 API 调用，文字回复。Agent 说话了，但不能做任何事。 Lab 2 给 Agent 一双手 工具注册与执行。Agent 用了一次工具，然后停了。 Lab 3 Agent Loop while(true) 循环。Agent 自主循环，多轮调用工具。整个项目最重要的 Lab。 核心 Lab 4 规划与子 Agent TodoWrite + Subagent。Agent 先列计划再执行，会拆子任务。 Lab 5 上下文压缩 三层压缩策略。Agent 处理超长对话不崩溃。

项目特点

基于真实 Claude Code 源码

416,500 行 TypeScript，而非玩具实现。你写的代码会插入真实系统运行。

渐进式反馈

每个 Lab 完成后，TUI 的能力都会发生可见变化，像打游戏解锁技能。

测试驱动

Mock LLM 测试确保结果确定可验证，不依赖 API Key 也能完成所有 Lab。

终极体验

你的代码插入真实 416K 行系统中运行。看到完整 TUI 响应你的指令时，核心引擎是你自己写的。

准备好开始了吗？

只需 Node.js 和基本的 TypeScript 知识，Lab 3 live demo 才需要 API Key。

git clone https://github.com/cookiesheep/build-your-own-claude-code.git
cd build-your-own-claude-code
npm install
# 从 Lab 0 开始你的旅程

从 Lab 0 开始 →