# Antigravity, Claude Code và Codex trong một hệ thống: ai làm việc gì

URL: https://opcaios.org/blog/antigravity-claude-code-va-codex-trong-mot-he-thong
Ngày: 2026-11-03
Cập nhật: 2026-11-03
Tác giả: Lê Quốc Nghĩa
Chuyên mục: Hướng dẫn

Dùng Antigravity, Claude Code và Codex trong một hệ thống là cách một người chia việc cho ba tác tử lập trình của ba hãng (Google, Anthropic, OpenAI) theo vai rõ ràng: một tác tử điều phối giữ bức tranh chung, các tác tử thực thi sửa code ở đúng dự án và đúng máy được giao, tất cả cùng đọc một bộ luật và một file trạng thái. Bài này không xếp hạng ba công cụ, không hứa tiết kiệm thời gian hay tiền vì OPCAIOS chưa đo, và cách chia vai là quy ước của chúng tôi, không phải khuyến nghị của hãng nào. Bảng so sánh lấy từ tài liệu chính thức của mỗi bên và từ `--help` của từng CLI, đọc ngày 03/11/2026. Chia việc giữa hai tác tử đã có ở bài [dùng Codex và Claude Code cùng lúc](/blog/dung-codex-va-claude-code-cung-luc); bài này tập trung vào chỗ Antigravity khác và vai của nó trong bộ ba.

![Sơ đồ ba tác tử trong một hệ thống: Antigravity ở vai điều phối quản lý hạ tầng và giao việc, Claude Code và Codex ở vai thực thi trên từng dự án, một dự án chỉ sửa trên một máy, AGENTS.md dùng chung, file trạng thái chung ở giữa làm kênh bàn giao](https://opcaios.org/images/blog/antigravity-claude-code-va-codex-trong-mot-he-thong/so-do.webp)
*Một tác tử điều phối, các tác tử thực thi, một bộ luật và một file trạng thái chung. Sơ đồ: OPCAIOS.*

## Tác tử điều phối và tác tử thực thi khác nhau thế nào?

Tác tử điều phối là tác tử giữ bức tranh toàn hệ thống: đọc trạng thái, kiểm tra dịch vụ, chia việc, theo dõi việc đã giao và ghi lại kết quả; tác tử thực thi là tác tử nhận một việc cụ thể trong một dự án cụ thể, sửa code, chạy kiểm thử, commit và báo lại. Đây là quy ước của OPCAIOS, không phải tính năng của hãng nào: cả ba công cụ đều sửa được code và chạy được lệnh, nên vai do người chủ đặt. Lý do tách vai:

1. Một nơi giữ bối cảnh chung: biết dịch vụ nào đang lỗi và ai đang giữ việc gì.
2. Một chủ cho mỗi dự án: giảm việc hai tác tử sửa chồng.
3. Dễ truy lỗi: biết ngay phiên nào, máy nào đã sửa.

## Bảng so sánh vai trò ba công cụ theo tài liệu chính thức

Bảng dưới chỉ ghi sự thật đã thấy trong tài liệu hoặc `--help` ngày 03/11/2026; cột cuối là cách OPCAIOS đang dùng, không phải đánh giá chất lượng:

| Tiêu chí | Google Antigravity | Claude Code | Codex |
|---|---|---|---|
| Bề mặt | Ứng dụng Antigravity, Antigravity IDE, CLI `agy`, tiện ích cho IDE khác | Terminal, VS Code, JetBrains, ứng dụng desktop, web | Ứng dụng ChatGPT (desktop, mobile, web), Codex CLI, tiện ích IDE, Codex Cloud |
| Model | Gemini, Claude, GPT-OSS tuỳ gói (/docs/models) | Claude; CLI và tiện ích IDE hỗ trợ thêm nhà cung cấp bên thứ ba | Model của OpenAI |
| File hướng dẫn | `AGENTS.md` hoặc `GEMINI.md`, cộng dồn mọi cấp | `CLAUDE.md`; đọc `AGENTS.md` khi không có `CLAUDE.md` | `AGENTS.md`, từ thư mục người dùng xuống dự án |
| Chạy không tương tác | `agy -p` | `claude -p` | `codex exec` |
| Tách thư mục làm việc | Ứng dụng hỗ trợ worktree; tác tử con có thể chạy trên worktree riêng | Cờ `-w, --worktree` | Cờ `--worktree` |
| Vai ở OPCAIOS | Điều phối | Thực thi | Thực thi, review |

Bài trụ cột [Antigravity là gì](/blog/antigravity-la-gi) có phần giới thiệu ứng dụng, IDE và CLI nếu bạn mới nghe tên công cụ này.

## Antigravity khác Claude Code và Codex ở những điểm nào?

Antigravity khác hai công cụ còn lại ở năm điểm ảnh hưởng tới cách ghép hệ thống, theo tài liệu tại antigravity.google đọc ngày 03/11/2026. Không điểm nào nói Antigravity mạnh hay yếu hơn; chúng chỉ đổi cách đặt luật và chia việc:

1. Luật cộng dồn: theo /docs/rules, Antigravity đọc `AGENTS.md` hoặc `GEMINI.md` ở thư mục làm việc và thư mục cha tới gốc kho, cộng luật toàn cục, rồi gộp tất cả. Claude Code thì ưu tiên `CLAUDE.md`.
2. Nhiều họ model: Gemini, Claude hoặc GPT-OSS tuỳ gói, xem bài [chọn model trong Antigravity](/blog/chon-model-trong-antigravity).
3. Tác tử con có sẵn: /docs/subagents liệt kê `research`, `browser` và `self`; `browser` chạy trình duyệt trong sandbox, gọi bằng `/browser`.
4. Nhóm tác tử: lệnh `/teamwork` cho dự án nhiều ngày, chỉ có ở gói trả phí.
5. Điều khoản đăng nhập: /docs/faq nói dùng phần mềm bên thứ ba (có nêu Claude Code) để truy cập Antigravity bằng tài khoản Antigravity là vi phạm điều khoản, và bọc `agy -p` trong tác tử bên thứ ba không được hỗ trợ với gói cá nhân.

Điểm thứ năm quan trọng nhất: đừng cho Claude Code hay Codex gọi Antigravity như một "thợ" bằng tài khoản cá nhân. Ba công cụ phối hợp qua file chung, mỗi công cụ đăng nhập bằng tài khoản của hãng mình.

## Vì sao Antigravity được giao vai điều phối trong hệ thống của OPCAIOS?

Antigravity được giao vai điều phối trong hệ thống của OPCAIOS vì cách ứng dụng Antigravity tổ chức công việc khớp với việc trông nhiều mảng cùng lúc, không phải vì đã đo thấy nó tốt hơn. Theo tài liệu đọc ngày 03/11/2026, ứng dụng cho chạy nhiều cuộc hội thoại tác tử song song, tác tử chính gọi được nhiều tác tử con cùng lúc và theo dõi chúng trong bảng riêng, và mọi gói đều có tác vụ theo lịch. Việc của tác tử điều phối gồm:

1. Kiểm tra hạ tầng và đọc file trạng thái đầu phiên.
2. Giao việc bằng cách ghi việc, dự án, máy và tác tử chủ vào file trạng thái.
3. Theo dõi kết quả, cập nhật sự cố và nhật ký.

Claude Code và Codex cũng có tác tử con, lịch chạy và chế độ không tương tác, nên đổi vai vẫn được. Điều cần giữ là chỉ một tác tử điều phối tại một thời điểm, nếu không file trạng thái sẽ có hai bản kế hoạch mâu thuẫn.

## AGENTS.md dùng chung cho ba tác tử đặt thế nào?

AGENTS.md dùng chung là một file luật cả ba công cụ đọc được, nhưng mỗi công cụ tìm file theo cách riêng. Theo tài liệu đọc ngày 03/11/2026: Codex đọc `AGENTS.md` ở thư mục Codex của người dùng rồi từ gốc dự án xuống; Claude Code đọc `AGENTS.md` khi không có `CLAUDE.md`, hoặc khi `CLAUDE.md` nhập nó; Antigravity đọc `AGENTS.md` hoặc `GEMINI.md` và cộng dồn, với luật toàn cục ở `~/.gemini/GEMINI.md` hoặc `~/.gemini/AGENTS.md`. Cách bố trí gợi ý:

1. Quy tắc chung (đọc gì đầu phiên, ghi gì cuối phiên, ai sửa dự án nào) viết một lần trong `AGENTS.md`.
2. `CLAUDE.md` chỉ nhập `@AGENTS.md` cộng phần riêng của Claude Code.
3. `GEMINI.md` giữ thật ngắn, vì Antigravity cộng nó với `AGENTS.md`; hai file nói khác nhau thì tác tử nhận cả hai lệnh mâu thuẫn.

Cú pháp chi tiết có ở bài [AGENTS.md là gì](/blog/agents-md-la-gi); luật dạng thư mục `.agents/rules/` của Antigravity có ở bài [rules và workflows trong Antigravity](/blog/rules-va-workflows-trong-antigravity).

## Vì sao "một dự án chỉ sửa trên một máy"?

"Một dự án chỉ sửa trên một máy" là quy định mỗi kho code chỉ được sửa và deploy từ đúng một máy, dù hệ thống có nhiều máy và nhiều tác tử. Quy định này sinh ra từ một lần lệch thật của OPCAIOS: khi một tác tử deploy website từ máy Windows, bản so sánh hiện hơn 1.500 file khác nhau chỉ vì kiểu xuống dòng (Windows dùng CRLF, macOS và Linux dùng LF). Thay đổi giả che mất thay đổi thật, và tác tử khác có thể commit nhầm cả loạt. Với bộ ba, nguy cơ cao hơn vì tác tử điều phối và tác tử thực thi thường ở hai máy khác nhau. Luật áp dụng:

1. Mỗi kho code ghi rõ máy chủ quản trong `AGENTS.md` và file trạng thái.
2. Chỉ giao việc sửa kho đó cho tác tử trên đúng máy ấy.
3. Muốn đổi máy thì đổi trong file trạng thái trước.

Cách chuẩn hoá xuống dòng bằng `.gitattributes` có ở bài [nhiều phiên AI cùng sửa một dự án](/blog/nhieu-phien-ai-cung-sua-mot-du-an).

## File trạng thái chung giúp bàn giao giữa điều phối và thực thi ra sao?

File trạng thái chung là kênh bàn giao giữa tác tử điều phối và tác tử thực thi, vì ba công cụ không chia sẻ trí nhớ và không nên gọi nhau bằng tài khoản cá nhân. Một dòng giao việc ghi đủ bốn thứ:

1. Việc cần làm, mô tả một câu.
2. Dự án và máy được sửa.
3. Tác tử chủ và thời điểm giao.
4. Trạng thái: đang làm, xong, kẹt, kèm thời điểm kiểm tra thật.

Giả định, không phải người thật: tác tử điều phối thấy trang đăng ký lỗi, ghi một dòng giao cho Claude Code trên máy giữ kho website; phiên Claude Code đọc dòng đó, sửa, commit đúng file, ghi "xong" kèm kết quả kiểm thử; phiên điều phối kế tiếp kiểm tra lại trang thật rồi mới đóng sự cố.

## Kinh nghiệm của OPCAIOS

OPCAIOS là website opcaios.org do một người vận hành bằng tác tử AI. Những điều có thật, kiểm tra ngày 03/11/2026:

1. Máy Mac chính có ứng dụng Antigravity bản 2.28.x, Antigravity IDE bản 2.5.x và CLI `agy` bản 1.4.12, dùng song song với Claude Code và Codex.
2. Antigravity giữ vai điều phối: quản lý hạ tầng, giao và theo dõi việc. Nó cũng từng làm một số tính năng quản trị cho website, ví dụ theo dõi đối tượng Dream 100 trên Facebook và X, và sửa menu website.
3. Code website có quy định chỉ sửa và deploy từ một máy khác (máy Windows), sau lần thấy hơn 1.500 file khác nhau vì kiểu xuống dòng.
4. Trên máy có hơn 400 cuộc hội thoại Antigravity lưu cục bộ (đếm thư mục, không đọc nội dung).
5. `GEMINI.md` cấp người dùng chỉ có một dòng: luôn trả lời tiếng Việt. Luật chung nằm trong `AGENTS.md` ở thư mục gốc người dùng và trong kho ghi chú Obsidian.
6. Ứng dụng Antigravity khai báo 14 MCP server; hook chỉ dùng để báo trạng thái phiên, chưa có hook chặn lệnh; workflow toàn cục duy nhất là mẫu trống; chưa thấy mục knowledge nào được tạo.
7. Chưa dùng Antigravity SDK, chưa dùng Remote Control, chưa dùng `/teamwork`, và chưa đo năng suất của cách chia vai này.

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

### Có cần dùng cả ba công cụ không?

Không. Ba công cụ là lựa chọn của OPCAIOS, không phải điều kiện để làm OPC. Một tác tử dùng thành thạo, có `AGENTS.md`, có thói quen commit đúng file và đọc diff, đủ cho phần lớn việc của người làm một mình. Chỉ thêm công cụ khi có lý do cụ thể như cần hạn mức của gói khác hoặc một người review khác hãng. Mỗi công cụ thêm vào là thêm một gói phí và một bộ luật phải giữ khớp.

### Dùng tài khoản Antigravity cho Claude Code được không?

Không. Trang /docs/faq của Antigravity đọc ngày 03/11/2026 ghi rằng dùng phần mềm bên thứ ba, có nêu tên Claude Code, để truy cập Antigravity bằng tài khoản Antigravity là vi phạm điều khoản và có thể bị khoá tài khoản. Google gợi ý dùng khoá API của Gemini Enterprise hoặc Google AI Studio nếu muốn tác tử bên thứ ba dùng Gemini. Trang này cũng nói bọc `agy -p` trong tác tử bên thứ ba không được hỗ trợ với gói cá nhân. Đây là mô tả điều khoản, không phải tư vấn pháp lý.

### Antigravity có đọc AGENTS.md giống Codex không?

Có đọc, nhưng cách gộp khác. Theo /docs/rules đọc ngày 03/11/2026, Antigravity tìm `AGENTS.md` hoặc `GEMINI.md` ở thư mục làm việc và các thư mục cha tới gốc kho, cộng với luật toàn cục, rồi gộp tất cả vào prompt. Nó không đọc luật ở thư mục con bên dưới thư mục làm việc. Vì cộng dồn, nếu `GEMINI.md` và `AGENTS.md` nói khác nhau, tác tử nhận cả hai, nên giữ quy tắc chung ở một file duy nhất.

### Tác tử điều phối có nên tự sửa code không?

Có thể, nhưng chỉ khi việc đó được ghi trong file trạng thái như mọi việc khác, và chỉ trên đúng máy được phép sửa dự án đó. Ở OPCAIOS, Antigravity từng sửa trực tiếp tính năng quản trị và menu website. Rủi ro là tác tử điều phối quen tay sửa ở máy mình, vi phạm luật "một dự án một máy". Khi tự làm, tác tử điều phối ghi mình là tác tử chủ của việc ấy.

### Người mới nên bắt đầu ghép ba công cụ từ đâu?

Bắt đầu từ luật, không phải từ công cụ. Viết một `AGENTS.md` chung, một file trạng thái ngắn và quy định mỗi dự án sửa trên máy nào. Dùng một tác tử cho đến khi thói quen đọc trạng thái và ghi nhật ký chạy đều, rồi thêm tác tử thứ hai ở vai review chỉ đọc, sau cùng mới tách vai điều phối. 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](/services/dao-tao-ung-dung-ai) của OPCAIOS.

*Nguồn: tài liệu Google Antigravity tại antigravity.google (/docs/rules, /docs/subagents, /docs/teamwork, /docs/agent, /docs/models, /docs/plans, /docs/faq), tài liệu Claude Code tại code.claude.com (trang overview, memory), tài liệu Codex tại learn.chatgpt.com (trang tổng quan, AGENTS.md), `agy --help` 1.4.12, `claude --help` 2.1.317, `codex --help` 0.162.1; đọc ngày 03/11/2026. Điều chưa kiểm chứng: hiệu quả của cách chia vai điều phối và thực thi, chi phí khi dùng ba gói song song, khả năng worktree của Antigravity CLI; tính năng có thể đổi theo phiên bản. Kinh nghiệm là của OPCAIOS.*