---
created: "2026-04-14 23:07"
type: zettel
tags: [zettel, claude-code, ECC, orchestration, parallel, windows, worktree]
source: "Claude Code Agent tool 参数: isolation"
---

# Agent 工具 worktree 隔离是 Windows 原生并行的关键

ECC 的 `dmux-workflows`、`scripts/orchestrate-worktrees.js` 都依赖 tmux，Windows 原生环境跑不了。绕过这个限制最干净的方案不是切 WSL，是用 Claude Code 内置 `Agent` 工具的 `isolation: "worktree"` 参数。

## 机制

`Agent` 工具在 spawn 子代理时接受 `isolation: "worktree"`——平台会自动为该子代理建一个临时 git worktree，子代理在隔离分支上做修改，无改动时自动清理，有改动则把 path 和 branch 返还给主代理，由主代理决定合并还是丢弃。

这和 `claude-devfleet` 的 worktree 策略本质一致，只是调度层从 HTTP MCP 变成主代理自己。

## 为什么重要

1. **零外部依赖** — 不需要 tmux、不需要额外服务，Claude Code 开箱即用
2. **天然隔离** — git worktree 保证多个子代理改同一个仓库也不会互相踩脚
3. **失败可丢弃** — 改坏了直接扔掉 worktree，主会话干净无污染
4. **和现有 agent 生态复用** — 任何 `subagent_type`（general-purpose、csharp-reviewer、security-reviewer……）都能套 worktree

## 适用边界

- ✅ 互相独立的迁移任务、并行审查、多模块改造
- ✅ 想在 Windows 上复刻 dmux 「多 pane 并行」效果
- ❌ 跨模块强耦合、子代理需要实时看到彼此中间状态
- ❌ 需要长时间运行、跨会话存活（用 `claude-devfleet` 或 `autonomous-agent-harness` crons）

## 和其他编排方式的关系

| 需求 | 用这个 |
|------|--------|
| 几个独立子任务，当前会话内搞定 | **Agent + isolation: worktree**（本 zettel） |
| DAG 依赖、跨会话、自动 merge | `claude-devfleet`（MCP） |
| Linux/WSL 上可视化多 pane | `dmux-workflows` |
| 定时 / 长周期无人值守 | `autonomous-agent-harness` + crons |

---

## Related

- [[ECC 编排替代方案 (orchestrate 迁移)]]
- [[dmux 多Agent并行编排]]
- [[Autonomous Agent Harness 自主代理框架]]
- [[Everything Claude Code Agent 编排模式]]

## Source

- Claude Code `Agent` tool 原生参数 `isolation`
- ECC `skills/claude-devfleet/SKILL.md` 的 worktree 隔离策略（同源思路）