Dùng Codex và Claude Code cùng lúc: chia việc thế nào cho khỏi đụng nhau

Dùng Codex và Claude Code cùng lúc là cách một người giao việc cho hai tác tử lập trình khác hãng, Codex của OpenAI và Claude Code của Anthropic, trên cùng một hệ thống, mỗi tác tử giữ một vai rõ ràng thay vì cả hai cùng xông vào một việc. Cách làm này tận dụng điểm mạnh khác nhau và hạn mức sử dụng riêng của từng công cụ, và cho phép tác tử này kiểm tra việc của tác tử kia. Cái giá là phải có luật chơi chung. Bài này không xếp hạng hai công cụ, không hứa tiết kiệm thời gian hay tiền vì chúng tôi chưa đo, và bảng chia vai trong bài chỉ là gợi ý. Tính năng dựa trên tài liệu chính thức và codex --help bản 0.162.1, đọc ngày 03/11/2026. Phần kỹ thuật git như worktree hay chuẩn hoá xuống dòng đã có ở bài nhiều phiên AI cùng sửa một dự án, bài này tập trung vào cách chia việc.

Hai tác tử, một bộ luật chung: hướng dẫn, trạng thái, commit và review chéo. Sơ đồ: OPCAIOS.

Vì sao một người lại dùng cả Codex lẫn Claude Code?

Một người dùng cả Codex lẫn Claude Code vì ba lý do thực dụng: hai công cụ có điểm mạnh và cách làm việc khác nhau, mỗi công cụ có hạn mức sử dụng riêng theo gói của hãng đó, và một tác tử khác hãng là người kiểm tra tự nhiên cho việc của tác tử còn lại. Thứ nhất, Codex có codex exec chạy không tương tác, codex review và bản trên đám mây; Claude Code có subagent, skill, hooks và chế độ lập kế hoạch riêng. Thứ hai, khi một công cụ chạm hạn mức, việc tiếp tục ở công cụ kia nếu cả hai đọc cùng bối cảnh. Thứ ba, mô hình hai hãng khác nhau nên lỗi mô hình này bỏ qua đôi khi mô hình kia thấy. Đây là lập luận, không phải số liệu đo. So sánh chi tiết hai công cụ, kèm giá, có ở bài Claude Code, Cursor hay Codex CLI.

Chia việc cho Codex và Claude Code theo vai trò thế nào?

Chia việc theo vai trò nghĩa là mỗi loại việc có một tác tử "chủ", tác tử còn lại chỉ đọc hoặc review. Bảng dưới là gợi ý của OPCAIOS, không phải quy tắc của OpenAI hay Anthropic:

Loại việc	Tác tử chủ (gợi ý)	Tác tử kia làm gì
Tính năng lớn nhiều file	Một tác tử cố định cho cả tính năng	Review bản thay đổi trước khi gộp
Review code	Tác tử không viết đoạn code đó	Sửa theo nhận xét
Việc chạy định kỳ không người trông	Tác tử có chế độ chạy không tương tác bạn đã quen	Không tham gia

Nguyên tắc chung: một file tại một thời điểm chỉ có một tác tử chủ.

Một file AGENTS.md chung và file riêng cho từng tác tử đặt thế nào?

Một file AGENTS.md chung là nơi viết một lần các quy tắc mà mọi tác tử phải theo, còn file riêng chỉ chứa điều đặc thù cho từng công cụ. Theo trang AGENTS.md trong tài liệu Codex (learn.chatgpt.com, đọc ngày 03/11/2026), Codex đọc AGENTS.md ở thư mục Codex của người dùng, mặc định ~/.codex, rồi đọc từ gốc dự án đi xuống thư mục hiện tại; file gần hơn ghi đè file xa hơn, tổng dung lượng mặc định tối đa 32 KiB theo khoá project_doc_max_bytes. Theo trang memory của Claude Code (code.claude.com, đọc ngày 03/11/2026), Claude Code đọc AGENTS.md khi không có CLAUDE.md; nếu có CLAUDE.md thì chỉ đọc CLAUDE.md, trừ khi file đó nhập AGENTS.md bằng @AGENTS.md. Cách bố trí gợi ý gồm 3 tầng:

1. AGENTS.md ở gốc dự án: lệnh build, lệnh kiểm thử, cấu trúc thư mục, điều cấm.
2. CLAUDE.md chỉ có dòng @AGENTS.md cộng vài điều riêng cho Claude Code.
3. File cấp người dùng của mỗi công cụ (~/.codex/AGENTS.md cho Codex, file người dùng của Claude Code): ngôn ngữ trả lời, thứ tự đọc tài liệu đầu phiên.

Chi tiết cú pháp có ở bài AGENTS.md là gì và CLAUDE.md là gì.

File trạng thái chung và nhật ký giúp hai tác tử phối hợp ra sao?

File trạng thái chung là tài liệu ngắn mà cả Codex lẫn Claude Code đọc đầu phiên và cập nhật cuối phiên, vì hai tác tử không chia sẻ trí nhớ với nhau. Một file trạng thái tốt có bốn phần:

1. Trạng thái dịch vụ, kèm thời điểm kiểm tra thật.
2. Sự cố đang mở và ai đang xử lý.
3. Việc đang giữ: tác tử nào đang sửa khu vực nào, để tác tử kia tránh.
4. Nhật ký gần đây, mỗi việc xong một dòng, giới hạn số dòng để file không phình.

Nhật ký ngày ghi chi tiết hơn: đã làm gì, còn dở gì. Quy tắc đọc hai file này đặt trong AGENTS.md chung. Lưu ý: nhật ký là bằng chứng lịch sử, không phải trạng thái hiện tại; trước khi dùng một cổng hay một kết quả deploy ghi trong đó, tác tử vẫn phải kiểm tra thật.

Quy tắc commit và "một máy một dự án" để tránh đụng nhau là gì?

Quy tắc commit đúng file nghĩa là mỗi phiên, dù của Codex hay Claude Code, chỉ đưa vào commit đúng những file chính nó sửa, với danh sách đường dẫn ghi ngay trên lệnh commit. Lý do: khi hai tác tử dùng chung một thư mục làm việc, chúng dùng chung vùng chờ commit, và một lệnh commit trần sẽ cuốn theo file của tác tử kia. Cả hai công cụ đều có cách tách hẳn thư mục: codex --help bản 0.162.1 có cờ --worktree để chạy phiên trong một git worktree mới, còn Claude Code có cờ tương tự. Bài nhiều phiên AI cùng sửa một dự án đi sâu phần lệnh git, ở đây chỉ nêu luật phối hợp:

1. Mỗi tác tử một nhánh hoặc một worktree khi làm tính năng dài.
2. Commit có đường dẫn, xem lại commit trước khi đẩy.
3. Gộp nhánh chính mới nhất trước khi deploy.
4. Một dự án chỉ sửa code trên một máy, nếu bạn có nhiều máy.

Quy tắc thứ tư hay bị bỏ qua: tác tử trên Windows và trên Mac cùng sửa một dự án dễ sinh thay đổi giả hàng loạt do khác kiểu xuống dòng và phiên bản công cụ.

Review chéo giữa Codex và Claude Code làm thế nào?

Review chéo là để tác tử không viết code đọc bản thay đổi và tìm lỗi trước khi gộp, tận dụng việc hai mô hình khác hãng nhìn vấn đề khác nhau. Codex có lệnh codex review chạy review không tương tác, theo codex --help bản 0.162.1; Claude Code có thể được giao đọc một diff như mọi yêu cầu khác. Quy trình gợi ý gồm 4 bước:

1. Tác tử A viết xong, commit trên nhánh riêng.
2. Tác tử B đọc diff của nhánh đó, chỉ được ghi nhận xét, không sửa code.
3. Người chủ đọc nhận xét, bỏ những ý sai, giao lại cho tác tử A sửa.
4. Chạy kiểm thử rồi mới gộp.

Bước 2 quan trọng nhất: tác tử review mà được sửa thì hai bên sẽ sửa chồng. Nhận xét của AI cũng có thể sai, người chủ quyết định cuối.

Dùng hai tác tử cùng lúc có những rủi ro gì?

Dùng hai tác tử cùng lúc có ba rủi ro chính: ghi đè việc của nhau, tốn gấp đôi, và mâu thuẫn hướng dẫn. Cụ thể:

1. Ghi đè: hai tác tử cùng sửa một file, tác tử lưu sau xoá phần của tác tử trước mà không báo lỗi. Chống bằng "một file một chủ".
2. Tốn gấp đôi: giao cùng một việc cho cả hai "để xem ai làm tốt hơn" tiêu hạn mức của cả hai gói và bạn phải đọc hai bản kết quả.
3. Mâu thuẫn hướng dẫn: AGENTS.md nói một đằng, CLAUDE.md nói một nẻo, mỗi tác tử làm theo một kiểu. Chống bằng cách để quy tắc chung ở đúng một chỗ, file riêng chỉ bổ sung.

Giả định, không phải người thật: một người giao cho Codex sửa trang thanh toán và quên ghi vào file trạng thái, phiên Claude Code mở sau thấy lỗi cũ và sửa lại theo cách khác, kết quả là hai bản sửa xung đột.

Kinh nghiệm của OPCAIOS

Dùng Codex và Claude Code cùng lúc là cách OPCAIOS, website opcaios.org do một người vận hành, đang làm. Những điều có thật, kiểm tra ngày 03/11/2026:

1. Máy làm việc chính có Codex CLI bản 0.162.x và ứng dụng desktop Codex, dùng song song với Claude Code và Google Antigravity.
2. Có AGENTS.md chung cho mọi tác tử ở thư mục gốc người dùng và trong kho ghi chú Obsidian; Codex có thêm AGENTS.md cấp người dùng, nội dung tương đương file hướng dẫn cấp người dùng của Claude Code: trả lời tiếng Việt, thứ tự đọc tài liệu đầu phiên, ghi nhật ký cuối phiên.
3. Các tác tử đồng bộ qua một file trạng thái chung và nhật ký ngày; mỗi phiên chỉ commit đúng file của mình.
4. Một số dự án có quy định chỉ được sửa code trên một máy nhất định. Quy định này có từ khi thấy hơn 1.500 file khác nhau chỉ vì kiểu xuống dòng, lúc một tác tử deploy từ máy Windows.
5. Cấu hình Codex dùng mức suy nghĩ "medium" mặc định và giao subagent cho một model nhỏ hơn để tiết kiệm.
6. OPCAIOS từng để một tác tử review việc của tác tử khác, nhưng chưa đo hiệu quả, và chưa dùng Codex review code thường xuyên.

Chúng tôi chưa so sánh chất lượng hay chi phí giữa hai công cụ trên cùng một việc, nên không khuyên vai cố định.

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

Có thể cho Codex và Claude Code sửa cùng một file không?

Không nên cùng lúc. Hai tác tử không biết nhau đang sửa gì, nên tác tử lưu sau có thể xoá phần của tác tử trước mà không báo. Nếu buộc phải chung file, làm tuần tự: A xong, commit, ghi trạng thái, rồi mới giao B. Tốt hơn là mỗi tác tử một nhánh hoặc worktree riêng. Codex CLI có cờ --worktree theo codex --help bản 0.162.1.

Claude Code có đọc được AGENTS.md của Codex không?

Có, theo tài liệu Claude Code đọc ngày 03/11/2026, nhưng có điều kiện. Claude Code đọc AGENTS.md khi dự án không có CLAUDE.md ở thư mục làm việc hay thư mục cha. Nếu đã có CLAUDE.md, Claude Code chỉ đọc CLAUDE.md, trừ khi trong đó có dòng @AGENTS.md để nhập. File cấp người dùng của hai công cụ thì tách biệt, phải viết cả hai.

Dùng hai công cụ có tốn gấp đôi tiền không?

Tuỳ cách dùng và gói của từng hãng; bài này không nêu giá vì giá thay đổi, bảng giá có ở bài Claude Code, Cursor hay Codex CLI. Tốn gấp đôi thật sự xảy ra khi giao cùng một việc cho cả hai. Chia vai rõ thì chi phí là phí hai gói cộng lại, đổi lại thêm hạn mức và một người review khác hãng.

File trạng thái chung nên đặt ở đâu?

Đặt ở nơi mọi tác tử trên mọi máy đều đọc được, và ghi đường dẫn của nó trong AGENTS.md chung để tác tử biết đọc đầu phiên. Có thể trong kho mã, hoặc kho ghi chú như Obsidian nếu nhiều dự án dùng chung. Giữ file ngắn, dòng nhật ký cũ chuyển sang file lưu trữ. Không ghi khoá, mật khẩu hay token vào file này.

Người mới có nên dùng hai tác tử ngay từ đầu không?

Không. Nên dùng thành thạo một tác tử trước, có AGENTS.md, có thói quen commit đúng file và đọc diff, rồi mới thêm tác tử thứ hai. Luật chưa vững thì hai tác tử chỉ làm rối gấp đôi. Bắt đầu tác tử thứ hai bằng vai an toàn nhất là review chỉ đọc. Bài quy trình an toàn cho người không biết code có các bước nền. Muốn được hướng dẫn dựng quy trình nhiều tác tử, xem khoá đào tạo ứng dụng AI của OPCAIOS.

Nguồn: tài liệu Codex trên learn.chatgpt.com (trang AGENTS.md, chuyển hướng từ developers.openai.com/codex), codex --help của Codex CLI 0.162.1, tài liệu Claude Code trên code.claude.com (trang memory), đọc ngày 03/11/2026. Điều chưa kiểm chứng: hiệu quả của review chéo, chi phí khi dùng song song, cách Codex desktop xử lý worktree; tính năng có thể đổi theo phiên bản. Bảng chia vai là gợi ý. Kinh nghiệm là của OPCAIOS.