Nhiều phiên AI cùng sửa một dự án: cách không giẫm chân nhau

Nhiều phiên AI cùng sửa một dự án: cách không giẫm chân nhau
19 Tháng 11, 2026

Cập nhật:

11 phút đọcHướng dẫn

Nhiều phiên AI cùng sửa một dự án là khi hai hay nhiều tác tử lập trình, ví dụ Claude Code, Codex CLI hay Google Antigravity, cùng đọc và ghi vào một kho mã trong cùng khoảng thời gian, mỗi phiên tưởng mình là người duy nhất đang làm. Cách làm này giúp một người chạy song song nhiều việc, nhưng sinh ra loại lỗi mà một phiên đơn lẻ không bao giờ gặp: ghi đè file của nhau, commit lẫn file của nhau, lần triển khai này xoá file của phiên kia, hai bản build chạy chồng, và hàng nghìn file "đã thay đổi" chỉ vì khác kiểu xuống dòng. Bài này không hứa một cách làm loại bỏ hết xung đột, và không đưa số liệu về thời gian tiết kiệm vì chúng tôi không đo. Bài đi qua 5 kiểu va chạm, rồi 6 biện pháp: git worktree (đối chiếu tài liệu git và tài liệu Claude Code), commit đúng đường dẫn, gộp nhánh chính trước khi triển khai, chạy thử đồng bộ, khoá hoặc chờ build, file trạng thái chung, và .gitattributes cho xuống dòng. Phần cuối là kinh nghiệm thật của OPCAIOS.

Sơ đồ nhiều phiên AI cùng sửa một dự án: mỗi phiên một worktree và một nhánh riêng, commit chỉ đúng đường dẫn, gộp nhánh chính, chạy thử đồng bộ và đọc dòng xoá, chờ khoá build, ghi file trạng thái chung, chuẩn hoá xuống dòng bằng .gitattributes
Sáu lớp bảo vệ khi nhiều tác tử AI cùng làm trên một kho mã. Sơ đồ: OPCAIOS.

Khi nhiều phiên AI cùng sửa một dự án thì điều gì hỏng trước tiên?

Điều hỏng trước tiên thường không phải mã, mà là ranh giới giữa các phiên. Mỗi tác tử như Claude Code hay Codex CLI chỉ thấy cuộc trò chuyện của chính nó, nên không biết phiên khác vừa sửa file nào, đã đưa gì vào vùng chờ commit, hay đang build dở. Năm kiểu va chạm hay gặp:

  1. Ghi đè file: hai phiên cùng sửa một file, phiên lưu sau xoá mất phần của phiên trước mà không báo lỗi.
  2. Commit lẫn: các phiên dùng chung một thư mục làm việc và chung chỉ mục git (index), nên một lệnh commit trần cuốn theo file mà phiên khác đã git add.
  3. Triển khai xoá file của nhau: công cụ đồng bộ có tuỳ chọn xoá file không còn ở nguồn sẽ xoá trên máy chủ những file mà phiên khác đã đẩy lên nhưng máy bạn chưa có.
  4. Build chồng: hai bản build cùng ghi vào một thư mục đầu ra, kết quả là bản lỗi hoặc bản lai.
  5. Khác kiểu xuống dòng: một tác tử chạy trên Windows lưu file với CRLF, phiên trên macOS hay Linux lưu LF, và git báo hàng nghìn file thay đổi dù nội dung y hệt.

Ví dụ giả định, không phải người thật: phiên A sửa trang giá, phiên B sửa form đăng ký, cả hai làm trong cùng thư mục. Phiên B gõ commit và đẩy lên, kéo theo nửa bản sửa trang giá chưa xong của A.

Git worktree là gì và vì sao nên cho mỗi phiên một worktree?

Git worktree là một thư mục làm việc riêng, có file và nhánh riêng, nhưng dùng chung lịch sử kho với thư mục chính. Theo tài liệu git worktree trên git-scm.com (đọc ngày 03/11/2026), mỗi worktree có HEAD và chỉ mục riêng, còn kho đối tượng, cấu hình và các nhánh, thẻ dưới refs/ được dùng chung; một nhánh chỉ được mở ở một worktree tại một thời điểm, lệnh add mặc định từ chối nếu nhánh đó đang mở ở worktree khác. Chính điểm "chỉ mục riêng" này xử lý tận gốc lỗi commit lẫn: mỗi phiên có vùng chờ của mình. Tài liệu Claude Code (trang Worktrees trên code.claude.com, đọc ngày 03/11/2026) mô tả cờ --worktree hoặc -w tạo worktree dưới .claude/worktrees/<tên>/ ở gốc kho, trên nhánh mới tên worktree-<tên>. Khi thoát, nếu worktree sạch thì phiên không đặt tên được dọn tự động; nếu còn việc dở, Claude Code hỏi giữ hay xoá. Tài liệu cũng gợi ý thêm .claude/worktrees/ vào .gitignore.

Lệnh tạo worktree theo tài liệu

# Claude Code: mỗi terminal một tên khác nhau
claude --worktree feature-auth

# Git thuần: tạo worktree trên nhánh mới, liệt kê, gỡ bỏ
git worktree add ../project-feature-a -b feature-a
git worktree list
git worktree remove ../project-feature-a

Ba lưu ý từ tài liệu Claude Code: worktree là bản checkout mới nên phải cài lại thư viện; file bị gitignore như .env không có sẵn, muốn chép tự động thì liệt kê trong file .worktreeinclude; và kho phải có ít nhất một commit. Subagent cũng chạy được trong worktree riêng bằng trường isolation: worktree trong định nghĩa agent, xem thêm subagent là gì.

Không dùng worktree được thì commit thế nào để không cuốn file của phiên khác?

Quy tắc là đặt danh sách đường dẫn ngay trên lệnh commit, không chỉ trên lệnh git add. Theo trang hướng dẫn git commit (git 2.55, đọc ngày 03/11/2026), khi có pathspec trên dòng lệnh, git commit nội dung của đúng các file khớp và bỏ qua những thay đổi khác đã nằm trong chỉ mục. Quy trình gợi ý gồm 3 bước:

  1. Xem vùng chờ trước: git diff --cached --stat cho biết chỉ mục đang có gì, kể cả thứ phiên khác vừa thêm.
  2. Commit có đường dẫn: git commit -m "lời nhắn" -- <đường dẫn 1> <đường dẫn 2>.
  3. Kiểm tra sau: git show --stat HEAD để chắc commit chỉ chứa file của mình, trước khi đẩy lên.

Bài 10 bài học khi để tác tử AI xây và vận hành website kể hai lần OPCAIOS dính lỗi này, nên ở đây chỉ nhấn mạnh: chạy git add -- file của mình rồi commit trần vẫn chưa an toàn.

Vì sao phải gộp nhánh chính và chạy thử đồng bộ trước khi triển khai?

Gộp nhánh chính trước khi triển khai đảm bảo bản bạn đẩy lên đã chứa việc mà các phiên khác đã đẩy. Nếu quy trình triển khai đồng bộ cả thư mục lên máy chủ kèm tuỳ chọn xoá file thừa, thì thiếu bước gộp đồng nghĩa với xoá việc của người khác. Trình tự an toàn gồm 4 bước:

  1. Lấy bản mới: git fetch, so xem nhánh từ xa có đi trước nhánh của bạn không.
  2. Nếu có, gộp nhánh chính từ xa vào trước, chạy build thử.
  3. Chạy đồng bộ ở chế độ thử. Với rsync, tuỳ chọn -n hay --dry-run không sửa gì ở đích (trang man rsync, đọc ngày 03/11/2026); thêm liệt kê thay đổi để đọc từng dòng sẽ xoá.
  4. Coi mọi dòng xoá file mà bạn không viết là tín hiệu dừng. Kết quả chạy thử rỗng hoặc lỗi kết nối cũng là dừng, không phải "không có gì để xoá".

Bước 4 dễ bị bỏ qua nhất: một lệnh lọc dòng xoá chạy trên file kết quả rỗng sẽ báo sạch sẽ dù chạy thử chưa hề thành công.

Làm sao để hai bản build không chạy chồng lên nhau?

Cách đơn giản nhất là một khoá: script build tạo một file khoá khi bắt đầu, xoá khi xong, và phiên nào thấy khoá thì chờ. Kết hợp với build vào thư mục riêng rồi mới hoán đổi, một bản build lỗi không thay được bản đang chạy. Ba điểm cần có:

  1. Khoá có thời hạn hoặc ghi mã tiến trình, để khoá mồ côi sau khi máy treo không chặn mãi.
  2. Ghi nhật ký build có dòng kết thúc rõ ràng (thành công hay lỗi), để phiên sau đọc thay vì đoán.
  3. Chỉ làm bước tiếp theo, như xuất bản nội dung, khi nhật ký báo bản mới đã chạy.

Claude Code cũng dùng git worktree lock cho worktree của subagent đang chạy để việc dọn dẹp đồng thời không xoá mất nó, theo trang Worktrees. Cùng ý tưởng: thứ đang dùng thì phải có khoá.

File trạng thái chung giúp các tác tử khác nhau phối hợp ra sao?

File trạng thái chung là một tài liệu ngắn mà mọi tác tử đọc đầu phiên và ghi cuối phiên: dịch vụ nào đang chạy, sự cố nào đang mở, việc nào đang dở và ai đang giữ. Claude Code, Codex CLI và Antigravity không chia sẻ trí nhớ với nhau, nên file này là "bảng trắng" duy nhất cả ba cùng thấy. Gợi ý cấu trúc:

Mục Nội dung Quy tắc
Trạng thái dịch vụ Đang chạy, đang hỏng, giờ kiểm tra Ghi kèm thời điểm kiểm tra thật
Sự cố mở Mô tả, ai đang xử lý Xoá khi đóng
Việc đang giữ File hoặc khu vực đang sửa Phiên khác tránh chạm vào
Nhật ký gần đây Một dòng mỗi việc xong Giới hạn số dòng, chuyển dòng cũ sang lưu trữ

Thông tin trong file là tham khảo; trước khi dùng cổng, kết quả triển khai hay trạng thái dịch vụ, tác tử vẫn phải kiểm tra thật. Với Claude Code, tài liệu còn có tính năng nhắn tin giữa các phiên (cross-session messaging) để chuyển phát hiện từ phiên này sang phiên khác; quy tắc đọc file đầu phiên thì đặt trong CLAUDE.md.

Dùng .gitattributes thế nào để hết lỗi khác kiểu xuống dòng?

.gitattributes là file cấu hình theo đường dẫn, trong đó thuộc tính text và eol quyết định git chuẩn hoá ký tự xuống dòng. Theo tài liệu gitattributes trên git-scm.com (đọc ngày 03/11/2026), đặt * text=auto cho phép git tự nhận file văn bản và chuẩn hoá về LF trong kho; eol=lf hoặc eol=crlf ép kiểu xuống dòng trong thư mục làm việc cho từng loại file; còn -text tắt chuyển đổi, dùng cho ảnh và file nhị phân. File này nằm trong kho nên áp dụng cho mọi máy, mọi tác tử, khác với core.autocrlf chỉ là cấu hình của từng máy. Sau khi thêm, tài liệu hướng dẫn chuẩn hoá lại từ thư mục sạch:

echo "* text=auto" >.gitattributes
git add --renormalize .
git status
git commit -m "Introduce end-of-line normalization"

Script shell nên ghi thêm dòng *.sh text eol=lf để không hỏng khi checkout trên Windows. Làm việc này trên một worktree riêng, vì commit chuẩn hoá có thể chạm hàng trăm file.

Kinh nghiệm của OPCAIOS

Website opcaios.org do một người vận hành với nhiều tác tử: Claude Code (bản dòng lệnh và ứng dụng máy tính), Codex CLI và Google Antigravity, đồng bộ trạng thái qua một file trạng thái chung và nhật ký ngày trong Obsidian. Những điều có thật, theo ghi chú dự án:

  1. Các phiên Claude Code dùng chung một thư mục và chung chỉ mục git, nên quy tắc là mỗi phiên chỉ commit đúng file của mình, đường dẫn đặt ngay trên lệnh commit. Quy tắc này nằm trong bộ nhớ tự động của Claude để phiên sau đọc lại.
  2. Trước mỗi lần triển khai: gộp nhánh chính từ xa, chạy thử đồng bộ và đọc dòng xoá. Từng có lần đồng bộ có xoá suýt xoá ảnh của một phiên khác chưa commit.
  3. Từng thấy hơn 1.500 file khác nhau chỉ vì kiểu xuống dòng Windows, khi một tác tử khác triển khai từ máy Windows.
  4. Build đồng thời phải chờ nhau, và chỉ xuất bản nội dung khi nhật ký build báo bản mới đã chạy.
  5. Khi hai phiên cùng làm, chúng phối hợp bằng cách nhắn nhau và chia việc.

Điều chúng tôi chưa làm: chưa chuyển hẳn sang mỗi phiên một worktree, chưa thêm .gitattributes chuẩn hoá cho toàn kho tại thời điểm viết, và chưa có hook tự chặn commit sai, xem hooks trong Claude Code. Vì thế các biện pháp ở trên vẫn dựa vào kỷ luật và ghi chú nhiều hơn công cụ.

Câu hỏi thường gặp

Có thể cho hai tác tử AI làm cùng một nhánh không?

Có thể nếu chúng làm trong cùng một thư mục, nhưng đó chính là tình huống dễ va chạm nhất. Theo tài liệu git, một nhánh chỉ được mở ở một worktree tại một thời điểm, nên muốn tách hẳn, mỗi tác tử nên có nhánh và worktree riêng, rồi gộp lại qua nhánh chính. Nếu bắt buộc chung thư mục, hãy chia rõ ai giữ file nào trong file trạng thái chung, commit có đường dẫn và kiểm tra vùng chờ trước mỗi commit.

Worktree có tốn nhiều dung lượng không?

Worktree dùng chung kho đối tượng của git nên không nhân đôi toàn bộ lịch sử, nhưng mỗi worktree là một bản checkout đầy đủ các file và cần thư viện riêng, ví dụ thư mục phụ thuộc của dự án JavaScript. Với dự án lớn, phần thư viện mới là thứ tốn chỗ. Gỡ worktree khi xong bằng git worktree remove; Claude Code cũng tự dọn worktree sạch khi thoát phiên không đặt tên, theo tài liệu.

Tác tử chạy trên Windows và macOS cùng một kho thì cần chuẩn bị gì?

Cần thống nhất kiểu xuống dòng ngay trong kho bằng .gitattributes, thay vì trông vào cấu hình riêng của từng máy. Dòng * text=auto chuẩn hoá file văn bản về LF trong kho; thêm eol=lf cho script shell và -text cho file nhị phân. Sau đó chạy git add --renormalize . theo tài liệu git rồi commit riêng. Ngoài ra nên kiểm tra quy trình triển khai từ máy Windows không đẩy file với CRLF lên máy chủ.

Có cách nào để Claude Code tự chặn commit sai đường dẫn không?

Theo tài liệu Claude Code, hook là cơ chế chạy chắc chắn ở mỗi sự kiện, còn chỉ dẫn trong CLAUDE.md chỉ là lời yêu cầu. Về lý thuyết có thể viết một hook kiểm tra lệnh trước khi chạy. Chúng tôi chưa làm việc này nên không đưa cấu hình mẫu. Cách chắc hơn là worktree: mỗi phiên có chỉ mục riêng, không còn vùng chờ chung để cuốn nhầm. Chi tiết về hook xem bài hooks trong Claude Code.

Người mới nên bắt đầu từ biện pháp nào?

Bắt đầu từ worktree cho mỗi phiên, vì nó loại bỏ cùng lúc ghi đè file và commit lẫn. Tiếp theo là chạy thử đồng bộ và đọc dòng xoá trước mỗi lần triển khai, vì lỗi này làm hỏng bản đang chạy. Sau cùng là file trạng thái chung và .gitattributes. Nếu chưa quen Git, đọc trước quy trình an toàn cho người không biết code. Muốn được hướng dẫn dựng quy trình nhiều tác tử có kiểm soát, xem khoá đào tạo ứng dụng AI của OPCAIOS.

Nguồn: tài liệu git-scm.com (git-worktree, gitattributes), trang hướng dẫn git-commit của git 2.55 và trang man rsync; tài liệu Claude Code trên code.claude.com (Worktrees, Common workflows, Extend Claude Code), đọc ngày 03/11/2026. Điều chưa kiểm chứng: hành vi worktree trong ứng dụng máy tính và Codex CLI, cách Antigravity xử lý worktree; tính năng có thể đổi theo phiên bản. Kinh nghiệm là của OPCAIOS.

Lê Quốc Nghĩa
Người xây dựng OPCAIOS

Để lại bình luận

Email của bạn sẽ không hiển thị công khai. Bình luận sẽ hiển thị sau khi được duyệt.