MiniCC

---

跟随本项目，你将学习 Claude Code 源码，了解当前 SOTA harness engineering 的核心问题与解决方案。

你会先从 **19 个教学 demo** 中一步一步学习关键技术；然后跟随指引，**手动从零搭建一个自己的 mini Claude Code**。

项目背景

不同于 GitHub 上其他复杂庞大的 Claude Code 源码解析资料，本项目更适合广大初学者、学生，旨在由浅入深帮助大家理解 Claude Code 的设计哲学：

	问题	回答
1	为什么想拆解 Claude Code？	Claude Code 作为目前最强大的 Code Agent 系统，其 harness engineering 的设计非常值得学习。通过学习它，我们可以见微知著，弄清 SOTA harness engineering 应该往什么方向走。
2	市面上的教程有什么不足？	现有资料要么太过繁杂冗长，要么缺少实践巩固。而本项目不仅以代码的形式教概念，还会让你一步一步手写一个属于自己的 mini Claude Code！
3	你希望读者获得什么？	不仅仅是了解概念/设计，更要模仿 CC 源码，用 Python 实现一个自己的 Claude Code！Talk is cheap, show me your code!

项目结构

.
├── tutorials/                 # 19 个 Python 教学 demo，由浅入深讲解 CC 核心概念
├── mini_claude_code/          # 手写的 mini 版 Claude Code (Python)
│   ├── guides/                # 13 个模块的学习引导，手把手教你每步怎么写
│   ├── models.py ~ main.py   # 13 个可供参考的实现文件（答案）
│   └── .env                   # API key（不会上传）
├── rust/                      # Claude Code 原始 Rust 源码（供对照阅读）
└── reference/                 # 源码分析参考笔记，感谢 github/openedclaude

Tutorials 速览

19