# Cài Codex CLI và chạy việc đầu tiên trong 15 phút

URL: https://opcaios.org/blog/cai-codex-cli
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

Cài Codex CLI là tải bản dòng lệnh của Codex, tác tử lập trình của OpenAI, về máy, đăng nhập, rồi mở trong một thư mục dự án để giao việc bằng lời. Bài dành cho người không chuyên code và chỉ dùng lệnh thấy trong README của github.com/openai/codex, tài liệu Codex tại learn.chatgpt.com/docs và `codex --help` bản 0.162.1, đọc ngày 03/11/2026. "15 phút" là ước lượng cho máy có mạng ổn và tài khoản ChatGPT sẵn, không phải bảo đảm: proxy công ty, Windows hay lỗi đăng nhập có thể làm lâu hơn. Bài không hứa Codex sẽ sửa đúng; bài đi từ yêu cầu hệ thống tới việc đầu tiên, đọc diff, lệnh slash và lỗi thường gặp.

![Sơ đồ cài Codex CLI theo sáu bước: kiểm tra yêu cầu hệ thống, cài bằng tập lệnh, npm hoặc Homebrew, chạy codex login, mở terminal trong thư mục dự án có git, giao việc chỉ đọc, xem /diff trước khi chấp nhận thay đổi](https://opcaios.org/images/blog/cai-codex-cli/so-do.webp)
*Sáu bước từ máy trống tới việc đầu tiên an toàn, mỗi bước có điểm kiểm tra. Sơ đồ: OPCAIOS.*

## Máy cần những gì để cài Codex CLI?

Máy cần một hệ điều hành được hỗ trợ, đủ bộ nhớ, và nên có git. Theo tệp docs/install.md trong kho github.com/openai/codex (đọc ngày 03/11/2026):

| Hạng mục | Yêu cầu theo tài liệu |
|---|---|
| Hệ điều hành | macOS 12 trở lên, Ubuntu 20.04+ hoặc Debian 10+, Windows 11 qua WSL2 |
| RAM | Tối thiểu 4 GB, khuyến nghị 8 GB |
| Git | Không bắt buộc, khuyến nghị bản 2.23 trở lên |
| Tài khoản | Tài khoản ChatGPT hoặc khoá API của OpenAI |

Điểm vênh cần biết: install.md ghi Windows 11 qua WSL2, nhưng README và trang Codex CLI hiện có trình cài chạy thẳng trong PowerShell. Người dùng Windows nên theo trang Codex CLI mới nhất. Trang giá cùng ngày ghi CLI có trong gói Plus trở lên hoặc khi dùng khoá API. Giá các gói ở bài [Codex là gì](/blog/codex-la-gi).

## Cài Codex CLI theo những cách nào?

Codex CLI có bốn cách cài chính thức theo README và trang Codex CLI (đọc ngày 03/11/2026), chọn một là đủ:

1. **Tập lệnh cài trên macOS và Linux,** chạy trong Terminal:

```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```

2. **Trình cài trên Windows,** chạy trong cửa sổ PowerShell mới:

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```

3. **npm,** nếu máy đã có Node.js:

```bash
npm install -g @openai/codex
```

4. **Homebrew** trên macOS:

```bash
brew install --cask codex
```

Lệnh dạng `curl ... | sh` chạy ngay tập lệnh tải về, nên chỉ dán đúng lệnh trong tài liệu chính thức. Cài xong, mở cửa sổ terminal mới và gõ `codex --version`; máy chúng tôi trả về `codex-cli 0.162.1`. Cập nhật bằng đúng cách đã cài: chạy lại tập lệnh, chạy lại lệnh npm, hoặc `brew upgrade --cask codex`; `codex --help` còn có lệnh `codex update`.

## Đăng nhập Codex CLI thế nào?

Đăng nhập Codex CLI có hai đường: tài khoản ChatGPT hoặc khoá API. Theo trang Authentication trong tài liệu Codex (đọc ngày 03/11/2026), lần đầu chạy `codex` bạn chọn "Sign in with ChatGPT", hoặc chạy thẳng `codex login`; trình duyệt mở ra, bạn đăng nhập, trình duyệt trả thông tin đăng nhập về CLI. Với khoá API, tài liệu hướng dẫn truyền khoá qua đầu vào chuẩn thay vì gõ vào dòng lệnh:

```bash
printenv OPENAI_API_KEY | codex login --with-api-key
```

`codex login status` cho biết đang đăng nhập bằng cách nào; `codex logout` xoá thông tin đăng nhập trên máy dùng chung. Dùng khoá API thì chi phí tính theo giá API trên tài khoản OpenAI Platform, không dùng hạn mức gói ChatGPT. Thông tin đăng nhập mặc định lưu trong `~/.codex/auth.json` dạng văn bản thường hoặc trong kho thông tin đăng nhập của hệ điều hành. Không gửi tệp này cho ai, không đưa vào git, không dán khoá vào lời nhắc. Xem thêm [bảo mật khi dùng AI viết code](/blog/bao-mat-khi-dung-ai-viet-code).

## Mở Codex CLI trong thư mục dự án thế nào?

Mở Codex CLI đúng thư mục quyết định Codex được đọc và sửa những gì. Codex coi thư mục bạn đang đứng là thư mục làm việc, nên hãy vào thư mục dự án trước khi gõ `codex`, hoặc dùng cờ `-C` (tên dài `--cd`). Theo trang "Agent approvals & security" (đọc ngày 03/11/2026), khi khởi động Codex kiểm tra thư mục có git không: có git thì gợi ý chế độ Auto (sửa tệp và chạy lệnh trong thư mục làm việc, hỏi khi cần ra ngoài hoặc dùng mạng), không có git thì gợi ý chỉ đọc; tuỳ cài đặt, Codex có thể chỉ đọc cho tới khi bạn xác nhận tin cậy thư mục. Với người mới, chuẩn bị theo bốn bước:

1. Sao chép dự án thật ra thư mục riêng.
2. Bật git và tạo một commit đầu tiên làm điểm quay lại; tài liệu Codex khuyên tạo điểm lưu git trước và sau mỗi việc.
3. Không để tệp chứa mật khẩu, khoá hay dữ liệu khách trong thư mục thử.
4. Mở terminal trong thư mục, gõ `codex`.

Cách viết hướng dẫn dự án cho Codex ở bài [AGENTS.md là gì](/blog/agents-md-la-gi).

## Giao việc đầu tiên an toàn cho Codex thế nào?

Việc đầu tiên an toàn là việc chỉ đọc: Codex xem dự án và giải thích, không sửa gì. Trang Codex CLI gợi ý mở đầu bằng lời nhắc kiểu "Tell me about this project". Để chắc Codex không sửa tệp, khởi động ở sandbox chỉ đọc bằng hai cờ có trong tài liệu và `codex --help`:

```bash
codex --sandbox read-only --ask-for-approval on-request
```

Ví dụ giả định cho một website nhỏ, không phải dự án thật:

1. "Giải thích dự án này làm gì, gồm những thư mục nào, bằng lời cho người không biết code."
2. "Đề xuất ba thay đổi nhỏ, ít rủi ro, nhưng chưa sửa gì."

Hiểu dự án rồi mới giao một việc sửa nhỏ, như đổi một dòng chữ trên trang chủ. Gõ `/plan` kèm yêu cầu để Codex đề xuất kế hoạch trước; gõ `@` để tìm và chèn đường dẫn tệp vào lời nhắc. Khi Codex cần vượt quyền hiện tại, Codex dừng lại xin phép: đọc lệnh định chạy trước khi đồng ý. Chi tiết ở bài [chế độ phê duyệt và sandbox của Codex](/blog/che-do-phe-duyet-va-sandbox-cua-codex).

## Đọc diff trước khi chấp nhận thay đổi thế nào?

Diff là bản so sánh cho biết dòng nào bị xoá, dòng nào được thêm, ở tệp nào. Theo trang lệnh của Codex CLI (đọc ngày 03/11/2026), `/diff` hiển thị git diff, kể cả tệp git chưa theo dõi, và được khuyên dùng để xem thay đổi của Codex trước khi commit hoặc chạy kiểm thử. Quy trình gợi ý:

1. Gõ `/diff` sau khi Codex báo xong.
2. Đếm số tệp bị đổi; nhiều hơn dự tính thì dừng lại hỏi vì sao.
3. Hỏi Codex giải thích thay đổi từng tệp bằng lời thường.
4. Gõ `/review` để Codex rà thay đổi như người duyệt thứ hai; tài liệu ghi review không sửa cây làm việc.
5. Chạy thử hoặc mở trang theo cách dự án vẫn dùng.
6. Đạt thì tự commit; không đạt thì yêu cầu sửa tiếp hoặc quay về commit trước.

Mã chạy được vẫn có thể sai ý; xem thêm [dùng Codex review code](/blog/dung-codex-review-code).

## Những lệnh slash nào hữu ích cho người mới?

Lệnh slash là lệnh bắt đầu bằng dấu "/" trong phiên Codex để điều khiển phiên, không phải lời nhắc cho mô hình. Bảng chỉ gồm lệnh có trong danh sách lệnh dựng sẵn của tài liệu Codex CLI (đọc ngày 03/11/2026):

| Lệnh | Dùng để |
|---|---|
| `/status` | Xem mô hình, chính sách phê duyệt, thư mục được ghi, token đã dùng |
| `/permissions` | Đổi mức quyền giữa phiên, ví dụ giữa Auto và Read Only |
| `/plan` | Lập kế hoạch trước khi làm |
| `/diff` | Xem thay đổi trước khi commit |
| `/review` | Nhờ Codex rà thay đổi trong cây làm việc |
| `/init` | Tạo khung tệp AGENTS.md trong thư mục hiện tại |
| `/model` | Chọn mô hình và mức suy nghĩ nếu có |
| `/quit` hoặc `/exit` | Thoát Codex |

Tài liệu còn ghi: gõ `!` đầu dòng để chạy một lệnh shell theo quyền hiện tại, Ctrl+C để thoát; ngoài phiên, `codex resume --last` mở lại phiên gần nhất. Cấu hình lâu dài ở bài [cấu hình Codex config.toml](/blog/cau-hinh-codex-config-toml).

## Cài Codex CLI hay gặp lỗi gì?

Lỗi khi cài Codex CLI thường nằm ở đường dẫn lệnh, đăng nhập và mạng. Cách xử lý theo tài liệu (đọc ngày 03/11/2026):

1. **Gõ `codex` báo không tìm thấy lệnh:** mở terminal mới; vẫn lỗi thì cài lại bằng một cách khác.
2. **Đăng nhập không trả về,** hay gặp trên máy chủ từ xa: dùng mã thiết bị (beta) với `codex login --device-auth`, sau khi bật tính năng này trong cài đặt bảo mật ChatGPT.
3. **Mạng công ty có proxy TLS:** đặt biến `CODEX_CA_CERTIFICATE` trỏ tới tệp chứng chỉ của công ty trước khi đăng nhập.
4. **Codex chỉ đọc, không sửa:** thư mục chưa có git hoặc chưa được tin cậy; xem `/status`, đổi bằng `/permissions`.
5. **Hết hạn mức giữa chừng:** xem `/status`; hạn mức thay đổi theo mô hình và độ dài việc.
6. **Không rõ lỗi gì:** chạy `codex doctor` để chẩn đoán cài đặt, cấu hình và đăng nhập.

Đừng "sửa" lỗi bằng `--dangerously-bypass-approvals-and-sandbox`, cờ tắt cả sandbox lẫn phê duyệt.

## Kinh nghiệm của OPCAIOS

Máy làm việc chính của OPCAIOS 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. Những gì có thật:

1. **AGENTS.md cấp người dùng cho Codex,** nên phiên mới tự trả lời tiếng Việt, đọc tài liệu theo thứ tự và ghi nhật ký cuối phiên.
2. **Nhiều thư mục dự án được đánh dấu tin cậy** trong config.toml.
3. **Mỗi phiên chỉ commit đúng tệp của mình,** vì nhiều tác tử cùng làm một hệ thống; từng gặp hơn 1.500 tệp "khác" chỉ vì kiểu xuống dòng khi một tác tử deploy từ máy Windows.

Chúng tôi chưa đo thời gian cài trên máy mới, nên 15 phút là ước lượng; chưa thử cài trên Windows; chưa có hook chặn lệnh nguy hiểm.

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

### Cài Codex CLI có mất phí không?

Cài Codex CLI không mất phí, vì Codex CLI là mã nguồn mở theo giấy phép Apache-2.0. Chi phí nằm ở việc dùng mô hình, qua gói ChatGPT hoặc khoá API tính theo lượng dùng. Theo trang giá đọc ngày 03/11/2026, CLI có trong gói Plus 20 USD/tháng trở lên hoặc khi dùng khoá API; bảng tính năng không liệt kê CLI cho Free và Go. Giá chưa gồm thuế, có thể đổi.

### Nên cài bằng tập lệnh, npm hay Homebrew?

Cả ba đều có trong tài liệu chính thức. Tập lệnh cài được nêu đầu tiên cho macOS, Linux và Windows. npm hợp khi máy đã có Node.js và bạn quen npm. Homebrew hợp với người dùng Mac đã cài Homebrew. Chỉ dùng một cách, vì cài chồng nhiều cách dễ khiến máy chạy nhầm bản cũ.

### Codex có tự sửa tệp mà không hỏi không?

Có thể, tuỳ chế độ. Ở chế độ Auto, Codex sửa tệp và chạy lệnh trong thư mục làm việc mà không hỏi, chỉ dừng khi cần ra ngoài thư mục hoặc dùng mạng. Muốn Codex không sửa gì, khởi động với `--sandbox read-only`, hoặc đổi giữa phiên bằng `/permissions`. Luôn làm trên thư mục có git để quay lại được.

### Có cần biết lập trình để dùng Codex CLI không?

Không cần biết viết mã để bắt đầu, nhưng cần biết mở terminal, vào đúng thư mục và tạo commit git. Phần còn lại có thể hỏi chính Codex bằng tiếng Việt, từ giải thích dự án tới giải thích diff. Quy trình cho người mới ở bài [tác tử lập trình cho người không biết code](/blog/tac-tu-lap-trinh-cho-nguoi-khong-biet-code-quy-trinh-an-toan).

### Cài xong nên học gì tiếp?

Học theo thứ tự: tạo AGENTS.md bằng `/init` rồi sửa tay, hiểu chế độ phê duyệt và sandbox, đặt mô hình mặc định trong config.toml, rồi mới tới MCP, skill và tự động hoá. Nếu muốn có người hướng dẫn theo việc thật của bạn, xem [khoá đào tạo ứng dụng AI](/services/dao-tao-ung-dung-ai) của OPCAIOS.

*Nguồn: github.com/openai/codex (README, docs/install.md), learn.chatgpt.com/docs (Codex CLI, Authentication, Developer commands, Agent approvals & security, Pricing; developers.openai.com/codex chuyển hướng sang đây), `codex --help`, `codex login --help` bản 0.162.1, đọc ngày 03/11/2026; "15 phút" là ước lượng, chưa đo; cài trên Windows chưa kiểm chứng, tài liệu chính thức đang ghi hai cách khác nhau; giá chưa gồm thuế, có thể đổi. Kinh nghiệm là của OPCAIOS.*