Cài đặt Codex CLI trên Windows, macOS, Linux và đăng nhập (cập nhật 2026)

Codex CLI là gì?

Codex CLI là coding agent mã nguồn mở của OpenAI chạy trong terminal: đọc mã, sửa file, chạy lệnh trong một sandbox và hỏi bạn trước những thao tác rủi ro. Codex còn có extension cho VS Code, Cursor, Windsurf và nằm trong ứng dụng ChatGPT trên máy tính; bài này hướng dẫn bản dòng lệnh. Tổng quan các bản của Codex có ở bài Codex là gì.

Cài trên macOS và Linux

Chọn một trong các cách dưới; bộ cài chính thức không cần Node.js:

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

# Hoặc Homebrew
brew install --cask codex

# Hoặc npm
npm install -g @openai/codex

Cài trên Windows

Codex chạy trực tiếp trên Windows với sandbox riêng của Windows, hoặc trong WSL2 nếu bạn quen môi trường Linux (WSL1 không còn được hỗ trợ). Cài bằng PowerShell:

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

Đăng nhập: tài khoản ChatGPT hay API key

Chạy codex login để đăng nhập bằng tài khoản ChatGPT: Codex có trong các gói ChatGPT từ Free tới Enterprise, với hạn mức theo gói. Trên máy không có trình duyệt, thêm --device-auth. Kiểm tra trạng thái bằng codex login status.

Dùng API key thì Codex tính theo token, không theo hạn mức của gói ChatGPT. Với key của OpenAI, đăng nhập bằng codex login --with-api-key và đưa key qua đầu vào chuẩn; với key của một gateway, khai báo nhà cung cấp riêng trong ~/.codex/config.toml theo bài Codex CLI với API key riêng.

Sandbox và phê duyệt

Codex tách hai câu hỏi: được làm gì (sandbox) và lúc nào phải hỏi bạn (phê duyệt). Trong thư mục Git, Codex gợi ý chế độ tự động: được ghi trong thư mục làm việc, hỏi khi cần vượt ra ngoài. Đổi trong phiên bằng /permissions, hoặc bằng cờ khi khởi động:

• --sandbox read-only: chỉ đọc, hợp để hỏi đáp về mã nguồn.
• --sandbox workspace-write: được sửa file trong thư mục làm việc; cờ cũ --full-auto đã bị bỏ, dùng cờ này thay thế.
• --ask-for-approval on-request hoặc never: lúc nào Codex hỏi bạn trước khi làm.
• Chế độ bỏ qua mọi sandbox và phê duyệt chỉ nên dùng trong môi trường cách ly như container, không dùng trên máy làm việc chính.

Lệnh hay dùng trong Codex

Trong phiên Codex, gõ dấu gạch chéo để gọi lệnh:

• /model: đổi model, ví dụ giữa GPT-6.1 Sol, GPT-6 Luna và GPT-6 Astra.
• /init: tạo file AGENTS.md mô tả quy ước của dự án.
• /status và /usage: xem cấu hình đang dùng và mức đã dùng.
• /review và /diff: xem lại các thay đổi Codex vừa làm.
• /compact, /new, /resume: tóm gọn phiên, mở phiên mới, quay lại phiên cũ.
• codex exec (ngoài phiên): chạy một yêu cầu không tương tác, hợp cho script và CI.

Lỗi hay gặp sau khi cài

Một số lỗi đến từ cấu hình cũ chép từ bài hướng dẫn trước đây; danh sách đầy đủ theo nguyên văn thông báo có ở bài lỗi Codex thường gặp:

• Báo wire_api = "chat" không còn được hỗ trợ: đổi mọi nhà cung cấp trong config.toml sang wire_api = "responses", kể cả nhà cung cấp không dùng tới.
• Không đăng nhập được trên máy chủ không có trình duyệt: dùng codex login --device-auth.
• Báo không khởi động được với chính sách phê duyệt untrusted: giá trị này đã bị bỏ, dùng read-only kèm on-request.
• Lỗi kết nối sau proxy công ty có kiểm tra TLS: đặt biến CODEX_CA_CERTIFICATE trỏ tới chứng chỉ của proxy.

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