canonical_url: https://yycode.net/docs/vi/claude-code-codex-collaboration-guide
lang: vi
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/vi/claude-code-codex-collaboration-guide

# Hướng dẫn phối hợp phát triển Claude Code và Codex

## Vì sao nên kết hợp như vậy?

Một câu thôi: **để mô hình đắt tiền suy nghĩ, để mô hình rẻ tiền làm việc, hóa đơn không nổ tung.**

Claude giỏi hiểu nhu cầu, lập kế hoạch kiến trúc, suy luận phức tạp, nhưng giá cũng nằm đó — dùng nó để viết lượng lớn code thì Token cháy rất nhanh. Codex có năng lực code mạnh, tốc độ nhanh, quan trọng là giá rẻ hơn nhiều.

Vì vậy cách kết hợp hợp lý nhất là:

- **Claude phụ trách lập kế hoạch**: hiểu nhu cầu của bạn, chia nhỏ nhiệm vụ, đưa ra quyết định kiến trúc, nghĩ rõ cách làm
- **Codex phụ trách thực thi**: nhận các nhiệm vụ coding cụ thể qua `/codex:rescue`, viết code, sửa bug, chạy test
- **Codex phụ trách review**: dùng `/codex:review` để code review mã do Claude viết, đóng vai trò đôi mắt thứ hai

Logic cốt lõi của cách kết hợp này là: Token của Claude chỉ dùng cho phần "nghĩ cho rõ", còn coding và review cụ thể giao cho Codex rẻ hơn. Với người dùng Claude Code cường độ cao hằng ngày, cách này có thể giảm đáng kể chi phí tổng thể.

> Hướng dẫn này giả định bạn đã hoàn tất cài đặt và cấu hình Claude Code và Codex. Nếu chưa hoàn tất, vui lòng tham khảo trước:
> - Cấu hình Claude Code: [Hướng dẫn bắt đầu nhanh yycode](DragonCode快速开始指南.md)
> - Cấu hình Codex: [Hướng dẫn bắt đầu nhanh yycode × Codex](DragonCode-Codex快速开始指南.md)

---

## 1. Cài đặt plugin Codex

Sau khi hai bên đều cấu hình xong, cài một plugin trong Claude Code là có thể nối chúng lại:

```bash
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
```

`/codex:setup` sẽ tự động kiểm tra Codex đã cài chưa, đã xác thực chưa. Nếu báo chưa đăng nhập, chạy `!codex login` để hoàn tất xác thực.

Sau khi cài xong, nhập `/codex` là có thể thấy các slash command mới.

---

## 2. Lệnh cốt lõi

Plugin này tổng cộng có ba loại năng lực: **review**, **ủy quyền nhiệm vụ**, **quản lý nhiệm vụ**.

### Nhóm review (chỉ đọc, không sửa code)

| Lệnh | Tác dụng |
|---|---|
| `/codex:review` | Cho Codex review các thay đổi chưa commit hiện tại, hoặc so sánh branch |
| `/codex:adversarial-review` | Review đối kháng — không chỉ kiểm tra code, mà chủ động chất vấn quyết định thiết kế của bạn |

```bash
# Review thay đổi chưa commit
/codex:review

# Review khác biệt giữa branch hiện tại và main
/codex:review --base main

# Chạy nền, không chặn cuộc trò chuyện hiện tại
/codex:review --background

# Review đối kháng, chỉ định hướng cần tập trung
/codex:adversarial-review --background kiểm tra có race condition không, chất vấn lựa chọn chiến lược cache
```

### Nhóm ủy quyền (giao nhiệm vụ cho Codex thực thi)

| Lệnh | Tác dụng |
|---|---|
| `/codex:rescue` | Giao một nhiệm vụ cụ thể cho Codex làm, Codex sẽ thực sự sửa code |

Đây là lệnh cốt lõi để thực hiện "Claude lập kế hoạch, Codex thực thi". Bạn có thể giao từng nhiệm vụ mà Claude đã lập kế hoạch cho Codex triển khai:

```bash
# Cho Codex đi điều tra bug
/codex:rescue investigate why the tests started failing

# Cho Codex sửa bug
/codex:rescue fix the failing test with the smallest safe patch

# Cho Codex triển khai một tính năng
/codex:rescue 实现用户注册的表单验证逻辑

# Chạy nền, phù hợp nhiệm vụ tốn thời gian
/codex:rescue --background 重构数据库连接池

# Chỉ định mô hình rẻ hơn để tiết kiệm thêm
/codex:rescue --model gpt-5.4-mini 写一组单元测试覆盖 utils.ts
/codex:rescue --model spark 快速修复这个 lint 错误

# Tiếp tục nhiệm vụ lần trước
/codex:rescue --resume 把上次的修复方案应用上去
```

> 💡 **Mẹo tiết kiệm tiền**: `--model gpt-5.4-mini` hoặc `--model spark` có thể dùng mô hình rẻ hơn và nhanh hơn để làm nhiệm vụ đơn giản.

### Nhóm quản lý nhiệm vụ

| Lệnh | Tác dụng |
|---|---|
| `/codex:status` | Xem các nhiệm vụ Codex đang chạy và vừa hoàn tất gần đây |
| `/codex:result` | Lấy kết quả nhiệm vụ đã hoàn tất (kèm session ID, có thể tiếp tục trong Codex) |
| `/codex:cancel` | Hủy nhiệm vụ nền đang chạy |

---

## 3. Workflow khuyến nghị: Claude lập kế hoạch, Codex thực thi

### Quy trình phát triển hằng ngày

```
Bạn nêu nhu cầu → Claude phân tích chia nhỏ → /codex:rescue thực thi từng việc → /codex:review review → commit
```

1. **Mô tả nhu cầu bằng ngôn ngữ tự nhiên**, để Claude hiểu bạn muốn gì
2. **Claude lập kế hoạch**: chia nhỏ nhiệm vụ, xác định phương án triển khai, làm rõ thứ tự trước sau — đây là điểm Claude giỏi nhất
3. **Dùng `/codex:rescue` giao nhiệm vụ coding cụ thể cho Codex**: Claude đã lập kế hoạch "cần làm A, B, C", bạn dùng rescue giao từng việc cho Codex viết
4. **Code xong thì chạy review**: `/codex:review --background`, để Codex làm code review độc lập
5. Sửa theo ý kiến review rồi commit

Lợi ích của quy trình này là: Token của Claude chỉ dùng cho lập kế hoạch và hiểu vấn đề, còn lượng lớn coding đi qua hạn mức rẻ của Codex.

### Quy trình thay đổi rủi ro cao

Khi liên quan đến migration database, xác thực phân quyền, thay đổi hạ tầng, hãy thêm một lớp review đối kháng:

```
Claude lập kế hoạch → /codex:rescue thực thi → /codex:review → sửa → /codex:adversarial-review → sửa tiếp → commit
```

Review đối kháng sẽ chủ động chất vấn thiết kế của bạn — ví dụ "vì sao chọn chiến lược cache này", "đã nghĩ đến phương án rollback chưa", "chỗ này có race condition không". Thay đổi rủi ro cao cần loại kiểm thử áp lực này.

### Khi Claude bị kẹt

Nếu Claude thử đi thử lại một nhiệm vụ mà vẫn không lý tưởng, hãy đổi trực tiếp sang Codex:

```bash
/codex:rescue 用最小改动修复这个问题
```

Đổi góc nhìn mô hình thường có thể phá thế bế tắc.

---

## 4. Chạy nền (khuyến nghị)

Review và rescue đều nên thêm `--background` để không chặn cuộc trò chuyện hiện tại:

```bash
/codex:rescue --background 实现分页功能
# Tiếp tục trò chuyện với Claude về việc khác...
/codex:status          # Xem tiến độ bất cứ lúc nào
/codex:result          # Lấy kết quả sau khi hoàn tất
```

> `/codex:result` sẽ trả về một session ID, bạn có thể dùng `codex resume <session-id>` để tiếp tục nhiệm vụ này trong Codex.

---

## 5. Cổng review (tùy chọn)

Sau khi bật, trước khi Claude Code hoàn tất nhiệm vụ sẽ tự động kích hoạt một lần Codex review; nếu phát hiện vấn đề thì ngắt quy trình để sửa trước:

```bash
/codex:setup --enable-review-gate    # Bật
/codex:setup --disable-review-gate   # Tắt
```

> ⚠️ **Lưu ý**: Cổng review sẽ làm tăng đáng kể tiêu hao Token, có thể gây vòng lặp dài giữa Claude và Codex. Khuyến nghị chỉ dùng trong dự án quan trọng; phát triển hằng ngày chỉ cần chạy thủ công `/codex:review`.

---

## 6. Cấu hình mô hình Codex

Muốn đổi mô hình mặc định hoặc cường độ suy luận của Codex, có thể đặt trong file cấu hình.

Cấu hình cấp người dùng: `~/.codex/config.toml`
Cấu hình cấp dự án: `.codex/config.toml` dưới thư mục gốc dự án

```toml
model = "gpt-5.4-mini"
model_reasoning_effort = "high"
```

Cũng có thể chỉ định tạm thời bằng `--model` và `--effort` cho từng lần gọi:

```bash
/codex:rescue --model spark --effort medium 快速修复 lint 错误
```

---

## 7. Khi nào không nên dùng Codex

Các tình huống sau khuyến nghị dùng Claude toàn trình:

| Tình huống | Lý do |
|---|---|
| Refactor logic nghiệp vụ sâu | Codex không có đầy đủ ngữ cảnh tích lũy trong cuộc trò chuyện Claude, code sinh ra có thể không khớp phong cách dự án |
| Nhiệm vụ cần hiểu sâu xuyên nhiều file | Codex rescue chạy độc lập, không chia sẻ lịch sử đối thoại của Claude |
| Nhiệm vụ chỉ có rất ít code | Chỉ vài dòng code, không cần ủy quyền; để Claude viết trực tiếp nhanh hơn |

---

## 8. Mẹo thực dụng

- **Nhiệm vụ đơn giản dùng mô hình rẻ**: `--model spark` phù hợp sửa lint, viết boilerplate, các việc không cần suy luận sâu
- **Review trước rồi adversarial-review**: đừng dùng review đối kháng ngay từ đầu, hãy dùng review thường để quét vấn đề cơ bản trước
- **Tận dụng --resume**: `/codex:rescue --resume` có thể tiếp tục nhiệm vụ Codex lần trước, không cần bắt đầu lại
- **Theo dõi usage hai bên**: tổng thể tiết kiệm hơn, nhưng nhớ theo dõi đồng thời usage của Claude và OpenAI để tránh một bên bất ngờ vượt mức
- **Xử lý xung đột Skill**: nếu Skill tùy chỉnh của bạn xung đột trigger word với plugin Codex, thêm `priority: low` vào Skill bị xung đột

---

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

**Q: Sau khi cài plugin không thấy lệnh `/codex`?**
A: Chạy `/reload-plugins` để tải lại plugin.

**Q: `/codex:review` báo lỗi xác thực?**
A: Nghĩa là xác thực Codex chưa cấu hình đúng. Vui lòng tham khảo [Hướng dẫn bắt đầu nhanh yycode × Codex](DragonCode-Codex快速开始指南.md) để cấu hình lại, hoặc chạy `!codex login` để đăng nhập lại.

**Q: `/codex:rescue` khác gì so với trực tiếp để Claude viết code?**
A: rescue là giao nhiệm vụ cho Codex thực thi độc lập, tiêu hao hạn mức OpenAI thay vì Claude Token. Phù hợp nhiệm vụ coding chuẩn hóa. Nhưng Codex không có ngữ cảnh cuộc trò chuyện giữa bạn và Claude, nên mô tả nhiệm vụ cần viết rõ.

**Q: Kết quả review mâu thuẫn với phán đoán của Claude thì sao?**
A: Đây chính là giá trị của cộng tác hai mô hình. Khi hai bên bất đồng, bạn với tư cách developer sẽ đưa ra quyết định cuối cùng.

**Q: Rốt cuộc tiết kiệm được bao nhiêu?**
A: Phụ thuộc vào bạn giao bao nhiêu công việc coding cho Codex. Nếu workflow của bạn có tỷ trọng sinh code cao (ví dụ viết nhiều test, viết CRUD), rescue hết các việc này ra ngoài có thể giảm mạnh tiêu hao của Claude.
