bảng thuật ngữ

git worktree là gì?

Git worktree là một bản sao riêng của repository trên branch riêng. Nó dùng chung lịch sử git với repo chính nhưng có các tệp trong folder riêng. Bạn có thể mở bao nhiêu worktree cùng lúc tùy thích.

vấn đề worktree giải quyết

Thông thường, repo là một folder với một branch đang checkout. Muốn làm hai tính năng cùng lúc, bạn phải stash thay đổi, chuyển branch, làm việc kia, chuyển lại rồi bỏ stash. Rất phiền.

Với worktree, bạn có folder thứ hai đã nằm trên branch khác. Làm Tính năng A trong một folder và Tính năng B trong folder kia. Không stash, không chuyển branch. Cả hai tồn tại cùng lúc.

vì sao điều này quan trọng với ai agent

Nếu chạy hai AI agent trong cùng folder, chúng sẽ ghi đè thay đổi của nhau. Agent A sửa auth.ts. Agent B cũng sửa auth.ts. Ai lưu sau sẽ thắng. Công việc của agent kia biến mất.

Worktree giải quyết việc này. Mỗi agent có folder, branch và bản sao tệp riêng. Cả hai có thể cùng sửa auth.ts mà không cản nhau. Khi xong, bạn merge từng branch riêng.

trên ổ đĩa trông thế nào

my-project/              ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)

Cả ba folder dùng chung lịch sử git. Commit trong một worktree sẽ xuất hiện ở các worktree khác sau khi merge. Nhưng các thay đổi tệp chưa commit hoàn toàn tách biệt.

pane tự động hóa thế nào

Bạn không cần tự chạy lệnh git. Khi tạo pane mới trong Pane:

1. Pane tạo worktree và branch cho bạn.
2. Pane sao chép biến môi trường, node_modules và các thư mục quan trọng khác để agent làm việc ngay.
3. Khi bạn lưu trữ pane, Pane tự động dọn worktree.

cách làm thủ công (để tham khảo)

Nếu muốn làm việc này mà không có Pane:

git worktree add ../feature-a feature-a
cd ../feature-a
claude   # start your agent here

# when done:
git worktree remove ../feature-a

Pane làm tất cả cho bạn chỉ với một lần nhấp.

tài liệu liên quan

bởi Parsa Khazaeepoul

Cập nhật lần cuối 24 tháng 6, 2026