เป้าหมาย
รัน agent หลายตัวพร้อมกันบน repo เดียวโดยไฟล์ไม่ทับกัน แบ่งงานให้ชนกันน้อยที่สุด และรวมผลกลับอย่างมีคนตรวจ
หลักการ
ทำไมรันสองตัวในโฟลเดอร์เดียวกันไม่ได้
agent สองตัวในโฟลเดอร์เดียวกันจะแก้ไฟล์ทับกัน git commit ของตัวหนึ่งเก็บงานครึ่งๆ กลางๆ ของอีกตัวไปด้วย และเทสต์ของตัวหนึ่งพังเพราะอีกตัวแก้อยู่ — ผลคือ PROGRESS.md และ git log ที่เชื่อไม่ได้
git worktree = โฟลเดอร์ทำงานแยก แต่ใช้ repo เดียวกัน
git worktree add ../loop-lab-a -b agent/a # โฟลเดอร์ใหม่ บน branch ใหม่
git worktree list # ดูทั้งหมด
git worktree remove ../loop-lab-a # ลบเมื่อเสร็จ (branch ยังอยู่)แต่ละ worktree มีไฟล์ของตัวเองแต่แชร์ประวัติ git ร่วมกัน commit ในตัวหนึ่งเห็นได้จากทุกตัวทันที ไม่ต้อง clone ซ้ำ
Claude Code มีทางลัด: claude -w ชื่อ (หรือ --worktree) สร้าง worktree ที่ .claude/worktrees/ชื่อ/ บน branch worktree-ชื่อ แล้วเปิด Claude ในนั้นเลย
- เพิ่ม
.claude/worktrees/ใน.gitignore claude -p --worktreeจะไม่ลบ worktree ให้เมื่อจบ → เก็บกวาดเองด้วยgit worktree remove
แบ่งงานให้ไม่ชน
| หลัก | ตัวอย่าง |
|---|---|
| แบ่งตาม "เจ้าของไฟล์" ไม่ใช่ตามประเภทงาน | agent A ดูแล src/billing/ ส่วน agent B ดูแล src/reports/ |
| ไฟล์ส่วนกลางมีเจ้าของคนเดียว | package.json, lockfile, schema, config → ให้คน (หรือ agent ตัวเดียว) แก้ |
| PROGRESS แยกต่อ agent | แต่ละ worktree มี PROGRESS.md ของตัวเอง |
| ทรัพยากรที่ชนกันได้ | port ของ dev server, ฐานข้อมูลทดสอบ, ไฟล์ cache → ให้แต่ละตัวใช้ค่าแยก (เช่น PORT=3001) |
| เริ่มที่ 2 ตัว | ตัวที่ 3+ มักได้งานเพิ่มน้อยกว่าเวลาที่คุณเสียไปกับการตรวจและรวมผล |
Subagents vs หลาย session
| Subagents (บท 6d-04) | หลาย session ใน worktree | |
|---|---|---|
| ใครสั่ง | Claude ตัวหลักแตกงานเอง แล้วรวมผลกลับมาใน session เดียว | เรา (หรือสคริปต์) เปิดแยกกัน |
| ไฟล์ | อยู่ในโฟลเดอร์เดียวกัน | แยกโฟลเดอร์ |
| เหมาะกับ | ค้นหา/อ่าน/รีวิวคู่ขนาน งานสั้น | งานแก้โค้ดยาวๆ ที่อิสระต่อกัน |
รวมผล
- ตรวจทีละ branch:
git log --oneline main..agent/aและgit diff main...agent/a - รวมเข้า branch ทดสอบก่อน:
git switch -c integrate main && git merge agent/a agent/b - รันเทสต์ทั้งชุดหลังรวม เพราะแต่ละตัวผ่านเทสต์ของตัวเอง แต่รวมกันอาจพัง
- ถ้าชนกัน: ให้ Claude ช่วยแก้ conflict ใน session ที่คุณเฝ้าดู ไม่ใช่ใน loop
ตั้งค่า ⚙️
| ตั้งอะไร | ค่าที่แนะนำเริ่ม | เปลี่ยนเมื่อไร | ตรวจยังไง |
|---|---|---|---|
| จำนวน agent | 2 | เพิ่มเมื่อการตรวจและรวมผลไม่ใช่คอขวดแล้ว | — |
.claude/worktrees/ ใน .gitignore |
ใส่ตั้งแต่ก่อนใช้ claude -w ครั้งแรก |
ไม่เปลี่ยน | git status ใน checkout หลักไม่เห็นไฟล์ของ worktree |
.worktreeinclude (ไวยากรณ์เดียวกับ .gitignore) |
ใส่ไฟล์ที่ถูก gitignore แต่ต้องใช้ เช่น .env |
โปรเจกต์ต้องมี config ในเครื่องถึงจะรันเทสต์ได้ · ใช้กับ worktree ที่ Claude Code สร้างเท่านั้น ไม่ใช่ git worktree add |
worktree ใหม่จาก claude -w มีไฟล์นั้นครบ |
worktree.baseRef ใน settings |
"fresh" (ค่าเริ่ม: แตกจาก default branch บน remote) |
อยากให้ worktree มีงานที่ยังไม่ push → "head" · ถ้าไม่มี remote จะแตกจาก HEAD ในเครื่องอยู่แล้ว |
git log -1 ใน worktree ใหม่ |
| ติดตั้ง dependency | npm install (หรือเทียบเท่า) ในทุก worktree |
— | เทสต์ผ่านใน worktree ก่อนเริ่ม loop |
MAX_TOTAL_USD และ PORT ต่อ worktree |
แยกค่าต่อตัว เช่น 2 USD ต่อ agent | — | log ของแต่ละตัวแสดงยอด รวม≈ แยกกัน |
| ชื่อไฟล์สถานะ | PROGRESS.md ต่อ worktree (ทดลอง B จะเห็นว่าทำไมควรใช้ชื่อแยก) |
ใช้กับ repo จริง → ตั้งชื่อแยก เช่น PROGRESS-a.md หรือไม่ merge เข้า main |
merge แล้วไม่ conflict ที่ไฟล์สถานะ |
ลองเลย 🧪
ทดลอง A — สอง loop พร้อมกัน (ใน loop-lab จากบท 7d-02 บน branch main ที่ commit ล่าสุดแล้ว)
git switch main
git worktree add ../loop-lab-a -b agent/a
git worktree add ../loop-lab-b -b agent/b
cat > ../loop-lab-a/PROGRESS.md <<'EOF'
# PROGRESS — agent A ดูแลเฉพาะ src/text/ และ test/text/
## งาน
- [ ] เพิ่ม src/text/reverse.js ฟังก์ชัน reverse(text) พร้อมเทสต์ใน test/text/reverse.test.js
- [ ] เพิ่ม src/text/truncate.js ฟังก์ชัน truncate(text, n) ต่อท้าย … เมื่อยาวเกิน พร้อมเทสต์ใน test/text/truncate.test.js
## บันทึก
## ติดปัญหา
EOF
cat > ../loop-lab-b/PROGRESS.md <<'EOF'
# PROGRESS — agent B ดูแลเฉพาะ src/math/ และ test/math/
## งาน
- [ ] เพิ่ม src/math/sum.js ฟังก์ชัน sum(numbers) พร้อมเทสต์ใน test/math/sum.test.js
- [ ] เพิ่ม src/math/average.js ฟังก์ชัน average(numbers) คืน 0 เมื่อ array ว่าง พร้อมเทสต์ใน test/math/average.test.js
## บันทึก
## ติดปัญหา
EOF
(cd ../loop-lab-a && MAX_ITER=3 MAX_TOTAL_USD=2 ./loop.sh > ../loop-a.log 2>&1) &
(cd ../loop-lab-b && MAX_ITER=3 MAX_TOTAL_USD=2 ./loop.sh > ../loop-b.log 2>&1) &
wait
tail -3 ../loop-a.log ../loop-b.log→ PROGRESS.md ของแต่ละ worktree ยังไม่ได้ commit ไม่เป็นไร เพราะ agent จะ commit ไปพร้อมงานข้อแรก
→ node --test หาไฟล์ *.test.js ในโฟลเดอร์ย่อยของ test/ ให้เอง
→ ผลที่ควรได้: ทั้งสองจบด้วย "ไม่มีงาน - [ ] เหลือ" และมี commit ของตัวเองบน agent/a และ agent/b
ทดลอง B — รวมผล
git switch -c integrate main
git merge --no-edit agent/a
git merge --no-edit agent/b
npm test→ ผลที่ควรได้: งานโค้ดไม่ชนกันเพราะแบ่งโฟลเดอร์ไว้ แต่ PROGRESS.md จะ conflict เพราะทั้งสองตัวแก้ไฟล์ชื่อเดียวกัน — นี่คือบทเรียน: ไฟล์สถานะของแต่ละ agent ควรตั้งชื่อแยก (เช่น PROGRESS-a.md) หรืออย่า merge มันเข้า main · แก้ตอนนี้ด้วย git checkout --theirs PROGRESS.md && git add PROGRESS.md && git commit --no-edit แล้วรัน npm test
ทดลอง C — ทางลัดของ Claude Code
echo ".claude/worktrees/" >> .gitignore
claude -w docs-update→ ผลที่ควรได้: Claude เปิดใน .claude/worktrees/docs-update/ บน branch worktree-docs-update สั่งงานเล็กๆ แล้วออก จากนั้น git worktree list จะเห็น worktree นี้
เก็บกวาด
git worktree remove ../loop-lab-a && git worktree remove ../loop-lab-b
git worktree pruneถ้าพัง
| อาการ | สาเหตุที่พบบ่อย |
|---|---|
fatal: 'agent/a' is already checked out |
branch หนึ่ง checkout ได้ worktree เดียว → ใช้ชื่อ branch ใหม่ |
| เทสต์ใน worktree ใหม่พังทันที | ยังไม่ได้ติดตั้ง dependency (worktree ไม่มี node_modules ให้) → npm install ในแต่ละ worktree |
| merge แล้วเทสต์พังทั้งที่แยกกันผ่าน | สองงานพึ่งกันโดยไม่รู้ตัว → แบ่งงานใหม่ หรือให้ทำตามลำดับแทนพร้อมกัน |
git worktree remove ไม่ยอม |
มีไฟล์ที่ยังไม่ commit (เช่น log) → ตรวจก่อน แล้วใช้ --force ถ้าแน่ใจว่าทิ้งได้ |
ข้อดี / ข้อเสีย
| ✅ ข้อดี | ❌ ข้อเสีย / ต้นทุน |
|---|---|
| งานที่อิสระต่อกันเสร็จเร็วขึ้นตามเวลานาฬิกา | เวลาตรวจและรวมผลเพิ่มตามจำนวน agent และมักกินเวลาที่ประหยัดได้ไปเกือบหมด |
| ไฟล์ไม่ทับกัน commit ไม่ปนกัน | ค่าใช้จ่ายเพิ่มตามจำนวน agent ตรงๆ — เร็วขึ้นไม่ได้แปลว่าถูกลง |
| แชร์ประวัติ git ร่วมกัน ไม่ต้อง clone ซ้ำ | ทุก worktree ต้องติดตั้ง dependency เอง (เวลาและพื้นที่ดิสก์) และไฟล์ที่ gitignore อย่าง .env ไม่ตามมาให้ |
| งานที่พึ่งกันโดยไม่รู้ตัวจะไปพังตอน merge · port/ฐานข้อมูลทดสอบชนกันได้ |
ทางเลือกที่ง่ายกว่า
- งานข้ามคืน: loop เดียวทำต่อกันตามลำดับ — กลางคืนเวลาไม่ใช่ของหายาก ไม่ต้องรวมผล ไม่มี conflict
- งานอ่าน/ค้น/รีวิวคู่ขนาน: subagents ใน session เดียว (บท 6d-04) ไม่ต้องมี worktree
เมื่อไรไม่ควรใช้: งานแตะไฟล์ชุดเดียวกัน · งานที่ต้องทำตามลำดับ · คุณยังตรวจผลของ agent ตัวเดียวไม่ทันในแต่ละวัน
สังเกตอะไร
- worktree แยกไฟล์ได้ แต่ไม่ได้แยกงานที่พึ่งกันให้ — การแบ่งงานยังเป็นหน้าที่ของคน
- เวลาที่ประหยัดได้จากการรันคู่ขนาน มักถูกกินด้วยเวลาตรวจและรวมผล เริ่มจาก 2 ตัว แล้วเพิ่มเมื่อการตรวจไม่ใช่คอขวด
- ค่าใช้จ่ายเพิ่มตามจำนวน agent ตรงๆ ตั้ง
MAX_TOTAL_USDแยกต่อตัว และรวมดูทั้งหมดทุกเช้า
สรุปจำง่าย
หนึ่ง agent = หนึ่ง worktree = หนึ่งโฟลเดอร์ที่มันเป็นเจ้าของ — แบ่งให้ไม่ชนตั้งแต่ต้น แล้วรวมผลในที่ที่มีคนตรวจ