mini-claude-code
一个用于学习和理解编程Agent核心机制的简化Java项目。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mini-claude-code。 它的用途是：一个用于学习和理解编程Agent核心机制的简化Java项目。 完整的 Skill 内容见：https://321skill.com/skills/mini-claude-code/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析这个业务数据集，并生成一份可视化报告。” 它会启动一个具备工具调用能力的Agent，先规划任务步骤（Todo），然后调用数据读取、清洗、分析和图表生成等工具，最终完成任务并输出报告。在这个过程中，你可以通过观察其内部的Agent Loop和Hook机制，理解它是如何“思考”和“行动”的。
介绍
mini-claude-code 是一个简化版的Java版Claude Code编程Agent实现。它旨在帮助开发者快速理解复杂AI Agent的内部工作原理，通过剥离非核心代码，聚焦于Agent Loop、工具调用、权限控制等核心机制。
项目将编码Agent的复杂功能拆解为16个独立章节，每个章节对应一个Git分支，并提供了最小化的可运行Demo。用户可以通过切换分支，循序渐进地学习每个模块的实现，例如从最基础的“思考-行动-观察”循环开始，逐步深入到多Agent协作、记忆系统等高级主题。
它非常适合对AI Agent底层原理感兴趣的后端开发、智能体开发者和高校学生，尤其适合那些希望深入理解而非仅仅调用API的开发者。通过阅读和运行这些精简的代码，可以清晰地把握Agent框架的设计脉络。
使用前请确保已安装Java 17和Maven，并提前配置好兼容Anthropic API的LLM服务密钥。建议按照章节顺序学习，从s01-agent-loop分支开始，逐步深入。
核心特点
与直接提供可部署Agent的仓库不同，本项目核心价值在于“教学”，通过极简代码和分章节拆解，将复杂的Agent框架黑盒透明化，让学习者能一步步构建出对Agent系统的完整认知。
注意事项
本项目主要用于教学和原理理解，并非一个开箱即用、功能完备的生产级Agent框架。
常见问题
这个项目需要Claude API吗？
需要兼容Anthropic API的LLM服务（如DeepSeek等），并配置相应的API Key和Base URL。
适合完全没有Agent基础的开发者吗？
非常适合，项目从最基础的Agent Loop开始讲解，代码精简，注释清晰，便于入门。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mini-claude-code/raw/index.md 读取 mini-claude-code 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mini-claude-code/raw/index.md（查看排版版本）