.worktreeinclude và Git Worktrees Trong Claude Code: Chạy 3 Phiên Claude Song Song Sửa Bug
🌳 Git Worktrees Là Gì
Git worktrees cho phép bạn có nhiều branch cùng lúc trong các thư mục riêng biệt, chia sẻ chung một repo. Mỗi worktree là một "bản sao" làm việc độc lập, không cần clone lại dự án.
Claude Code tận dụng điều này để chạy nhiều phiên Claude song song trên cùng codebase mà không xung đột file hay branch.
⚙️ .worktreeinclude Giải Quyết Vấn Đề Gì
Khi tạo worktree mới, git bỏ qua các file gitignored như .env, API keys, local config. Claude Code trong worktree mới sẽ thiếu những file này, không chạy được test hay gọi API.
.worktreeinclude là file cấu hình nằm trong .claude/ directory. Nó liệt kê các file gitignored cần copy tự động vào worktree mới để mọi thứ hoạt động ngay lập tức.
📝 Cú Pháp .worktreeinclude
Cú pháp giống hệt .gitignore, mỗi dòng một pattern:
.env
.env.local
config/secrets.json
*.key
.vscode/settings.json
Claude Code đọc file này mỗi khi bạn tạo worktree, copy đúng các file match pattern từ repo gốc vào worktree mới.
🚀 Cách Dùng Trong Claude Code
Có 3 cách để vào worktree:
- Flag --worktree khi chạy claude CLI, tạo worktree mới cho session hiện tại.
- EnterWorktree tool, Claude tự tạo và chuyển vào worktree trong lúc làm việc.
- Subagent isolation: worktree, mỗi subagent chạy trong worktree riêng, hoàn toàn cô lập.
🧪 Workflow Thực Tế: Test 3 Cách Fix Bug Song Song
Bạn có một bug khó, không biết cách nào tốt nhất. Mở 3 worktree song song, mỗi worktree chạy một phiên Claude thử một solution khác nhau.
.env được copy tự động vào cả 3 worktree nhờ .worktreeinclude, nên mỗi phiên chạy test, query DB, gọi API bình thường. Sau khi cả 3 chạy xong, bạn so sánh kết quả và chọn fix tốt nhất để merge về main.
💡 Lợi Ích Chính
- Tăng tốc 3x-5x: thử nhiều solution cùng lúc thay vì tuần tự.
- Cô lập rủi ro: một worktree lỗi không ảnh hưởng branch khác.
- Main branch sạch: mọi thử nghiệm nằm trong worktree, không làm bẩn main.
- Subagent độc lập: nhiều agent code cùng lúc, không đụng file.
Đây là feature mạnh cho ai làm việc với codebase phức tạp hoặc cần A/B test nhiều giải pháp cùng lúc. Chỉ vài dòng config trong .worktreeinclude là đủ để mở khóa workflow song song cấp độ mới cho Claude Code.
#AI #Claude #ClaudeCode #GitWorktrees #VibeAICoder #learnontiktok
