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

> openai/codex là coding agent của OpenAI chạy cục bộ trên máy tính và làm việc ngay trong terminal. Bạn có thể dùng tài khoản ChatGPT hoặc API key; cách cài khá đơn giản nhờ trình cài đặt độc lập, npm và Homebrew.

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

openai/codex là một coding agent của OpenAI chạy cục bộ trên máy tính thông qua terminal. Bạn có thể yêu cầu Codex đọc mã nguồn, hỗ trợ viết hoặc chỉnh sửa code và làm việc trong thư mục dự án bằng câu lệnh tự nhiên.

Repo này phù hợp với lập trình viên, người mới học code và nhân viên kỹ thuật muốn có một trợ lý ngay trong cửa sổ dòng lệnh. Repo dùng Rust làm ngôn ngữ chính, có giấy phép Apache-2.0, hiện có khoảng 135165 sao và 21437 fork.

Điểm đáng giá nhất là bạn không cần chuyển sang một ứng dụng riêng để bắt đầu. Sau khi cài CLI, chỉ cần chạy `codex`, đăng nhập bằng ChatGPT hoặc cấu hình API key theo tài liệu, rồi giao việc trong môi trường terminal quen thuộc.

```repo
- repo | openai/codex
- kind | CLI
- desc | Codex là coding agent chạy cục bộ trong terminal, hỗ trợ bạn viết, sửa và làm việc với mã nguồn bằng ngôn ngữ tự nhiên.
- stars | 135k
- lang | Rust
- license | Apache-2.0
```

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

### Làm việc như một coding agent trong terminal

Codex được thiết kế để chạy tại máy tính của bạn. Điều này giúp quy trình làm việc gần với cách bạn vẫn dùng Git, trình biên dịch và các công cụ dòng lệnh khác.

Bạn có thể mở terminal trong thư mục dự án, chạy `codex`, sau đó mô tả việc cần làm bằng ngôn ngữ tự nhiên. Với người mới, cách này dễ tiếp cận hơn việc phải nhớ nhiều lệnh xử lý mã nguồn ngay từ đầu.

### Hỗ trợ xử lý mã nguồn trong dự án

Mô tả của tác giả gọi đây là một coding agent nhẹ. Vì vậy, giá trị chính của Codex nằm ở việc hỗ trợ các công việc liên quan đến code trong môi trường phát triển, thay vì chỉ trả lời câu hỏi chung chung.

Bạn có thể dùng nó để trao đổi về một phần code, yêu cầu hỗ trợ sửa lỗi hoặc nhờ thực hiện một thay đổi cụ thể. Kết quả thực tế phụ thuộc vào thư mục bạn mở, yêu cầu bạn đưa ra và quyền truy cập mà bạn cấp cho công cụ.

### Chạy cục bộ trên máy tính

README mô tả Codex CLI là công cụ chạy cục bộ trên máy tính. Đây là lựa chọn phù hợp nếu bạn muốn làm việc từ terminal và giữ quy trình code trong môi trường phát triển của mình.

Tuy nhiên, README không nêu chi tiết chính sách lưu trữ dữ liệu, cách xử lý từng loại file hay phạm vi quyền mà Codex sử dụng trong mọi tình huống. Bạn nên đọc tài liệu liên quan trước khi đưa dữ liệu nhạy cảm vào dự án.

### Có nhiều cách cài

Bạn có thể cài Codex CLI bằng trình cài đặt độc lập trên Mac, Linux hoặc Windows. README cũng ghi rõ cách cài bằng npm và Homebrew, đồng thời cho phép tải binary phù hợp từ GitHub Release.

Nhờ vậy, người dùng có thể chọn cách thuận tiện nhất. Người dùng Windows có thể dùng PowerShell. Người dùng macOS hoặc Linux có thể dùng shell, npm hoặc Homebrew tùy môi trường đang có.

### Dùng với tài khoản ChatGPT hoặc API key

Sau khi chạy `codex`, bạn có thể chọn **Sign in with ChatGPT**. README khuyến nghị đăng nhập tài khoản ChatGPT để dùng Codex trong các gói Plus, Pro, Business, Edu hoặc Enterprise.

README cũng nói Codex có thể dùng với API key, nhưng cách này cần thiết lập bổ sung. Nếu chọn API key, bạn cần xem phần xác thực tương ứng trong tài liệu Codex trước khi cấu hình.

### Có hướng dùng trong IDE và ứng dụng desktop

Nếu muốn dùng Codex trong VS Code, Cursor hoặc Windsurf, README hướng bạn cài Codex trong IDE. Nếu muốn trải nghiệm ứng dụng desktop, bạn có thể chạy `codex app` hoặc dùng trang Codex App.

Bài này tập trung vào Codex CLI trong terminal. Codex Web là một agent trên nền tảng đám mây và là sản phẩm khác với CLI trong repo này.

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

Bạn cần một máy tính có terminal. README nêu cách cài cho Mac, Linux và Windows.

Nếu cài bằng npm, package.json trong repo yêu cầu Node.js từ phiên bản `24.22.1` trở lên. Thông tin này liên quan đến việc làm việc với monorepo và package npm; README Quickstart vẫn cung cấp trình cài đặt độc lập cho người chỉ muốn dùng CLI.

Nếu dùng Windows, bạn cần PowerShell để chạy lệnh cài đặt trong README. Nếu dùng macOS hoặc Linux, bạn cần shell để chạy lệnh cài đặt dạng `curl`.

Nếu chọn npm, bạn cần có npm hoạt động trên máy. Nếu chọn Homebrew, bạn cần có Homebrew trên macOS. README không ghi yêu cầu phiên bản cụ thể của npm, Homebrew, macOS, Linux hoặc Windows.

Bạn cần một tài khoản ChatGPT nếu muốn chọn **Sign in with ChatGPT**. README khuyến nghị các gói Plus, Pro, Business, Edu hoặc Enterprise cho việc dùng Codex như một phần trong gói ChatGPT. Bạn cũng có thể dùng API key, nhưng cần thiết lập bổ sung theo tài liệu xác thực.

README không nêu yêu cầu GPU, dung lượng ổ đĩa, loại CPU tối thiểu hay phiên bản cụ thể của Windows, macOS và Linux. Bạn không nên tự suy ra các yêu cầu này từ ngôn ngữ Rust hoặc cấu trúc repo.

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

```steps
- Chọn cách cài | Dùng trình cài đặt theo hệ điều hành, npm, Homebrew hoặc binary phát hành
- Chạy trình cài đặt | Cài Codex CLI vào máy
- Mở Codex | Chạy lệnh codex trong terminal
- Đăng nhập | Chọn tài khoản ChatGPT hoặc thiết lập API key
- Bắt đầu giao việc | Mô tả việc cần làm trong terminal
```

### Chọn cách cài phù hợp

Nếu bạn chỉ muốn sử dụng Codex CLI, cách ngắn nhất là dùng trình cài đặt độc lập. README có lệnh riêng cho macOS/Linux và Windows.

Nếu bạn đã quen npm, có thể cài package toàn cục. Trên macOS, README cũng cung cấp lệnh Homebrew. Bạn không nhất thiết phải build toàn bộ repo nguồn để dùng CLI theo Quickstart.

Nếu mục tiêu của bạn là phát triển hoặc đóng góp cho chính repo, hãy xem các mục **Contributing** và **Installing & building** trong repo. README được cung cấp ở đây chưa chép chi tiết quy trình build từ mã nguồn.

### Cài trên macOS hoặc Linux

Mở Terminal. Bạn có thể mở terminal từ thư mục dự án sau này, nhưng bước cài đặt có thể chạy ở bất kỳ thư mục nào mà tài khoản của bạn có quyền sử dụng.

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

Lệnh này tải và chạy trình cài đặt dành cho macOS hoặc Linux. Theo README, trình cài đặt tải từ `https://releases.openai.com/codex` theo mặc định và dùng GitHub Releases nếu việc tải metadata hoặc asset không khả dụng.

Bạn cũng có thể buộc trình cài đặt dùng GitHub Releases bằng biến môi trường được README cung cấp:

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

Nếu terminal báo không tìm thấy `curl`, hãy kiểm tra công cụ shell trên máy trước khi chạy lại. README không cung cấp quy trình xử lý riêng cho lỗi quyền ghi hoặc lỗi PATH, nên bạn cần xem tài liệu hệ điều hành và tài liệu Codex nếu lệnh cài xong nhưng chưa gọi được `codex`.

### Cài trên Windows

Mở PowerShell. Bạn có thể tìm PowerShell từ menu Start, sau đó dán nguyên lệnh dưới đây.

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

Lệnh dùng PowerShell để tải và chạy trình cài đặt Windows. Phần `-ExecutionPolicy ByPass` áp dụng cho lần chạy lệnh này theo đúng hướng dẫn trong README.

Nếu muốn buộc tải từ GitHub Releases, dùng lệnh sau:

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

Nếu PowerShell chặn lệnh, hãy kiểm tra bạn đã mở đúng PowerShell và đã sao chép đủ cả dòng. Không tự thay đổi tên biến môi trường, URL hoặc phần `iex`, vì đó là các thành phần có trong lệnh README.

### Cài bằng npm

Nếu npm đã sẵn sàng, chạy lệnh sau:

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

Tùy hệ điều hành, terminal có thể cần quyền phù hợp để cài package toàn cục. README chỉ cung cấp lệnh trên và không mô tả cách xử lý từng lỗi quyền của npm.

Cần phân biệt package dùng để cài CLI với tên package monorepo trong `package.json`. Tư liệu cho biết tên package của monorepo là `codex-monorepo`, còn lệnh cài CLI là `@openai/codex`. Bạn nên dùng đúng lệnh README cho mục tiêu cài công cụ.

### Cài bằng Homebrew

Trên macOS có Homebrew, chạy:

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

Nếu lệnh `brew` không tồn tại, README không hướng dẫn cài Homebrew. Bạn cần cài và kiểm tra Homebrew trước, hoặc chọn trình cài đặt độc lập hay npm.

### Cài binary thủ công

README cho biết mỗi GitHub Release có nhiều executable. Với đa số người dùng, bạn cần chọn binary theo hệ điều hành và kiến trúc máy.

macOS Apple Silicon dùng `codex-aarch64-apple-darwin.tar.gz`. Mac Intel cũ dùng `codex-x86_64-apple-darwin.tar.gz`. Linux x86_64 dùng `codex-x86_64-unknown-linux-musl.tar.gz`, còn Linux arm64 dùng `codex-aarch64-unknown-linux-musl.tar.gz`.

Sau khi giải nén, archive chứa một file có tên gắn với nền tảng, chẳng hạn `codex-x86_64-unknown-linux-musl`. README nói bạn có thể đổi tên file đó thành `codex`. Tư liệu không cung cấp câu lệnh giải nén hoặc chép file vào PATH cụ thể, nên người mới nên ưu tiên trình cài đặt tự động.

### Chạy Codex lần đầu

Sau khi cài xong, chạy:

```bash
codex
```

Trên Windows, bạn cũng chạy `codex` trong PowerShell. Khi giao diện hỏi cách đăng nhập, chọn **Sign in with ChatGPT** nếu muốn dùng tài khoản ChatGPT.

Nếu dùng API key, README chỉ nói rằng cần thiết lập bổ sung và dẫn tới tài liệu xác thực. Không nên tự đoán tên biến môi trường hoặc cách lưu key khi chưa đọc phần hướng dẫn đó.

> ```note
> API key là thông tin nhạy cảm. Không dán key vào mã nguồn, commit Git hoặc đoạn hội thoại công khai. README không nêu chi tiết lưu trữ key, nên hãy làm theo tài liệu xác thực chính thức trước khi sử dụng.
> ```

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

Cách kiểm tra cơ bản là chạy:

```bash
codex
```

Nếu Codex mở được giao diện dòng lệnh và cho bạn chọn **Sign in with ChatGPT**, phần cài CLI đã được nhận diện. Sau khi đăng nhập, bạn có thể bắt đầu giao việc trong terminal.

Nếu terminal báo không tìm thấy `codex`, trình cài đặt có thể chưa hoàn tất hoặc thư mục chứa binary chưa có trong PATH. README không nêu cách sửa PATH cho từng hệ điều hành. Bạn nên kiểm tra lại lệnh cài, mở terminal mới rồi chạy lại `codex`.

Bạn cũng có thể kiểm tra nhánh ứng dụng desktop bằng lệnh:

```bash
codex app
```

README giới thiệu đây là cách chạy trải nghiệm desktop. Nếu mục tiêu của bạn chỉ là CLI, việc lệnh `codex` mở được là kiểm tra phù hợp nhất.

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

### Chủ shop cần hiểu một trang bán hàng

Một chủ shop có thể mở terminal tại thư mục mã nguồn website rồi chạy `codex`. Sau đó, hãy yêu cầu bằng câu cụ thể như: `Giải thích cấu trúc thư mục này bằng ngôn ngữ dễ hiểu và chỉ ra file xử lý trang sản phẩm.`

Codex có thể hỗ trợ bạn đọc cấu trúc dự án và xác định nơi cần xem tiếp. Kết quả nhận được phụ thuộc vào mã nguồn và quyền truy cập trong thư mục hiện tại. Với dữ liệu kinh doanh nhạy cảm, hãy kiểm tra nội dung dự án trước khi đưa vào phiên làm việc.

### Nhân viên văn phòng cần chỉnh một file tự động hóa

Một nhân viên biết chút scripting có thể mở thư mục chứa công cụ nội bộ, chạy Codex và yêu cầu: `Đọc file này, giải thích từng phần và đề xuất cách đổi tên cột đầu ra thành tên tiếng Việt.`

Cách dùng này phù hợp khi bạn cần hiểu code trước khi sửa. Sau khi Codex đề xuất thay đổi, hãy xem lại diff, chạy thử trên bản sao dữ liệu và chỉ áp dụng vào file thật sau khi xác nhận kết quả.

### Dev mới cần hỗ trợ sửa lỗi

Một dev mới có thể mở terminal trong repo, chạy `codex`, rồi đưa yêu cầu: `Đọc lỗi hiện tại, tìm phần code liên quan, giải thích nguyên nhân có thể xảy ra và đề xuất cách sửa nhỏ nhất.`

Prompt này tách việc chẩn đoán khỏi việc thay đổi code. Bạn sẽ dễ kiểm tra lập luận hơn và tránh để công cụ sửa quá nhiều file cùng lúc. Nếu muốn Codex thực hiện thay đổi, hãy nêu rõ file, phạm vi và cách bạn muốn kiểm tra kết quả.

### Nhóm kỹ thuật muốn thử Codex trong IDE

Nếu nhóm đang dùng VS Code, Cursor hoặc Windsurf, README hướng dẫn cài Codex trong IDE. Bạn có thể dùng môi trường IDE khi cần xem code trực quan, còn terminal phù hợp với các tác vụ nhanh và quy trình tự động hóa hiện có.

README không cung cấp trong phần tư liệu này các bước cài cụ thể cho từng IDE. Vì vậy, hãy mở tài liệu cài đặt tương ứng trước khi triển khai cho cả nhóm, thay vì tự dùng lệnh CLI để suy đoán tích hợp IDE.

> Một câu lệnh rõ ràng giúp coding agent làm đúng phạm vi và giúp bạn kiểm tra kết quả dễ hơn.
>
> — Ông T

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

### Lệnh `codex` không được nhận diện

Nguyên nhân thường là trình cài đặt chưa hoàn tất hoặc terminal chưa nhận PATH mới. Hãy đóng và mở lại terminal, sau đó chạy lại `codex`. Nếu vẫn lỗi, kiểm tra lại lệnh cài đặt đúng với hệ điều hành.

### Dùng sai lệnh theo hệ điều hành

Lệnh `curl` trong README dành cho macOS/Linux, còn lệnh `powershell` dành cho Windows. Không dán lệnh PowerShell vào shell Unix hoặc lệnh shell vào PowerShell nếu bạn chưa biết cách tương thích.

### npm báo lỗi quyền hoặc phiên bản

Khi cài bằng npm, hãy kiểm tra npm đang hoạt động và Node.js đáp ứng yêu cầu trong `package.json`, tức từ `24.22.1` trở lên. README không ghi cách sửa từng lỗi quyền npm, nên không nên tự chạy các lệnh cấp quyền rộng nếu chưa hiểu tác động.

### Không biết nên chọn ChatGPT hay API key

Nếu bạn có gói ChatGPT phù hợp, README khuyến nghị chọn **Sign in with ChatGPT**. Nếu dùng API key, cần làm thêm phần thiết lập xác thực. Tư liệu được cung cấp chưa nêu chi tiết cách tạo, lưu hoặc giới hạn chi phí API key.

### Muốn build từ mã nguồn nhưng không thấy hướng dẫn

README Quickstart tập trung vào cài CLI bằng installer, package manager hoặc binary. Nó không chép quy trình build đầy đủ từ repo. Hãy xem các mục **Contributing** và **Installing & building**, cùng các file liên quan trong repo, trước khi tự tạo lệnh build.

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

Codex đáng thử nếu bạn muốn một coding agent gọn, chạy trong terminal và có nhiều lựa chọn cài đặt. Người dùng Windows có PowerShell, người dùng macOS/Linux có installer dạng shell, còn người dùng quen npm hoặc Homebrew có thể dùng package manager tương ứng.

Điểm mạnh khác là bạn có thể đăng nhập bằng ChatGPT, hoặc chọn API key nếu quy trình của bạn cần cách xác thực đó. Repo có hoạt động cập nhật trong 3 tháng gần đây, dùng giấy phép Apache-2.0 và có cộng đồng lớn với khoảng 135165 sao cùng 21437 fork.

Giới hạn nằm ở chỗ README Quickstart không giải thích sâu về quyền truy cập file, riêng tư dữ liệu, cấu hình API key, xử lý lỗi PATH hoặc quy trình build từ mã nguồn. Những phần này cần được kiểm tra thêm trong tài liệu của repo trước khi triển khai cho dữ liệu nhạy cảm hoặc dùng trong đội nhóm.

Nếu bạn cần coding agent chạy ngay trong terminal, Codex là lựa chọn hợp lý. Nếu bạn cần giao diện IDE, hãy xem hướng cài trong VS Code, Cursor hoặc Windsurf. Nếu bạn cần agent trên nền tảng đám mây, README phân biệt sản phẩm đó với Codex CLI và hướng bạn sang Codex Web.

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

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

README không nói Codex CLI hoàn toàn miễn phí. Tư liệu chỉ nói bạn có thể dùng Codex với tài khoản ChatGPT trong các gói Plus, Pro, Business, Edu hoặc Enterprise, hoặc dùng API key với thiết lập bổ sung.

### Codex có chạy trên Windows không?

Có. README cung cấp lệnh cài đặt bằng PowerShell cho Windows. Sau khi cài, bạn chạy `codex` trong PowerShell.

### Có cần GPU để chạy Codex không?

README không nêu yêu cầu GPU. Tư liệu chỉ mô tả Codex CLI chạy cục bộ trên máy tính và không cung cấp yêu cầu phần cứng chi tiết.

### Có thể dùng Codex bằng API key không?

Có. README nói Codex hỗ trợ API key, nhưng cần thiết lập bổ sung. Phần tư liệu được cung cấp chưa nêu tên biến môi trường hay các bước cấu hình cụ thể.

### Dữ liệu trong dự án có an toàn không?

README được cung cấp không mô tả chi tiết cách Codex lưu trữ hoặc xử lý dữ liệu. Bạn nên kiểm tra tài liệu liên quan và tránh đưa key, thông tin khách hàng hoặc dữ liệu bí mật vào phiên làm việc khi chưa xác minh.

### Codex có dùng được trong VS Code hoặc Cursor không?

Có. README nói nếu muốn dùng Codex trong VS Code, Cursor hoặc Windsurf thì hãy cài Codex trong IDE. Tư liệu này chưa ghi các bước cài cụ thể cho từng IDE.

### Codex CLI khác Codex Web và ứng dụng desktop thế nào?

README mô tả Codex CLI là coding agent chạy cục bộ trong terminal. `codex app` dành cho trải nghiệm desktop, còn Codex Web là agent trên nền tảng đám mây và là sản phẩm khác.
