本项目是一个教学导向的开源实践项目。我们将抛弃 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灵魂。
由于这是一个教学项目,非常欢迎各位参与进来!