mini-claude-code

English | 简体中文

姊妹版：

• mini-spring (简化版的spring框架)
• mini-spring-cloud (简化版的spring cloud框架)
• mini-netty (简化版的netty框架)

关于

mini-claude-code 是一个简化版的Java版 Claude Code 编程 Agent 项目，能帮助你快速理解编码 Agent 的核心原理。项目抽取了 Agent Harness 的关键机制，代码尽量精简，保留核心功能，如 Agent Loop、工具调用、权限控制、Hooks、Todo、Subagent、Skill Loading、上下文压缩、记忆系统、任务系统、后台任务、定时调度、多 Agent 协作、团队协议、自主认领任务和 MCP Plugin 等功能。

项目按章节拆解一个编码 Agent 的核心机制，每章对应一个独立分支，并尽量保留理解当前机制所需的最小代码。

如果本项目能帮助到你，请给个 STAR，谢谢！

功能

• s01 Agent Loop — ReAct：思考-行动-观察，LLM ⇄ Tool 闭环
• s02 Tool Dispatch — Tool Use：注册即用，不改主循环
• s03 Permission — Guardrails：三层校验，先审后执行
• s04 Hooks — Lifecycle：四个事件点，横切逻辑不侵入循环
• s05 Todo — Planning：先规划再执行，状态可追踪
• s06 Subagent — Delegation：委托子代理，上下文干净隔离
• s07 Skill Loading — Lazy Skill Loading：索引在 Prompt，正文按需加载
• s08 Context Compact — Context Compression：四层压缩管线，满了就腾空间
• s09 Memory — Long-term Memory：记什么、忘什么、何时合并
• s10 Task System — Task Orchestration：任务图 + 状态机 + 依赖检查
• s11 Background Tasks — Async：慢操作丢后台，Agent 继续思考
• s12 Cron Scheduler — Scheduled Trigger：cron 表达式，无人值守触发
• s13 Agent Teams — Multi-Agent：Lead 派活，队友并行干活
• s14 Team Protocols — Structured Communication：request_id + 状态机，队友间结构化通信
• s15 Autonomous Agents — Self-Organization：队友扫看板，有活自己认领
• s16 MCP Plugin — MCP：动态工具池，能力不够插上就用

使用方法

1. 准备环境

本项目需要 Java 17 和 Maven。

运行真实模型 demo 前，先在 shell 中设置：

export ANTHROPIC_BASE_URL='你的 Anthropic 兼容 API Base URL，如: https://api.deepseek.com/anthropic'
export MODEL_ID='你的模型 ID'
export ANTHROPIC_API_KEY='你的 API Key'

2. 切换章节分支

每章对应一个教学分支。比如学习 s01：

git switch s01-agent-loop

3. 启动 Demo

使用 Maven 启动指定 demo：

mvn -q compile exec:java -Dexec.mainClass=org.miniclaudecode.demo.S01AgentLoopDemo

4. 阅读源码说明

阅读 changelog.md

提问

点此提问

贡献

欢迎 Pull Request。

参考项目

• learn-claude-code(强烈推荐)