nano-claude-code-typescript

本项目是一个教学导向的开源实践项目。我们将抛弃 LangChain、抛弃 LlamaIndex，甚至抛弃官方 SDK，仅使用 TypeScript 语言标准库（以及少量辅助库），在 7 天内从零开始，一行行写出一个Claude-Code like Coding Agent。

nano-claude-code-typescript 是一个受 Anthropic Claude Code 和 nano-claude-code 启发，使用 TypeScript 从零开始纯手工打造的轻量级 AI 编码智能体（Agent），并且考虑安全性，不使用axios而是使用原生的 fetch API。

为什么要“从零手搓”？

现在的 AI 封装库越来越厚重，当 Agent 陷入死循环、工具调用失败、或者上下文丢失时，新手往往不知所措。

作为教学项目，nano-claude-code-python 将带你亲自趟过这些坑：

• 亲自手写底层 SDK，搞懂 LLM 接口的 JSON Schema 长什么样。
• 亲自解析 SSE 流式响应，体验在终端打印“打字机”效果的快感。
• 亲自写一个 for 循环来实现 Agent 的“观察 -> 思考 -> 行动”（ReAct）闭环。
• 亲自赋予 LLM 读写本地文件和执行 Bash 命令的危险而强大的能力。
• 亲自设计一个TODO架构的Agent。
• 亲自设计subAgents架构。
• 亲自完成skills框架的设计，包括加载，调用。
• 亲自参与压缩流程的设计，完成一个简单的压缩机制。
• 亲自设计一个Tasks系统，深入了解Agent怎么设计task的依赖和规划。
• 亲自实现一个Backgroud Tasks机制。
• 亲自实现多智能体架构。
• 亲自实现记忆机制，对话记录持久化，赋予Agent灵魂。

QuickStart

git clone https://github.com/TIC-DLUT/nano-claude-code-typescript.git
cd .\nano-claude-code-typescript\
code .

pnpm install
pnpm start

目录

• day1: 从零实现一个claude sdk

Other Version

• nano-claude-code

• nano-claude-code-python

贡献

由于这是一个教学项目，非常欢迎各位参与进来！

详细贡献指南