Bỏ qua tới nội dung
Ông T.vn

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

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

Tóm tắt nhanh

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.

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.

CLI

openai/codex

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.

★ 135kRustApache-2.0
Xem repo trên GitHub

I.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.

II.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.

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

  1. Mở terminalMac/Linux mở Terminal, Windows mở PowerShell
  2. Chạy lệnh càiChọn script một dòng, npm hoặc Homebrew
  3. Vào thư mục dự ánDùng cd để đứng đúng thư mục muốn làm việc
  4. Gõ codexKhởi động công cụ
  5. Đăng nhậpChọn Sign in with ChatGPT

A.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.

B.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:

Terminal
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):

Terminal
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

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:

Terminal
# 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):

Terminal
# 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.

C.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ụ:

Terminal
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.

D.Chạy và đăng nhập

Gõ lệnh:

Terminal
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).

IV.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.

V.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

A.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.

B.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.

C.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.

D.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.

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

A.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.

B.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.

C.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.

D.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.

E.Đă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.

VII.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ử.

4.8/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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.

Chuyển nhanh tới mục

  1. I.Codex CLI làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal đúng chỗ
    2. B.Chạy lệnh cài
    3. C.Vào thư mục dự án
    4. D.Chạy và đăng nhập
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới vào dự án: nhờ giải thích code
    2. B.Chủ shop nhỏ: dựng công cụ xử lý file đơn giản
    3. C.Lập trình viên: sửa lỗi và dọn code
    4. D.Người làm văn phòng: nhờ viết tài liệu cho dự án
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ codex báo không tìm thấy lệnh
    2. B.Lệnh npm báo lỗi hoặc không có npm
    3. C.Script cài trên Windows bị chặn
    4. D.Không tải được file cài
    5. E.Đăng nhập không được hoặc không có quyền dùng
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.