Skip to content

Commit 3377e3c

Browse files
committed
feat: 新增 Git Worktree 内置并行任务隔离功能文档
- 02-基础使用新增 --worktree (-w) 启动参数说明和使用提示 - 05-Hooks 3.7 节大幅补充 --worktree 核心功能详解: 工作原理、目录结构、使用场景、配置步骤、Hook角色说明 - 05-Hooks 更新版本标注为 v2.1.49+(2026年2月正式发布) - README changelog 同步更新 Worktree 功能文档记录
1 parent 4053e6c commit 3377e3c

3 files changed

Lines changed: 61 additions & 2 deletions

File tree

README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -211,9 +211,11 @@ Week 6:08-Agent-SDK(完整学习)
211211

212212
**新增内容**
213213
- 05-Hooks教程新增 3.7 节:WorktreeCreate / WorktreeRemove 工作树管理 Hook 详解
214+
- 05-Hooks教程新增 `--worktree``-w`)内置 Git Worktree 并行任务隔离功能详解(v2.1.49+)
214215
- 05-Hooks教程 Hook 类型从 6 种扩展至 8 种,术语表和速查表同步更新
215-
- 01-安装指南新增 4.3.1 节:API中转站配置(ANTHROPIC_BASE_URL 环境变量)
216+
- 02-基础使用新增 `--worktree``-w`)启动参数说明
216217
- 02-基础使用新增 /fast 快速模式命令说明
218+
- 01-安装指南新增 4.3.1 节:API中转站配置(ANTHROPIC_BASE_URL 环境变量)
217219
- README 教程目录同步更新 Hooks 说明(6种→8种含Worktree管理)
218220
- README 环境要求新增第三方中转站 API Key 说明
219221

docs/02-基础使用完整指南.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -341,8 +341,15 @@ claude -c
341341

342342
# 使用Opus模型(更强但更贵)
343343
claude --model claude-opus-4-5-20251101
344+
345+
# 在独立工作树中启动(并行任务互不干扰)
346+
claude --worktree
347+
# 或简写
348+
claude -w
344349
```
345350

351+
> 💡 **Worktree 模式(v2.1.49+ 新增)**`--worktree``-w`)是 2026年2月新增的重要参数。它会自动创建一个独立的 Git Worktree,让你可以同时运行多个 Claude Code 实例,每个实例在自己的工作目录中独立工作,互不干扰。适合并行开发多个功能、边修 bug 边开发新特性等场景。使用前需要将 `.claude/worktrees/` 添加到 `.gitignore`
352+
346353
### 3.3 快速输入技巧
347354

348355
#### 快捷输入符号

docs/05-Hooks系统完整指南.md

Lines changed: 51 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1469,7 +1469,7 @@ sys.exit(0)
14691469

14701470
### 3.7 WorktreeCreate 和 WorktreeRemove(工作树管理)🆕
14711471

1472-
> **v2.1+ 新增**这两个Hook类型是 Claude Code 2.1 版本新增的,用于 Git Worktree(工作树)的生命周期管理。
1472+
> **v2.1.49+ 新增**这两个Hook类型配合 Claude Code 内置的 Git Worktree 功能使用,用于 Git Worktree(工作树)的生命周期管理。
14731473
14741474
#### 什么是 Git Worktree?
14751475

@@ -1557,6 +1557,56 @@ sys.exit(0)
15571557

15581558
> ⚠️ **注意**:WorktreeCreate 和 WorktreeRemove 都是**不可阻止**的Hook,它们只用于执行附加操作,不能阻止工作树的创建或删除。
15591559
1560+
#### `--worktree` 启动参数的关系
1561+
1562+
> 🔥 **重要**:2026年2月(v2.1.49),Claude Code 正式内置了 Git Worktree 支持,这是一个**核心功能级别**的更新,不仅仅是 Hook。
1563+
1564+
**`--worktree``-w`)启动参数**
1565+
1566+
```bash
1567+
# 在独立工作树中启动 Claude Code
1568+
claude --worktree
1569+
# 或简写
1570+
claude -w
1571+
```
1572+
1573+
**工作原理**
1574+
1575+
```
1576+
你的项目仓库(主工作目录)
1577+
├── .git/ # 共享的 Git 历史
1578+
├── .claude/worktrees/ # 工作树存放目录(加到 .gitignore)
1579+
│ ├── worktree-abc123/ # Agent A 的独立工作目录
1580+
│ └── worktree-def456/ # Agent B 的独立工作目录
1581+
├── src/ # 主工作目录的文件
1582+
└── ...
1583+
```
1584+
1585+
**使用场景**
1586+
1587+
| 场景 | 说明 |
1588+
|------|------|
1589+
| 并行开发 | 终端1: `claude -w` 开发新功能 / 终端2: `claude -w` 修复 bug |
1590+
| 代码审查 | 主工作目录继续开发,工作树中运行审查 Agent |
1591+
| 实验性修改 | 在工作树中试验方案,不影响主目录 |
1592+
1593+
**配置步骤**
1594+
1595+
```bash
1596+
# 1. 将工作树目录加到 .gitignore
1597+
echo ".claude/worktrees/" >> .gitignore
1598+
1599+
# 2. 启动第一个 Agent(在工作树中)
1600+
claude -w
1601+
1602+
# 3. 打开另一个终端,启动第二个 Agent(在另一个工作树中)
1603+
claude -w
1604+
```
1605+
1606+
**Hook 的角色**
1607+
- **Git 用户**:直接使用 `claude -w` 即可,Hook 是可选的增强(如自动安装依赖)
1608+
- **非 Git 用户**(SVN/Perforce/Mercurial):通过 WorktreeCreate/WorktreeRemove Hook 自定义工作树的创建和清理逻辑,替代默认的 Git 行为
1609+
15601610
---
15611611

15621612
## 第四部分:实战应用场景

0 commit comments

Comments
 (0)