claude-code-from-scratch

5000行代码手写Claude Code，11章教程吃透agent内核

这是一个从零复现 Claude Code 核心架构的教学型开源项目。针对 Claude Code 开源后代码量庞大（50万行）难以阅读的问题，作者用约5000行 TypeScript/Python 代码，通过11章分步教程，带你理解 coding agent 的精髓。项目核心能力包括：拆解 agent 的规划、工具调用、上下文管理等关键模块，用最小可运行代码演示完整流程，并提供清晰的代码注释和文档。适合想深入理解 AI 编程助手内部原理的开发者，通过动手实践掌握 agent 设计模式，而非停留在 API 调用层面。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2708

维护状态维护中

是否开源是

定价模式 free

项目数据

分类智能体

开发团队Windy3f3f3f3f

所属国家

官网地址https://windy3f3f3f3f.github.io/claude-code-from-scratch/#

GitHubhttps://github.com/Windy3f3f3f3f/claude-code-from-scratch

定价模式free

价格说明开源教程项目，提供在线文档和代码，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,ai-agent,anthropic,build-from-scratch,claude,claude-code,coding-agent,llm,tutorial,typescript

GitHub 星标★ 2708

30天Star增速

HF 下载量

上线时间2026-03-31 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 与 npm（TypeScript 版需要）
Python 3.11+（Python 版需要）
支持 Anthropic 格式或 OpenAI 兼容格式的 API Key
git 用于克隆仓库

安装与启动步骤

1克隆项目仓库

把仓库克隆到本地并进入根目录，后续 npm 命令都在此目录执行。
```
git clone https://github.com/Windy3f3f3f3f/claude-code-from-scratch.git
cd claude-code-from-scratch
```
2构建 TypeScript 版

在根目录安装 npm 依赖并编译，产出可运行的命令行工具。
```
npm install && npm run build
```
3安装 Python 版

进入 python 子目录，用 editable 模式安装，需 Python 3.11+，详见 python/README.md。
```
cd python
pip install -e .
```
4配置 API 密钥

二选一即可，程序按环境变量自动识别后端；Anthropic 格式为推荐方式，base url 可选。
```
export ANTHROPIC_API_KEY="sk-ant-xxx"
export ANTHROPIC_BASE_URL="https://aihubmix.com"
```
5启动 TypeScript 版

在项目根目录运行，进入交互式 REPL 模式（推荐）。
```
npm start
```
6启动 Python 版

在任意目录运行 mini-claude-py，这是 Python 版专用入口，避免与 TS 版命令冲突。
```
mini-claude-py
```

关键配置

配置项	必填	说明	示例
`ANTHROPIC_API_KEY`	是	Anthropic 格式后端的密钥，必填其一	`sk-ant-xxx`
`ANTHROPIC_BASE_URL`	否	Anthropic 格式的自定义 base url（可用代理）	`https://aihubmix.com`
`OPENAI_API_KEY`	否	OpenAI 兼容格式后端的密钥，与上一种二选一	`sk-xxx`
`OPENAI_BASE_URL`	否	OpenAI 兼容格式的接口地址	`https://api.openai.com/v1`
`MINI_CLAUDE_MODEL`	否	指定使用的模型，命令行参数优先级更高	`claude-sonnet-4-6`

如何确认成功

执行 npm start 或 mini-claude-py 后进入交互式 REPL，输入问题能得到模型回复即表示配置成功。

常见问题

Q：TypeScript 版和 Python 版需要都装吗？

A：不需要，两个版本功能对应，任选其一即可。TS 版用 npm install && npm run build 后 npm start 运行，Python 版需 Python 3.11+。

Q：默认使用哪个模型？

A：默认模型为 claude-opus-4-6，可通过环境变量 MINI_CLAUDE_MODEL 或命令行参数 --model 覆盖，如 npm start -- --model gpt-4o。

Q：提示找不到 mini-claude-py 命令怎么办？

A：说明 Python 版未安装。进入项目的 python 子目录执行 pip install -e . 完成安装后，即可在任意目录使用该命令。

Q：不想每次确认危险操作怎么做？

A：加 --yolo 参数跳过安全确认（危险命令会自动执行），或用 --accept-edits 自动批准文件编辑；CI 场景可用 --dont-ask 自动拒绝需确认的操作。

注意事项

本项目是学习项目，参照 Claude Code 公开可观察行为手写，不保证与真实内部实现一致，与 Anthropic 无关联。
--yolo 会跳过安全确认并自动执行危险命令，仅在可信环境中使用。
命令行参数优先级高于环境变量，例如 --model 会覆盖 MINI_CLAUDE_MODEL。
README 提到每个代码章都能一条命令跑起来且不用 API key，具体方式请查看教程中的「每章代码都能跑」一节。

核心亮点

用极简代码（约5000行）复现核心架构，避免50万行源码的阅读负担
11章渐进式教程，从零搭建，每章聚焦一个核心模块，学习路径清晰
TypeScript和Python双语言实现，覆盖不同技术栈开发者

不足之处

仅覆盖核心架构，不包含Claude Code全部功能（如复杂UI、插件系统）
文档/社区待观察

适用场景

想深入理解AI编程助手内部原理的开发者
教学场景：作为coding agent设计的实战教材
研究agent架构，用于设计自己的自动化工具

替代项目

claude-code、open-interpreter、aider

项目介绍

claude-code-from-scratch 是智能体领域的开源项目，由 Windy3f3f3f3f 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,708）位列前 30%，在智能体分类的 2,499 个项目里位列前 15%。

近 45 天，它的 GitHub 星标从 2,538 增加到 2,708，净增 170。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。开源教程项目，提供在线文档和代码，完全免费。从国内网络环境看，可直接访问。

它主要面向的使用场景是：想深入理解AI编程助手内部原理的开发者。同类可对比的替代方案包括 claude-code、open-interpreter、aider。

上一篇：Cradle

下一篇：bitterbot-desktop