Java Edition · JDK 1.8

Learn Claude Code

learn_claude_code_by_java v1.0

Created by arrayadd

12 节渐进式课程，从一个 while 循环到完整的多 Agent 团队系统。
每一课都是独立的 main() 方法，运行即学。

◈ Core Philosophy 核心哲学

Agent 是模型。不是框架。不是提示词链。不是拖拽式工作流。

模型做决策，Harness 执行。模型做推理，Harness 提供上下文。模型是驾驶者，Harness 是载具。你不是在编写智能——你是在构建智能栖居的世界。

Claude Code 是我们所见过的最优雅的 agent harness 实现。它没有试图成为 agent 本身，没有强加僵化的工作流，没有用决策树替模型做判断——它给模型提供了工具、知识、上下文管理和权限边界，然后让开了。

Harness = Tools + Knowledge + Observation + Action + Permissions 文件读写产品文档 git diff CLI命令沙箱隔离 Shell 领域资料错误日志 API调用审批流程网络 API规范浏览器状态 UI交互信任边界

本教程的 12 节课，每一课在同一个 while 循环之上叠加一个 harness 机制。循环属于 Agent，机制属于 Harness。循环始终不变——变的是你给 Agent 的能力边界。

"造好 Harness，Agent 会完成剩下的。"

⚙ Architecture Map 架构全景

一个 while 循环 + 12 层 Harness 机制 = 完整的 Agent 系统。下图展示核心循环与各机制的关系。

Phase 0: Prerequisites

Anthropic Messages API 前提知识

Agent 运行的底层协议：请求字段、响应结构、工具定义

"POST /v1/messages is all you need."

Phase 1: Foundations

Agent Loop 核心循环

整个 AI Agent 的秘密就在一个 while 循环里

"The model is the agent."

Tool Dispatch 工具分发

循环没变，只是加了工具 Map

"The loop didn't change at all."

TodoWrite 任务追踪

Agent 能追踪自己的进度，而且你能看到

"Nag, don't control."

Subagent 子代理

进程隔离天然带来上下文隔离

"Fresh context, summary-only return."

Phase 2: Memory & State

Skill Loading 技能加载

别把所有东西塞进 system prompt，按需加载

"Two-layer: catalog + on-demand."

Context Compact 上下文压缩

策略性遗忘，从而永远工作下去

"Forgetting is a feature."

Task System 任务系统

状态存在对话之外，不怕上下文压缩

"State that survives compression."

Background Tasks 后台任务

发射即忘，Agent 不会因为命令还在跑就卡住

"Fire and forget."

Phase 3: Multi-Agent

Agent Teams 代理团队

能互相交谈的队友，JSONL 邮箱通信

"Teammates that talk to each other."

Team Protocols 团队协议

同一个 request_id 关联模式，两个领域

"request_id correlation pattern."

Autonomous Agents 自主代理

Agent 自己找活干，IDLE 轮询 + 自动认领

"The agent finds work itself."

Worktree Isolation 工作树隔离

按目录隔离，按任务 ID 协调

"Isolate by directory, coordinate by task ID."

Quick Start

# 1. 编辑配置文件 src/main/resources/claude.properties
ANTHROPIC_API_KEY=sk-ant-xxxxx      # 填入你的 API Key
ANTHROPIC_BASE_URL=https://api.anthropic.com  # 或第三方代理地址
MODEL_ID=claude-sonnet-4-20250514   # 可选，默认即可

# 2. 在 IDE 中直接运行 main 方法（推荐）
打开任意课程的 Java 文件，点击 main() 旁的运行按钮即可