Skip to content

Claude Code Java用 Java 从零实现 Claude Code

深入理解 AI Agent 架构的学习型开源项目

PROJECT OVERVIEW

项目核心数字

一个「麻雀虽小,五脏俱全」的完整 AI Agent 实现

>
0+
Java 源文件
完整可运行的代码
0
大模块
清晰的职责划分
0
内置工具
Bash / Read / Edit / Write ...
0+
行核心代码
麻雀虽小,五脏俱全

LIVE DEMO

Agent Loop 如何工作?

Claude 不是一次性给出答案,而是像人一样「思考 → 行动 → 观察 → 再思考」

claude-code-java — Agent Loop

ARCHITECTURE

八大模块,各司其职

单向依赖、零循环 — 清晰的模块化架构设计

🚀
ClaudeCode
程序入口
🧠
core/
AgentLoop 核心引擎
🌐
api/
HTTP + SSE 通信
🔧
tool/
7 个内置工具
🔒
permission/
权限审批
📜
command/
Skill 系统
🔌
mcp/
MCP 外部扩展
💻
cli/
终端 REPL
\u4F9D\u8D56\u5173\u7CFB \u95F4\u63A5\u4F9D\u8D56 hover \u67E5\u770B\u8FDE\u63A5

WHAT YOU'LL LEARN

这个项目能教会你什么?

技能领域你将学到的内容
AI Agent 架构Agent Loop 模式、工具调用协议、stop_reason 驱动的循环控制、Fork 子 Agent
API 集成Claude Messages API、SSE 流式协议、HTTP 重试与错误处理
设计模式接口抽象、注册表模式、Builder 模式、依赖注入、策略模式、适配器模式
Skill 系统结构化提示词注入、YAML frontmatter 解析、Inline/Fork 双模式执行
MCP 协议JSON-RPC 2.0 通信、子进程管理、外部工具服务器集成
系统编程进程管理、文件 I/O、终端交互、并发同步(CountDownLatch)
安全设计最小权限原则、Human-in-the-loop、通配符规则匹配

LEARNING PATH

六阶段学习路径

从全景认知到动手实战,循序渐进掌握 AI Agent 全栈

1
阶段一

全景认知

了解项目是什么、整体怎么运转,建立对 AI Agent 架构的初步认知。

项目简介目录结构模块关系
开始学习 →
2
阶段二

核心引擎

深入 Agent Loop “思考-行动”循环,理解 stop_reason 驱动的循环控制。

AgentLoopForkExecutorstop_reason
查看架构 →
3
阶段三

API 通信与流式处理

学习 SSE 流式协议、StreamAssembler 状态机、HTTP 重试与错误处理。

ClaudeApiClientStreamAssemblerSSE
深入 API 层 →
4
阶段四

工具系统

理解工具抽象设计,学会阅读和扩展 7 个内置工具实现。

Tool 接口ToolRegistryBash/Read/Edit/Write
探索工具 →
5
阶段五

Skill 系统 & MCP 集成

Skill 提示词注入机制、Inline/Fork 双模式执行、MCP 外部工具服务器集成。

SkillLoaderPromptCommandMcpClientJSON-RPC
进入 Skill & MCP →
6
阶段六

安全、状态与界面

权限管理、对话历史、上下文窗口压缩、CLI 终端实现。动手扩展项目!

PermissionManagerConversationHistoryREPL
完成学习 →

前置知识

本文档假设你具备 Java 基础(类、接口、集合框架、Maven),了解 HTTP 基本概念。不需要有 AI 或 LLM 的使用经验。

基于 MIT 许可发布