diff --git a/README.md b/README.md
index 5a065c2..e6a4ad4 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
+> **📌 仓库分支说明**
+>
+> 本仓库包含三个独立分支，围绕 Claude Code 展开不同维度的工作：
+>
+> | 分支 | 说明 |
+> |------|------|
+> | [`main`](../../tree/main) | **Claude Code Java** — 使用 Java + Spring AI 重写的 Claude Code CLI AI 编码助手（当前分支） |
+> | [`claude`](../../tree/claude) | **Claude Code 源码** — Claude Code TypeScript 源码快照，用于安全研究和架构学习 |
+> | [`learn`](../../tree/learn) | **Learn Claude Code** — 拆解 Claude Code Agent Harness 架构的教学项目，含 12 节渐进式课程 |
+
 # Claude Code Java ☕
 
 > 使用 Java + Spring AI 重写的 [Claude Code](https://github.com/anthropics/claude-code) CLI AI 编码助手。