Trình quản lý git worktree
cho Claude Code, Codex và mọi CLI agent

Git worktree là một checkout thứ hai của cùng repository, trong thư mục riêng và trên nhánh riêng, dùng chung lịch sử và remote với checkout chính của bạn. Cho mỗi agent code AI một worktree nghĩa là mỗi agent sửa, build và commit bản sao tệp của riêng nó, nên hai agent làm việc cùng lúc không bao giờ ghi đè lên nhau hay đổi nhánh khi agent kia vẫn đang làm việc. Blog của chúng tôi có một hướng dẫn dài hơn về phía git: Git worktree: nền tảng để chạy nhiều AI agent mà không xung đột.

Có. claude --worktree <tên> (hoặc -w) tạo .claude/worktrees/<tên> trên một nhánh tên worktree-<tên>, sao chép các tệp bị git bỏ qua được liệt kê trong .worktreeinclude, và hỏi nên giữ hay xóa worktree khi bạn thoát; subagent có thể chạy trong worktree riêng với isolation: worktree. Nó không cài phụ thuộc cho bạn. Trong AgentsRoom bạn vẫn có thể tiếp tục dùng nó, hoặc để ticket hay agent yêu cầu worktree, cách này còn chuẩn bị worktree và hiển thị nó trong tab Thay đổi (đã kiểm tra trên Claude Code 2.1.299).

Ứng dụng Codex có: nó tạo các worktree được quản lý trong $CODEX_HOME/worktrees, ở trạng thái detached HEAD, sao chép các tệp bị bỏ qua được liệt kê trong .worktreeinclude, có thể chạy các script setup của một môi trường local, giữ 15 worktree gần nhất và chuyển một cuộc trò chuyện giữa Local và một worktree bằng Handoff. codex-cli 0.162.1 có cờ --worktree để chạy một phiên trong một worktree được quản lý mới. AgentsRoom cho một agent Codex một worktree theo cùng cách như mọi agent khác, từ ticket hoặc từ cửa sổ Thêm agent.

Tất cả: worktree đơn giản là thư mục làm việc của agent, dù CLI nào chạy trong đó, nên Claude, Codex, GitHub Copilot CLI, Cursor và 10 CLI agent khác làm việc trong đó theo cùng một cách. Kimi Code và Antigravity CLI tin cậy một thư mục theo đúng đường dẫn của nó; AgentsRoom ghi worktree mới là thư mục tin cậy cho chúng trước khi khởi chạy, để chúng không dừng lại ở một câu hỏi tin cậy.

Không. Trước khi agent đầu tiên khởi động trong một worktree mới, AgentsRoom sao chép các tệp bị git bỏ qua của checkout chính khớp với Tệp được sao chép từ checkout này (mặc định là mọi tệp .env) và chạy lệnh cài đặt được phát hiện từ lockfile ở thư mục gốc. Cả hai được đặt trong Cài đặt dự án > Git > Chuẩn bị worktree mới, nơi bạn có thể thay lệnh, ví dụ pnpm install && pnpm build:deps. Một tệp đã có sẵn trong worktree không bao giờ bị ghi đè.

Mở tab Thay đổi và chọn worktree trong bộ chọn Worktree ở phía trên: danh sách tệp, các diff, phần review, Commit, Pull và Push khi đó thao tác trên checkout đó. Với một ticket, Tự động gộp vào nhánh hiện tại khi tác vụ xong sẽ gộp nhánh của nó khi bạn chuyển ticket sang Xong, và Tự động commit khi công việc hoàn tất (Cài đặt > Backlog) commit trước những gì agent để lại, để lần gộp mang theo toàn bộ công việc.

Bên trong dự án, dưới .worktrees/<nhánh>/, được tạo từ nhánh mặc định của remote trừ khi bạn đặt Nhánh gốc của worktree trong Cài đặt dự án. Thư mục được thêm vào .git/info/exclude của bản clone, không bao giờ vào .gitignore của bạn, nên nó nằm ngoài các commit của bạn. Worktree không bao giờ bị xóa tự động: hãy xóa từng cái bằng git worktree remove khi bạn dùng xong.

Có, cả hai. Trên điện thoại, màn hình Thay đổi có cùng bộ chọn Worktree, và một ticket yêu cầu worktree sẽ chạy trong đó khi bạn bắt đầu nó từ điện thoại, được máy tính chuẩn bị như mọi ticket khác. Một dự án mở trên máy chủ SSH có worktree trên máy chủ, không có bước cài đặt. Một checkout cục bộ có agent chạy trên máy chủ từ xa không thể dùng worktree, và ticket sẽ báo cho bạn điều đó thay vì bắt đầu.