# openai/codex: trợ lý lập trình chạy ngay trong terminal — hướng dẫn cài đặt và dùng

> Codex CLI là một agent lập trình của OpenAI, chạy cục bộ trên máy tính và dùng ngay trong terminal. Bạn cài bằng một dòng lệnh (hoặc npm, Homebrew), gõ codex rồi đăng nhập bằng tài khoản ChatGPT. Cài đặt khá dễ, chỉ vài phút, trên Mac, Linux và Windows.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-14 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/openai-codex-tro-ly-lap-trinh-trong-terminal

Codex CLI là một trợ lý lập trình (coding agent) do OpenAI làm ra, chạy ngay trên máy tính của bạn và dùng qua cửa sổ terminal. Bạn mở thư mục dự án, gõ `codex`, rồi trò chuyện bằng ngôn ngữ thường để nhờ nó đọc, giải thích và sửa code.

Repo này dành cho ai? Lập trình viên mới muốn có "người kèm" ngay trong dự án. Dev có kinh nghiệm muốn giao bớt việc lặt vặt. Cả người làm kinh doanh, văn phòng biết sơ cách mở terminal và muốn nhờ AI dựng công cụ nhỏ cho công việc của mình. Hiện repo có khoảng 135 nghìn sao và khoảng 21 nghìn fork trên GitHub, giấy phép Apache-2.0, viết chủ yếu bằng Rust và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất: cài chỉ bằng một dòng lệnh, và bạn có thể dùng luôn gói ChatGPT đang có (Plus, Pro, Business, Edu hoặc Enterprise) mà không cần tự lấy API key. Bài này mình đi từ cài đặt đến vài tình huống dùng thật.

```repo
- repo | openai/codex
- kind | CLI
- desc | Codex CLI là agent lập trình của OpenAI chạy cục bộ trên máy bạn, dùng ngay trong terminal, đăng nhập bằng tài khoản ChatGPT hoặc API key.
- stars | 135k
- lang | Rust
- license | Apache-2.0
```

## Codex CLI làm được gì

Theo tư liệu của repo, Codex CLI là "coding agent chạy cục bộ trên máy tính". Mình tóm lại những gì README nói rõ, và giải thích lợi ích cho bạn.

- **Chạy ngay trong terminal.** Bạn không cần mở trang web, không cần copy code qua lại. Đứng ở thư mục dự án, gõ `codex` là bắt đầu làm việc được.
- **Chạy cục bộ trên máy bạn.** Công cụ hoạt động trên máy của bạn, nên làm việc trực tiếp với thư mục dự án đang mở. Tư liệu chưa mô tả chi tiết dữ liệu nào được gửi đi đâu, nên nếu bạn lo về dữ liệu nhạy cảm, hãy đọc tài liệu chính thức của OpenAI trước khi dùng.
- **Đăng nhập bằng tài khoản ChatGPT.** Chọn **Sign in with ChatGPT** để dùng Codex như một phần của gói Plus, Pro, Business, Edu hoặc Enterprise. Người đã trả tiền cho ChatGPT có thể dùng luôn.
- **Có thể dùng API key.** Cách này cần thiết lập thêm, README chỉ sang trang tài liệu chính thức của OpenAI để xem.
- **Nhiều cách dùng khác nhau cùng một họ.** Muốn dùng Codex trong trình soạn code (VS Code, Cursor, Windsurf) thì cài bản dành cho IDE. Muốn giao diện ứng dụng máy tính thì chạy `codex app`. Còn **Codex Web** là bản agent chạy trên đám mây của OpenAI, nằm ở một địa chỉ riêng chứ không phải repo này.
- **Nhiều cách cài.** Có script cài một dòng, npm, Homebrew, hoặc tải thẳng file chạy từ trang Release trên GitHub. Bạn chọn cách hợp với máy mình.

## Cần chuẩn bị gì

Chỉ liệt kê những gì tư liệu nói:

- **Hệ điều hành:** Mac, Linux hoặc Windows. README có lệnh cài riêng cho từng loại. File tải sẵn trên Release có bản cho macOS (Apple Silicon/arm64 và x86_64) và Linux (x86_64, arm64).
- **Tài khoản:** một tài khoản ChatGPT với gói Plus, Pro, Business, Edu hoặc Enterprise (cách README khuyên dùng). Hoặc API key, nhưng cần thiết lập thêm.
- **Terminal:** bạn cần biết mở terminal (trên Windows là PowerShell). Phần dưới mình chỉ cụ thể.
- **Node.js:** chỉ cần nếu bạn chọn cài bằng npm. README không ghi phiên bản Node tối thiểu cho lệnh này. Riêng file `package.json` của repo yêu cầu Node từ 24.22.1 trở lên, nhưng đó là yêu cầu khi bạn tải mã nguồn về để phát triển, không phải khi chỉ dùng Codex. Nếu không chắc, hãy dùng script cài một dòng hoặc Homebrew.
- **Phần cứng:** tư liệu không nhắc đến yêu cầu GPU hay RAM.

## Cài đặt từng bước

```steps
- Mở terminal | Mac/Linux mở Terminal, Windows mở PowerShell
- Chạy lệnh cài | Chọn script một dòng, npm hoặc Homebrew
- Vào thư mục dự án | Dùng cd để đứng đúng thư mục muốn làm việc
- Gõ codex | Khởi động công cụ
- Đăng nhập | Chọn Sign in with ChatGPT
```

### Mở terminal đúng chỗ

Đây là chỗ người mới hay vấp nhất. Trên Mac, mở ứng dụng Terminal. Trên Linux, mở cửa sổ terminal. Trên Windows, mở PowerShell (gõ "PowerShell" vào ô tìm kiếm của Start). Các lệnh dưới đây gõ vào cửa sổ đó, không gõ vào trình duyệt.

### Chạy lệnh cài

README đưa ra vài cách. Chọn **một** cách thôi.

**Cách 1: script cài một dòng.** Trên Mac hoặc Linux:

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

Lệnh này tải script cài đặt từ OpenAI rồi chạy luôn. Trên Windows (PowerShell):

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

Bộ cài mặc định tải file từ `https://releases.openai.com/codex`, và tự chuyển sang GitHub Releases nếu bên đó lỗi. Muốn ép tải từ GitHub Releases, đặt biến `CODEX_INSTALLER_USE_RELEASES_OPENAI_COM` thành `false` (README nói `0` và `no` cũng được chấp nhận):

```shell
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
```

```powershell
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex
```

```note
Các lệnh kiểu "tải script về rồi chạy ngay" chạy thẳng mã từ internet trên máy bạn. Chỉ dùng khi địa chỉ đúng là của OpenAI như trong README. Muốn kiểm soát hơn, bạn có thể chọn npm, Homebrew hoặc tải file từ trang Release.
```

**Cách 2: npm.** Dành cho bạn đã có Node.js và npm:

```shell
# Install using npm
npm install -g @openai/codex
```

Cờ `-g` nghĩa là cài toàn cục, để gõ `codex` ở thư mục nào cũng chạy được.

**Cách 3: Homebrew** (dành cho ai đã dùng Homebrew):

```shell
# Install using Homebrew
brew install --cask codex
```

**Cách 4: tải file chạy sẵn.** Vào trang Release mới nhất của repo trên GitHub, chọn file đúng với máy:

- macOS Apple Silicon (arm64): `codex-aarch64-apple-darwin.tar.gz`
- macOS x86_64 (Mac đời cũ): `codex-x86_64-apple-darwin.tar.gz`
- Linux x86_64: `codex-x86_64-unknown-linux-musl.tar.gz`
- Linux arm64: `codex-aarch64-unknown-linux-musl.tar.gz`

Mỗi file nén chứa một file chạy có tên kèm tên nền tảng (ví dụ `codex-x86_64-unknown-linux-musl`). README khuyên đổi tên thành `codex` sau khi giải nén. README không nói chi tiết cách đưa file đó vào PATH, nên nếu chưa quen, bạn hãy dùng cách 1, 2 hoặc 3 cho đỡ rắc rối.

### Vào thư mục dự án

Codex làm việc theo thư mục bạn đang đứng. Hãy `cd` vào thư mục dự án trước khi chạy. Ví dụ:

```bash
cd ten-thu-muc-du-an
```

Thay `ten-thu-muc-du-an` bằng tên thư mục thật của bạn. Nếu chỉ thử cho vui, hãy tạo một thư mục trống hoặc một bản sao thử nghiệm, đừng thử đầu tiên trên dự án quan trọng.

### Chạy và đăng nhập

Gõ lệnh:

```shell
codex
```

Lần đầu chạy, chọn **Sign in with ChatGPT** và đăng nhập theo hướng dẫn trên màn hình. README khuyên cách này nếu bạn có gói Plus, Pro, Business, Edu hoặc Enterprise. Muốn dùng API key thì xem hướng dẫn "sign in with an API key" trong tài liệu của OpenAI (mục auth trên trang developers.openai.com/codex).

## Kiểm tra đã chạy được chưa

README không mô tả chi tiết màn hình thành công, nhưng dấu hiệu rõ nhất là:

1. Gõ `codex` trong terminal và công cụ khởi động, không báo kiểu "command not found" (không tìm thấy lệnh).
2. Bạn được dẫn qua bước đăng nhập, chọn **Sign in with ChatGPT**.
3. Sau khi đăng nhập, bạn gõ được yêu cầu bằng ngôn ngữ thường và nhận được phản hồi.

Nếu terminal báo không tìm thấy lệnh, xem phần lỗi thường gặp bên dưới.

## Dùng vào việc thật

Tư liệu repo cho biết Codex là agent lập trình chạy cục bộ. Các tình huống dưới đây là ví dụ cách dùng hợp lý với loại công cụ này. Câu lệnh mẫu là gợi ý của mình, bạn gõ bằng tiếng Việt hay tiếng Anh đều thử được, kết quả thực tế tuỳ dự án và tuỳ gói của bạn.

> Đừng bắt đầu bằng việc nhờ nó viết cả hệ thống. Bắt đầu bằng một việc nhỏ, đọc kết quả, rồi mới giao việc lớn hơn.
>
> — Ông T

### Dev mới vào dự án: nhờ giải thích code

Bạn vừa được giao một dự án lạ, thư mục đầy file. Mở terminal, `cd` vào thư mục, gõ `codex`, rồi hỏi:

```text
Hãy giải thích cấu trúc thư mục này và cho mình biết file nào là điểm bắt đầu của chương trình.
```

Kết quả bạn mong đợi là một bản tóm tắt dễ hiểu để bạn định hướng nhanh, thay vì tự mở từng file. Hãy kiểm tra lại bằng cách mở vài file được nhắc đến, đừng tin hoàn toàn lời tóm tắt.

### Chủ shop nhỏ: dựng công cụ xử lý file đơn giản

Bạn có một file danh sách khách hàng hoặc đơn hàng, cần một đoạn chương trình nhỏ để gom và sắp xếp lại. Bạn tạo một thư mục riêng, đặt file mẫu vào, chạy `codex` và mô tả:

```text
Trong thư mục này có file don-hang. Hãy viết một chương trình nhỏ đọc file đó và cho mình tổng số đơn mỗi ngày. Giải thích cách chạy bằng ngôn ngữ đơn giản.
```

Kết quả là một đoạn chương trình kèm hướng dẫn chạy. Lưu ý: hãy làm trên bản sao của file dữ liệu, để lỡ có sai sót thì dữ liệu gốc vẫn an toàn.

### Lập trình viên: sửa lỗi và dọn code

Dự án báo lỗi mà bạn chưa rõ nguyên nhân. Bạn dán thông báo lỗi vào Codex và nhờ:

```text
Chương trình báo lỗi như sau: (dán nội dung lỗi). Hãy tìm nguyên nhân trong code của dự án và đề xuất cách sửa.
```

Bạn nhận được phân tích và đề xuất chỉnh sửa. Hãy đọc kỹ từng thay đổi trước khi chấp nhận, và dùng Git để có thể quay lại nếu cần.

### Người làm văn phòng: nhờ viết tài liệu cho dự án

Nhóm bạn có một công cụ nội bộ nhưng không ai viết hướng dẫn. Bạn nhờ:

```text
Đọc dự án này và viết một file hướng dẫn sử dụng ngắn gọn cho người không rành kỹ thuật.
```

Bạn nhận được bản nháp tài liệu bám theo code thật. Hãy đọc lại và chỉnh cho đúng cách nói của nhóm.

## Lỗi hay gặp và cách xử lý

### Gõ codex báo không tìm thấy lệnh

Thường do terminal chưa nhận lệnh vừa cài. Hãy đóng hẳn cửa sổ terminal, mở lại rồi gõ `codex` lần nữa. Nếu vẫn lỗi, kiểm tra xem lệnh cài trước đó có báo lỗi không. Với file tải từ Release, nhớ đã đổi tên thành `codex` như README khuyên. Không được nữa thì cài lại bằng một cách khác trong README.

### Lệnh npm báo lỗi hoặc không có npm

Lệnh `npm install -g @openai/codex` cần Node.js và npm trên máy. Nếu máy báo không có npm, hãy dùng script cài một dòng hoặc Homebrew. Nếu gặp lỗi về quyền khi cài toàn cục, đừng cố vượt quyền bừa. Đổi sang cách cài khác an toàn hơn.

### Script cài trên Windows bị chặn

Lệnh PowerShell của README có kèm `-ExecutionPolicy ByPass` để bỏ qua chặn chạy script cho riêng lệnh đó. Nếu vẫn bị chặn, hãy chắc là bạn đang dùng PowerShell (không phải Command Prompt) và gõ đúng nguyên lệnh. Nếu máy công ty có chính sách riêng, hãy hỏi bộ phận IT.

### Không tải được file cài

Bộ cài mặc định tải từ máy chủ của OpenAI rồi tự chuyển sang GitHub Releases nếu lỗi. Nếu mạng của bạn chặn một bên, thử đặt `CODEX_INSTALLER_USE_RELEASES_OPENAI_COM` thành `false` như đã nói ở trên để ép tải từ GitHub. Hoặc tải thẳng file từ trang Release.

### Đăng nhập không được hoặc không có quyền dùng

Cách README khuyên là đăng nhập bằng tài khoản ChatGPT thuộc gói Plus, Pro, Business, Edu hoặc Enterprise. Nếu tài khoản miễn phí của bạn không dùng được, tư liệu chưa nói rõ, hãy xem mục "Codex in ChatGPT" trên trang trợ giúp của OpenAI. Phương án khác là dùng API key theo hướng dẫn auth của OpenAI.

## Có nên dùng không

**Điểm mạnh:**

- Cài nhanh, có đủ cách cho Mac, Linux, Windows.
- Dùng được tài khoản ChatGPT sẵn có, không bắt buộc phải tự lấy API key.
- Mã nguồn mở, giấy phép Apache-2.0, dự án đang được cập nhật.
- Có họ sản phẩm đầy đủ: terminal, IDE, ứng dụng máy tính, bản web.

**Giới hạn:**

- Cần làm quen terminal. Người chưa từng mở terminal sẽ mất vài phút làm quen.
- Cách dùng tốt nhất vẫn cần gói ChatGPT trả phí hoặc API key. Tư liệu không nói gì về bản miễn phí.
- Là agent AI nên vẫn có thể sai. Luôn đọc lại thay đổi và sao lưu trước khi giao việc lớn.
- Tư liệu của repo ngắn. Các tính năng sâu hơn (cấu hình, quyền hạn, v.v.) bạn cần đọc tài liệu chính thức của OpenAI.

Nếu bạn thích làm việc trong trình soạn code, hãy cài bản IDE thay vì CLI. Nếu bạn muốn một agent chạy trên đám mây, hãy xem Codex Web. Còn nếu bạn muốn một trợ lý nhẹ, chạy ngay trong terminal và dùng được liền với tài khoản ChatGPT, Codex CLI là lựa chọn đáng thử.

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

### Codex CLI có miễn phí không?

Bản thân repo là mã nguồn mở, giấy phép Apache-2.0. Tuy nhiên README khuyên đăng nhập bằng tài khoản ChatGPT thuộc gói Plus, Pro, Business, Edu hoặc Enterprise để dùng. Tư liệu không nói gì về việc dùng hoàn toàn miễn phí, bạn nên xem trang trợ giúp của OpenAI.

### Codex CLI chạy được trên Windows không?

Được. README có lệnh cài riêng cho Windows chạy trong PowerShell. Với Mac và Linux có lệnh cài khác, ngoài ra còn có npm, Homebrew và file tải sẵn trên GitHub Releases.

### Có cần GPU hay máy mạnh không?

Tư liệu không nhắc đến yêu cầu GPU hay cấu hình phần cứng. README mô tả đây là agent chạy cục bộ trên máy bạn, còn chi tiết về tài nguyên thì chưa có thông tin.

### Cần API key không?

Không bắt buộc. Cách README khuyên là chạy codex rồi chọn Sign in with ChatGPT. Bạn cũng có thể dùng API key, nhưng cần thiết lập thêm theo hướng dẫn của OpenAI.

### Codex CLI khác gì Codex Web và bản trong IDE?

Codex CLI chạy cục bộ trong terminal. Muốn dùng trong VS Code, Cursor hoặc Windsurf thì cài bản dành cho IDE, muốn ứng dụng máy tính thì chạy codex app. Codex Web là agent chạy trên đám mây của OpenAI, nằm ở trang riêng chứ không phải repo này.

### Dữ liệu và code của tôi có an toàn không?

Tư liệu trong README không mô tả chi tiết về xử lý dữ liệu. Nếu dự án có thông tin nhạy cảm, hãy đọc tài liệu và chính sách chính thức của OpenAI trước. Dù thế nào, bạn nên sao lưu và dùng Git khi để AI sửa code.

### Cần cài Node.js không?

Chỉ khi bạn cài bằng npm. README không ghi phiên bản Node tối thiểu cho lệnh đó. File package.json của repo yêu cầu Node từ 24.22.1 trở lên, nhưng đó là cho việc phát triển từ mã nguồn. Script cài một dòng và Homebrew không đòi hỏi bạn tự cài Node theo README.
