File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff 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
Original file line number Diff line number Diff line change @@ -341,8 +341,15 @@ claude -c
341341
342342# 使用Opus模型(更强但更贵)
343343claude --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#### 快捷输入符号
Original file line number Diff line number Diff 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## 第四部分:实战应用场景
You can’t perform that action at this time.
0 commit comments