GitHub - shareAI-lab/mini-claude-code：从 0 到 1 构建你的类似 Cc 的智能体。· GitHub
来源: https://github.com/shareAI-lab/mini-claude-code 抓取时间: 2026-07-21 16:18:59
Mini Claude Code
本仓库已迁移到 learn-claude-code 请访问新仓库获取最新内容和更新。
从零开始构建你自己的编码智能体。 中文文档
这是什么？
一个渐进式教程，揭开像 Kode、Claude Code 和 Cursor Agent 这样的 AI 编码智能体的神秘面纱。 5 个版本，总共约 1100 行，每个版本添加一个概念：
| 版本 | 行数 | 添加内容 | 核心洞察 |
|---|---|---|---|
| v0 | ~50 | 1 个 Bash 工具 | Bash 就是一切 |
| v1 | ~200 | 4 个核心工具 | 模型即智能体 |
| v2 | ~300 | 待办事项跟踪 | 显式规划 |
| v3 | ~450 | 子智能体 | 分而治之 |
| v4 | ~550 | 技能 | 按需领域专业知识 |
快速开始
pip install anthropic python-dotenv
# 配置你的 API
cp .env.example .env
# 用你的 API 密钥编辑 .env
# 运行任何版本
python v0_bash_agent.py # 最小化
python v1_basic_agent.py # 核心智能体循环
python v2_todo_agent.py # + 待办事项规划
python v3_subagent.py # + 子智能体
python v4_skills_agent.py # + 技能
核心模式
每个编码智能体都只是这个循环：
while True:
response = model(messages, tools)
if response.stop_reason != "tool_use":
return response.text
results = execute(response.tool_calls)
messages.append(results)
就是这样。模型调用工具直到完成。其他一切都是细化。
文件结构
mini-claude-code/
├── v0_bash_agent.py # ~50 行：1 个工具，递归子智能体
├── v0_bash_agent_mini.py # ~16 行：极端压缩
├── v1_basic_agent.py # ~200 行：4 个工具，核心循环
├── v2_todo_agent.py # ~300 行：+ 待办事项管理器
├── v3_subagent.py # ~450 行：+ 任务工具，智能体注册表
├── v4_skills_agent.py # ~550 行：+ 技能工具，技能加载器
├── skills/ # 示例技能（用于学习）
└── docs/ # 详细解释（英文 + 中文）
使用智能体构建器技能
本仓库包含一个元技能，教智能体如何构建智能体：
# 搭建新的智能体项目
python skills/agent-builder/scripts/init_agent.py my-agent
# 或使用特定复杂度级别
python skills/agent-builder/scripts/init_agent.py my-agent --level 0 # 最小化
python skills/agent-builder/scripts/init_agent.py my-agent --level 1 # 4 个工具（默认）
安装用于生产的技能
# Kode CLI（推荐）
kode plugins install https://github.com/shareAI-lab/shareAI-skills
# Claude Code
claude plugins install https://github.com/shareAI-lab/shareAI-skills
请参阅 shareAI-skills 了解完整的生产就绪技能集合。
核心概念
v0：Bash 就是一切
一个工具。用于子智能体的递归自调用。证明核心很小。
v1：模型即智能体
4 个工具（Bash、读取、写入、编辑）。一个函数中的完整智能体。
v2：结构化规划
待办事项工具使计划显式。约束启用复杂任务。
v3：子智能体机制
任务工具生成隔离的子智能体。上下文保持干净。
v4：技能机制
SKILL.md 文件按需提供领域专业知识。知识作为一等公民。
深入探讨
技术教程（docs/）：
| English | 中文 |
|---|---|
| v0：Bash 就是一切 | v0：Bash 就是一切 |
| v1：模型即智能体 | v1：模型即代理 |
| v2：结构化规划 | v2：结构化规划 |
| v3：子智能体机制 | v3：子代理机制 |
| v4：技能机制 | v4：Skills 机制 |
| 原创文章（articles/）——仅限中文，社交媒体风格： |
相关项目
| 仓库 | 目的 |
|---|---|
| learn-claude-code | 本项目的新家 |
| Kode | 功能齐全的开源智能体 CLI（生产级） |
| shareAI-skills | AI 智能体的生产就绪技能 |
| 智能体技能规范 | 官方规范 |
用作模板
分叉并自定义用于你自己的智能体项目：
git clone https://github.com/shareAI-lab/learn-claude-code
cd learn-claude-code
# 从任何版本级别开始
cp v1_basic_agent.py my_agent.py
哲学
模型占 80%。代码占 20%。 Kode 和 Claude Code 的工作不是因为巧妙的工程，而是因为模型被训练成智能体。我们的工作是给它工具，然后让开道路。
许可证
MIT
模型即智能体。这就是全部秘密。 @baicai003