OpenAI Codex: Là gì, cách cài đặt và điều kiện truy cập theo khu vực năm 2026

Từ “Codex” trong kết quả tìm kiếm có nghĩa là ba thứ khác nhau, và những người lần đầu nhập từ này thường không hiểu họ đã tìm thấy gì. Từng có một mô hình Codex — mô hình này đã ngừng hoạt động vào năm 2023; hiện nay, cái tên này thuộc về một chương trình tác nhân, và còn khoảng chục sản phẩm khác cùng tên xuất hiện lẫn lộn.

Bài viết này chỉ đề cập đến một Codex: tác nhân lập trình của OpenAI. Nó làm gì, chạy ở đâu, giá bao nhiêu, cách cài đặt trong năm phút và OpenAI nói gì về các quốc gia. Tất cả đều dựa trên tài liệu chính thức, với liên kết cho từng số liệu ở cuối bài.

Tài liệu bổ sung về thiết lập công cụ có trong tài liệu Ailoot.

OpenAI Codex là gì?#

Hãy so sánh với một cuộc trò chuyện thông thường. Trong cuộc trò chuyện, bạn sao chép một đoạn mã, dán vào, nhận câu trả lời rồi sao chép trở lại. Tác nhân hoạt động khác: bạn mô tả nhiệm vụ bằng ngôn ngữ thông thường, rồi nó mở các tệp liên quan trong thư mục dự án, thực hiện thay đổi, chạy kiểm tra và hiển thị kết quả.

OpenAI mô tả công cụ này trong một câu ở kho mã của mình:

Chạy cục bộ nghĩa là chương trình được tải xuống máy của bạn, nơi nó có thể xem các tệp và chạy lệnh trong thư mục của bạn. Chỉ yêu cầu gửi đến mô hình mới được chuyển lên đám mây.

Mã nguồn mở được lưu trên GitHub theo giấy phép Apache-2.0. Tính đến ngày 1 tháng 8 năm 2026, kho mã có 103,000 lượt gắn sao và phiên bản mới nhất, 0.146.0, được phát hành vào ngày 29 tháng 7. Các bản cập nhật ra mắt gần như mỗi ngày, vì vậy nhiều khả năng phiên bản của bạn đã khác.

Codex năm 2026 khác gì Codex cũ đã ngừng hoạt động?#

Mọi người thường nhầm lẫn hai sản phẩm vì cả hai đều là sản phẩm chính thức của OpenAI. Ngày tháng giúp phân biệt chúng.

Sản phẩm đầu tiên là một tập hợp mô hình: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Chúng chỉ làm một việc — tự hoàn thiện mã cho bạn — và là nền tảng của GitHub Copilot đầu tiên. Trong danh sách mô hình đã ngừng hoạt động của OpenAI, cả bốn được ghi trên cùng một dòng: công bố ngày 20 tháng 3 năm 2023, ngừng hoạt động ngày 23 tháng 3, với gpt-4o là sản phẩm thay thế được đề xuất.

Sản phẩm thứ hai là một chương trình được cài trên máy tính. Gói @openai/codex xuất hiện trên npm registry vào ngày 16 tháng 4 năm 2025. Mô hình bên trong được thay bằng mô hình mới hơn theo thời gian, còn bản thân chương trình vẫn giữ nguyên.

Mọi hướng dẫn về Codex trước tháng 4 năm 2025 đều mô tả một sản phẩm đã ngừng hoạt động. Nếu bạn thấy tài liệu gọi Codex là mô hình và đề xuất gọi nó qua code-davinci-002, hãy đóng tài liệu đó.

Codex hoạt động ở đâu: terminal, trình soạn thảo, trình duyệt hay ứng dụng?#

Bạn không phải chọn một trong số đó. Bạn dùng cùng một cách đăng nhập và cùng một tài khoản. Chỉ khác nhau ở nơi thuận tiện hơn cho công việc của bạn.

Tiện ích mở rộng hoạt động khác nhau với Xcode và JetBrains so với các trình soạn thảo khác:

Đám mây hoạt động khác với bốn nơi còn lại. Tác vụ được gửi đến một vùng chứa OpenAI, nơi một bản sao kho mã được lấy từ GitHub. Tác nhân làm việc mà không cần máy tính của bạn; sau đó bạn xem lại kết quả và quyết định có đưa thay đổi vào bản sao của mình hay không. Thiết lập gồm ba bước: kết nối GitHub, tạo môi trường với các phần phụ thuộc cần thiết và giao một tác vụ.

Nếu đăng nhập bằng khóa API, terminal, trình soạn thảo và ứng dụng sẽ hoạt động. Đám mây không dùng được với khóa API, cũng như các tính năng liên quan như tự động đánh giá mã và khởi chạy tác vụ từ Slack. Bạn cần đăng nhập bằng tài khoản ChatGPT để sử dụng các tính năng đó.

Codex chạy mô hình nào?#

OpenAI tóm tắt trong một câu:

Bên cạnh mô hình còn có một tùy chọn khác: mức độ suy luận. Tùy chọn này có bốn mức: Low (được gọi là Light trong ứng dụng và trình soạn thảo), Medium, High và Extra High. OpenAI khuyến nghị dùng mức thấp nhất vẫn cho kết quả cần thiết và tăng lên khi nhiệm vụ đòi hỏi lập kế hoạch.

Phía trên còn có hai chế độ. Max cho mô hình thêm thời gian để thực hiện tác vụ. Ultra chia công việc thành nhiều phần rồi giao cho các tác nhân phụ xử lý song song. Tài liệu nói rõ rằng hầu hết tác vụ không cần hai chế độ này.

Ngoài ra còn có lựa chọn riêng gpt-5.3-codex-spark — phiên bản nghiên cứu dành cho các vòng lặp nhanh, chỉ có trong gói Pro.

Việc chọn mô hình và mức độ suy luận đã là thiết kế ngữ cảnh: bạn quyết định tác nhân suy nghĩ nhiều đến đâu và mang gì vào tác vụ.

Codex có giá bao nhiêu và các gói bao gồm những gì?#

Tôi đã đối chiếu giá với trang giá chính thức vào ngày 1 tháng 8 năm 2026.

Business có giá $25 mỗi chỗ ngồi khi thanh toán hằng tháng thay vì $20.

Tiếp theo là giới hạn sử dụng. OpenAI không đưa ra một con số cố định:

Thay vì một con số duy nhất, OpenAI công bố một khoảng: số tin nhắn bạn có thể gửi trong năm giờ khi làm việc trên máy của mình. Số liệu của Plus và Business giống nhau:

Trong gói Pro giá $100, mọi số liệu được nhân năm; trong gói Pro giá $200, nhân hai mươi. OpenAI cũng đề cập đến giới hạn hằng tuần ngoài khung năm giờ, nhưng không công bố số liệu cụ thể.

Khoảng chênh lệch gấp mười lần trong cùng một mô hình có lời giải thích đơn giản. Một tin nhắn có thể dùng 1 phần trăm hoặc 10 phần trăm hạn mức hằng ngày vì lượng công việc đã thực hiện mới là yếu tố quyết định, còn số lượng yêu cầu ít ảnh hưởng. Tôi đã giải thích chi tiết cách token được sử dụng trên thực tế, lấy Claude làm ví dụ, trong bài Giới hạn Claude Pro và Max — cơ chế hoàn toàn giống nhau.

Khi dùng hết hạn mức, có ba lựa chọn: mua thêm tín dụng mà không đổi gói, chuyển sang mô hình nhẹ hơn hoặc bắt đầu phiên bằng khóa API và trả phí theo số token đã dùng.

Codex có những hạn chế theo khu vực nào?#

OpenAI công khai danh sách chính thức các quốc gia và vùng lãnh thổ được hỗ trợ. Belarus không có trong danh sách. Kazakhstan, Armenia, Georgia, Thổ Nhĩ Kỳ, Serbia và Ukraine có trong danh sách.

Nội dung trên chính trang đó ghi:

Cài đặt và chạy chương trình là một chuyện; truy cập mô hình lại là chuyện khác. Việc kiểm tra quốc gia diễn ra khi đăng nhập: cả đăng nhập bằng ChatGPT lẫn đăng nhập bằng khóa API đều dẫn đến tài khoản OpenAI.

Các báo cáo trên GitHub cho thấy thông báo từ chối liên quan đến quốc gia trông như thế nào. Vào tháng 1 năm 2026, một nhà phát triển ở Venezuela viết rằng họ dùng Codex 0.88.0 trong PowerShell và lần nào thử cũng nhận được cùng một lỗi:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

Mã unsupported_country_region_territory và trạng thái 403 cho biết yêu cầu bị từ chối liên quan đến quốc gia. Nếu gặp thông báo này, nghĩa là bạn không làm hỏng gì trong quá trình cài đặt và Node không liên quan.

Còn có một rào cản thứ hai không hề được mô tả trong tài liệu nhưng lại thường gặp hơn ngoài thực tế: xác minh số điện thoại. Báo cáo “Xác minh số điện thoại không hoạt động” có 206 bình luận; một báo cáo khác về số điện thoại cũ không còn truy cập được và không thể thay thế đã mở từ tháng 6 năm 2026 và có 71 bình luận. Câu chuyện lặp đi lặp lại: ChatGPT hoạt động trên trình duyệt với cùng tài khoản, nhưng Codex yêu cầu xác minh điện thoại và không có cách nào vượt qua. OpenAI không công bố danh sách quốc gia có số điện thoại được chấp nhận, nên không thể kiểm tra trước số của bạn có dùng được hay không.

Tôi không đề cập đến các cách lách hạn chế; bài viết này nói về cách công cụ hoạt động.

Anthropic cũng công bố danh sách quốc gia được hỗ trợ và hoạt động theo cách tương tự. Những tài liệu mô tả một công cụ là “được phép” còn công cụ kia là “bị chặn” chỉ khiến độc giả hiểu sai — về mặt chính thức, cả hai có cùng trạng thái. Cả hai danh sách đều thay đổi, vì vậy hãy kiểm tra phiên bản hiện tại.

Cách cài đặt Codex: từng bước#

Phần kỹ thuật bắt đầu ở đây, dành cho những người đã có tài khoản OpenAI đang hoạt động.

1. Cài đặt chương trình

   Chọn phương thức phù hợp với hệ thống của bạn. Sau này, hãy dùng chính phương thức đó để cập nhật chương trình lên phiên bản mới nhất.

2. Mở thư mục dự án

   Tác nhân làm việc trong thư mục mà bạn khởi chạy nó. Hãy chuyển đến đó trước khi chạy lệnh đầu tiên.

3. Đăng nhập vào tài khoản

   Lần đầu chạy codex, chương trình sẽ đề nghị bạn đăng nhập. Trình duyệt sẽ mở ra và sau khi đăng nhập, quyền điều khiển sẽ trở lại terminal.

4. Giao tác vụ đầu tiên

   Mô tả điều bạn cần bằng ngôn ngữ thông thường. Bắt đầu bằng việc vô hại, chẳng hạn yêu cầu nó mô tả dự án.

Lệnh cài đặt cho macOS và Linux:

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

Trên Windows, dùng cùng trình cài đặt qua PowerShell:

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

Nếu đã có Node, bạn có thể cài qua npm:

npm install -g @openai/codex

Homebrew hoạt động trên macOS. Hãy dùng --cask; nếu không, bạn sẽ cài nhầm chương trình:

brew install --cask codex

Trên Linux và WSL2, sandbox được xây dựng dựa trên bubblewrap, cần cài đặt trước:

sudo apt install bubblewrap

Trên Fedora và các hệ thống liên quan, dùng sudo dnf install bubblewrap. Ngoài ra, WSL phiên bản 1 được hỗ trợ đến phiên bản 0.114; từ 0.115 trở đi, sandbox chuyển sang bubblewrap và WSL1 không còn hoạt động. Tuy nhiên, trên Windows mọi thứ vẫn chạy được mà không cần WSL, nhờ sandbox tích hợp sẵn của hệ điều hành.

Nên làm gì khi chạy lần đầu?#

Để bắt đầu, hãy vào thư mục dự án rồi nhập codex; một phiên làm việc sẽ mở ra. Sau đó mô tả tác vụ bằng ngôn ngữ thông thường, không cần cú pháp đặc biệt.

Năm lệnh cho vài phút đầu tiên:

1. /status - mô hình, chính sách phê duyệt và các thư mục mà tác nhân xem là không gian làm việc.
2. /permissions - chế độ truy cập hiện tại và cách chuyển giữa các chế độ.
3. /model - thay đổi mô hình và mức độ suy luận.
4. /init - tạo tệp AGENTS.md mô tả dự án; phần tiếp theo sẽ nói thêm về tệp này.
5. /review - đánh giá riêng các thay đổi của bạn mà không chỉnh sửa tệp.

Ngoài lệnh codex thông thường, còn có ba lệnh terminal hữu ích:

codex resume                    # quay lại cuộc trò chuyện trước trong thư mục này
codex exec "fix the tests"      # chạy một lần không cần hội thoại, dành cho tập lệnh
codex --image screenshot.png    # đính kèm hình ảnh vào tác vụ

Trong tài liệu về cả terminal lẫn tiện ích mở rộng, OpenAI đều lặp lại cùng một lời khuyên: commit trước và sau mỗi tác vụ. Tác nhân tự chỉnh sửa tệp, vì vậy ngay từ ngày đầu tiên, bạn sẽ muốn có thể hoàn tác bằng một lệnh.

Giải thích dự án cho Codex bằng AGENTS.md như thế nào?#

Thứ tự này rất nghiêm ngặt và tài liệu nêu ngay ở dòng đầu tiên của mục:

Trước hết, Codex đọc tệp toàn cục ~/.codex/AGENTS.md, nơi bạn ghi những thói quen áp dụng cho mọi dự án. Sau đó, nó đọc các tệp trong chính dự án: mỗi thư mục một tệp, từ thư mục gốc kho mã xuống đến thư mục hiện tại. Chúng được kết hợp từ trên xuống dưới, và tệp ở gần sẽ ghi đè tệp ở xa hơn. Điều đó có nghĩa là quy tắc trong services/payments được ưu tiên hơn quy tắc chung ở thư mục gốc.

Một tệp đơn giản trông như sau:

# AGENTS.md

## How to work with this project

- Run tests with `npm test`; don't run them one file at a time.
- Install packages with pnpm.
- Ask me before adding a new production dependency.
- Do not touch the `legacy/` folder at all.

Giới hạn là 32 kilobyte cho tổng dung lượng các tệp. Khi vượt quá, những tệp tiếp theo đơn giản là không được thêm vào mà không có thông báo. AGENTS.md quá lớn cũng tiêu tốn hạn mức ở mỗi lần chạy vì toàn bộ tệp được đưa vào ngữ cảnh.

Nếu bạn biết CLAUDE.md, cơ chế này sẽ quen thuộc: cùng một kỹ thuật nhưng tên gọi khác nhau. Tệp quy tắc của dự án là nền tảng của một Second Brain: tác nhân tìm hiểu công việc của bạn trước khi bạn có cơ hội giải thích bất cứ điều gì. Tôi đã viết về cách dùng cả hai tệp trong một dự án ở bài Dùng AGENTS.md và CLAUDE.md cùng nhau.

Codex tự làm được gì và việc gì cần phê duyệt?#

Hai cài đặt này thường bị nhầm lẫn, vì vậy OpenAI giải thích sự khác nhau trong một câu:

Chuyển chế độ xem xét sang tự động không làm thay đổi ranh giới của thư mục làm việc. Tự động hóa chỉ bỏ các thao tác nhấp chuột; nó không thay đổi quyền của tác nhân.

Ứng dụng và trình soạn thảo có ba chế độ truy cập. Yêu cầu phê duyệt luôn khả dụng và là lựa chọn khởi đầu được khuyến nghị. Bạn phải bật Phê duyệt thay tôi và Quyền truy cập đầy đủ trong phần cài đặt trước.

Terminal có cơ chế riêng: chương trình kiểm tra thư mục và đề xuất một bộ quyền phù hợp.

Ở chế độ cục bộ, quyền truy cập mạng bị tắt theo mặc định. Tác nhân chạy những lệnh do chính nó nghĩ ra và không ai muốn các lệnh đó được truy cập internet theo mặc định.

Ngay cả trong thư mục làm việc, ở mọi chế độ tác nhân cũng chỉ có thể đọc một số vị trí nhất định: .git, .agents và .codex. Dùng /status để xem những thư mục nào hiện được tác nhân xem là không gian làm việc.

Còn có chế độ quyền truy cập đầy đủ — cờ --dangerously-bypass-approvals-and-sandbox. Tài liệu đánh dấu chế độ này có rủi ro cao hơn và ghi nhãn “không khuyến nghị”. Tên cờ đã nói lên tất cả; tôi không có gì cần bổ sung.

Nên chọn Codex hay Claude Code?#

Sự khác biệt giữa hai công cụ nhỏ hơn bạn có thể nghĩ khi đọc các cuộc tranh luận trên mạng. Cả hai đều đọc dự án và tự chỉnh sửa tệp, đồng thời đều hỏi trước khi ra ngoài thư mục.

Ban đầu, cách dễ nhất là xem bạn đang trả tiền cho dịch vụ nào. Nếu có gói đăng ký ChatGPT, bạn đã có Codex; không cần trả thêm. Tôi đã thực hiện một bài so sánh chi tiết kèm số liệu riêng về Codex so với Claude Code; nếu muốn chuyển cài đặt làm việc từ công cụ này sang công cụ kia, bạn có thể xem hướng dẫn di chuyển.

Điều gì thường gặp trục trặc khi chạy lần đầu?#

Danh sách này dựa trên các báo cáo trong kho mã dự án. Không có phỏng đoán; mỗi mục đều đến từ một người đã gặp vấn đề đó.

1. Cài nhầm gói. npm install -g codex không có tiền tố sẽ cài công cụ tạo trang web tĩnh từ năm 2011. Gói đúng là @openai/codex.
2. Chưa cài bubblewrap. Nếu không có nó trên Linux và WSL2, sandbox sẽ không khởi động. Codex chuyển sang dùng phương án dự phòng tích hợp sẵn và báo lỗi khi khởi động. Cài đặt bằng một lệnh.
3. Bị từ chối truy cập do quốc gia. Mã unsupported_country_region_territory và trạng thái 403 xuất hiện khi đăng nhập. Việc này không liên quan đến cài đặt.
4. Phải xác minh điện thoại. Vấn đề này không xảy ra với tất cả mọi người và không được mô tả trong tài liệu. Không có cách chính thức để thay số điện thoại không còn truy cập được; báo cáo về việc này đã mở từ tháng 6 năm 2026.
5. Hết hạn mức sử dụng sớm hơn dự kiến. Báo cáo “Token bị tiêu hao rất nhanh” được thảo luận nhiều nhất trong toàn bộ kho mã, với 627 bình luận. Chuyển sang mô hình nhẹ hơn và giảm mức độ suy luận có thể giúp ích.

Ngôn ngữ giao diện không ảnh hưởng đến công việc của tác nhân: ngôn ngữ của nhiệm vụ không nhất thiết phải trùng với ngôn ngữ giao diện.

Nên làm gì tiếp theo#

Giờ đầu tiên làm việc với tác nhân lúc nào cũng dành cho cùng một việc: tìm hiểu nó có thể tự làm đến đâu. Bạn chỉ có thể biết điều đó bằng dự án của chính mình; ví dụ trong tài liệu không thể cho bạn câu trả lời.

Đây là thứ tự tôi khuyên bạn nên bắt đầu:

1. Cài chương trình và đăng nhập vào tài khoản OpenAI đang hoạt động.
2. Mở thư mục dự án thật và chạy codex.
3. Xem /status, /permissions, chọn chỉ đọc rõ cho tác vụ chỉ xem và xác minh chế độ hoạt động trước hỏi cấu trúc dự án.
4. Tạo một commit rồi giao tác vụ chỉnh sửa đầu tiên.
5. Viết một tệp AGENTS.md dài ba dòng và so sánh phản hồi của tác nhân trước và sau khi có tệp.

Tài liệu về cách làm việc với công cụ có trong tài liệu Ailoot.