nano-claude-code

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

nano-claude-code 是一个受 Anthropic Claude Code 启发，使用 Golang 从零开始纯手工打造的轻量级 AI 编码智能体（Agent）。

没有 LangChain，没有复杂笨重的 AI 框架。这里甚至连调用 Anthropic 接口的 SDK 都是从零手写的。本项目旨在通过纯粹、清晰的 Go 代码，向你展示如何从最底层的 API 调用开始，一步步构建一个具备自主能力的 AI Agent。

为什么要“从零手搓”？

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

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

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

目录

• day1：从零实现一个claude sdk

Other Version

• nano-claude-code-python

贡献

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

如果你在阅读代码时发现了可以优化的地方，或者你想为这个项目添加一个新功能，发现其中的文档有错误或者可以优化的地方，请随时提交 Pull Request。

1. Fork 本项目
2. 提交你的修改
3. 开启一个 Pull Request
4. @nano-claude-code-maintainer 进行审核