Tự động hoá · 9 phút đọc · 2026-11-13
Cài Codex CLI trên Windows: cài, đăng nhập, cập nhật, gỡ
Codex CLI chạy thẳng trong PowerShell với sandbox của Windows, không bắt buộc WSL. Bài có lệnh cài chính thức, dấu hiệu đúng ở từng bước, cách xử lý lỗi sandbox, cập nhật, gỡ và gói nào dùng được CLI.
Muốn cài Codex CLI trên Windows, bạn mở một cửa sổ PowerShell mới và dán đúng một lệnh của OpenAI, không cần Node, không cần WSL. Codex CLI là tác tử viết mã của OpenAI chạy trong terminal trên máy bạn; trên Windows nó chạy thẳng trong PowerShell với sandbox riêng của Windows, còn WSL2 chỉ là lựa chọn khi bạn cần công cụ Linux.
Các lệnh trong bài lấy từ tài liệu Codex CLI, đọc ngày 13/11/2026. Máy mình viết bài đang chạy bản standalone codex-cli 0.160.0, đăng nhập bằng ChatGPT; kết quả lệnh kiểm trên máy đó dùng để tả dấu hiệu đúng ở từng bước.
Trước khi cài: bạn cần chuẩn bị gì
- Windows 11 là nền tài liệu khuyên dùng. Windows 10 bản mới, cập nhật đầy đủ ở mức "Best effort" và trên thực tế cần bản 1809 trở lên.
- Một tài khoản ChatGPT có Codex, hoặc một API key của OpenAI. Gói nào dùng được CLI, xem mục giá bên dưới.
- PowerShell có sẵn trong Windows. Bản standalone không cần Node.js; chỉ cách cài bằng npm mới cần Node 16 trở lên (kiểm bằng
node --version). - Một thư mục dự án có Git. Tài liệu khuyên tạo điểm lưu Git trước và sau mỗi việc để còn quay lại được.
Tài liệu không ghi thời gian cài, nên mình không ước con số. Phần lâu nhất thường là bước đăng nhập trên trình duyệt.
Các bước cài Codex CLI trên Windows bằng PowerShell
- Mở một cửa sổ PowerShell mới. Không cần quyền quản trị cho bước này.
- Dán lệnh cài standalone dưới đây rồi nhấn Enter.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Xong khi trình cài chạy hết và trả lại dấu nhắc. Cờ -ExecutionPolicy ByPass chỉ áp cho đúng lần chạy trình cài này, nên bạn không cần đổi chính sách thực thi script của cả máy.
- Đóng cửa sổ đó, mở cửa sổ PowerShell mới, gõ
codex --version. Dấu hiệu đúng là một dòng dạngcodex-cli 0.xxx.x. Nếu báo không nhận lệnh, chạywhere.exe codexđể xem lệnh nằm đâu. - Dùng
cdvào thư mục dự án, chạycodex, chọn "Sign in with ChatGPT" rồi làm tiếp trên trình duyệt. Xong khi terminal vào phiên làm việc. Nếu trình duyệt không quay về được terminal, thoát ra và chạycodex login --device-auth. - Chạy
codex login status. Dấu hiệu đúng là dòngLogged in using ChatGPT. - Giao việc đầu tiên, ví dụ "Tell me about this project". Gõ
/initđể Codex tạo tệp AGENTS.md, và/statusđể xem cấu hình, chế độ quyền, hạn mức còn lại.
Bản standalone đặt codex.exe vào %LOCALAPPDATA%\Programs\OpenAI\Codex\bin; trên máy mình, where codex trả về đúng thư mục đó. Tài liệu không nói trình cài có tự thêm thư mục này vào PATH hay không, nên nếu cửa sổ mới vẫn không nhận lệnh, kiểm biến PATH đã có thư mục đó chưa.
Cách phụ: npm, cài không hỏi, winget
Tài liệu ghi npm là cách "also": dùng được, nhưng đứng sau bản standalone. Gói @openai/codex ngày 13/11/2026 ở bản 0.167.2, trùng bản phát hành rust-v0.167.2 trên GitHub.
npm install -g @openai/codexMuốn cài bằng script mà không bị hỏi, đặt CODEX_NON_INTERACTIVE=1 (dòng đầu dưới đây). Trình cài tải từ releases.openai.com, lỗi thì tự lùi sang GitHub Releases; dòng thứ hai ép dùng GitHub Releases ngay, theo README của openai/codex.
$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iexCòn winget: tài liệu Codex không đưa lệnh winget nào để cài CLI; lệnh winget duy nhất trong tài liệu Windows là để cài ChatGPT desktop app. Kho winget-pkgs có thư mục gói OpenAI.Codex, nhưng mình không xác nhận được ai duy trì nó và OpenAI không nhắc tới. Tệp docs/install.md trên GitHub vẫn ghi "Windows 11 via WSL2"; trang tài liệu chính mới hơn nói chạy thẳng được, nên bài theo trang chính.
Codex Windows sandbox: ba kiểu và lúc nào cần quyền quản trị
Mặc định Codex chạy lệnh với mạng tắt và chỉ ghi được trong thư mục làm việc hiện tại. Thư mục có Git thì vào chế độ Auto (ghi trong thư mục, hỏi khi cần); thư mục không có quản lý phiên bản thì bắt đầu ở read-only cho tới khi bạn tin cậy nó. Ngay trong vùng ghi được, .git, .codex, .agents, .aws vẫn chỉ đọc.
Trang Windows sandbox nêu ba kiểu:
- `mxc` — dùng Microsoft Execution Containers, kiểu được khuyên dùng; không cần quyền quản trị, không tạo thêm tài khoản Windows, không thêm luật tường lửa. Cần Windows 11 24H2 (build 26100.9278) hoặc 25H2 (build 26200.9278), Microsoft đang mở dần.
- `elevated` — dự phòng chính khi không có MXC. Bước dựng cần quản trị viên duyệt nên bạn sẽ thấy hộp UAC; lệnh trong sandbox vẫn chạy không có quyền quản trị.
- `unelevated` — dự phòng cũ hơn, cách ly mạng yếu hơn và không chặn được việc đọc đường dẫn.
Với CLI chạy riêng, MXC bật bằng prefer_mxc = true dưới [features] trong ~/.codex/config.toml. Trước đó nên kiểm máy có chạy được MXC không bằng lệnh dưới đây, trong thư mục dự án. Lệnh cần Codex CLI 0.162.0 trở lên; bản 0.160.0 trên máy mình còn thấp hơn, nên phải cập nhật trước.
codex -c windows.sandbox=mxc sandbox --include-managed-config --permission-profile :workspace -- cmd.exe /d /c echo MXC_OK
$LASTEXITCODEĐạt khi in MXC_OK và mã thoát 0. Không đạt thì chọn kiểu dự phòng trong mục [windows]:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated"Từ chối hộp UAC, hoặc máy công ty chặn, thì Codex có thể lùi về unelevated. Sau đó gõ /setup-default-sandbox trong phiên CLI để dựng lại sandbox elevated. Máy công ty không có quyền quản trị thì nhờ IT chạy codex sandbox setup --elevated kèm tài khoản và thư mục Codex home của bạn.
Còn tệp codex-windows-sandbox-setup-*.exe mà nhiều người tìm: nó có trong bản phát hành GitHub, nhưng tài liệu không bảo tải tay rồi chạy. Cứ để Codex tự dựng khi nó hỏi, hoặc dùng /setup-default-sandbox.
"Running Codex in full access mode means Codex is not limited to your project directory and might perform unintentional destructive actions that can lead to data loss."
Đó là cảnh báo nguyên văn của OpenAI về chế độ full access (danger-full-access). Mình khuyên giữ sandbox; muốn thận trọng hơn thì chạy codex --sandbox read-only --ask-for-approval on-request.
Lỗi hay gặp khi cài Codex CLI trên Windows
- Gõ `codex` báo không nhận lệnh — mở cửa sổ PowerShell mới, chạy
where.exe codex. Ra hai dòng thì có thể máy đang có cả bản npm lẫn bản standalone; giữ một bản. - Trình duyệt không quay về terminal — mạng có thể chặn callback về
localhost:1455. Dùngcodex login --device-auth, sau khi bật đăng nhập bằng mã thiết bị trong cài đặt bảo mật ChatGPT. Lỗi đăng nhập ghi vàocodex-login.log. - Dựng sandbox thất bại — thường do từ chối UAC, hoặc máy cấm tạo user, cấm sửa tường lửa. Thử lại và duyệt hộp quản trị, hoặc tạm dùng
unelevated. - Lỗi Windows 1385 — chính sách Windows chặn kiểu đăng nhập của user sandbox. Cần IT xử lý; tạm dùng
unelevated. - Cảnh báo thư mục "writable by Everyone" — gỡ quyền ghi của nhóm Everyone khỏi các thư mục được liệt kê.
- Lệnh không đọc được một thư mục — dùng
/statusvà/debug-configđể xem quyền đang áp.
Gửi hỗ trợ thì kèm CODEX_HOME/.sandbox/sandbox.log, đừng gửi thư mục .sandbox-secrets. Chẩn đoán chung thì chạy codex doctor: lệnh kiểm cài đặt, cấu hình, đăng nhập, Git, terminal.
Codex CLI update: hai cách lên bản mới
Cách gọn nhất là codex update, lệnh kiểm và áp bản mới khi bản đang cài hỗ trợ tự cập nhật. Cách thứ hai luôn dùng được: chạy lại đúng lệnh cài standalone, vì trên Windows lệnh cài và lệnh cập nhật là một. Bản npm thì chạy lại npm install -g @openai/codex.
Cập nhật xong, so codex --version với bản mới nhất. Máy mình đang ở 0.160.0, trong khi bản mới nhất ngày 13/11/2026 là 0.167.2.
Gỡ Codex CLI và dọn thông tin đăng nhập
Trước tiên chạy codex logout. CLI và extension VS Code dùng chung thông tin đăng nhập, nên đăng xuất một bên thì bên kia cũng phải đăng nhập lại. Đã dựng sandbox elevated thì đóng các app đang dùng nó rồi chạy codex sandbox uninstall bằng quyền quản trị; lệnh gỡ tài khoản sandbox và luật mạng, giữ nguyên Codex home.
Tài liệu chưa có trang hướng dẫn gỡ bản standalone, nên mình chỉ nêu chỗ các thứ nằm: lệnh ở %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, cấu hình, log và phiên làm việc ở ~/.codex. Tệp ~/.codex/auth.json chứa token; tài liệu dặn coi nó như mật khẩu, đừng chia sẻ hay đưa lên kho mã. Bản npm thì gỡ bằng lệnh chuẩn của npm, npm uninstall -g @openai/codex.
Codex CLI có free không?
Chương trình thì có: mã nguồn Codex CLI theo giấy phép Apache-2.0, cài không mất tiền. Nhưng muốn dùng mô hình của OpenAI, bạn cần một gói ChatGPT hoặc API key. Theo trang giá ngày 13/11/2026:
- Free ($0) và Go ($8/tháng) — có Codex, nhưng trang chỉ ghi trong desktop app, "subject to rollout"; không ghi dùng được CLI hay extension.
- Plus ($20/tháng) — ghi rõ có Codex trong CLI và IDE extension.
- Pro — từ $100/tháng, có các mức $100, $200, $500.
- Business — $20 mỗi người mỗi tháng trả theo năm (từ 2 người), $25 nếu trả theo tháng.
- API key — dùng trong CLI và IDE extension, trả theo giá API chuẩn, không dùng hạn mức gói ChatGPT.
Hạn mức của Plus và Business là số tin nhắn tại máy mỗi 5 giờ, và trang nói đó chỉ là ước lượng; Pro hiện không có hạn 5 giờ nhưng có thể có hạn theo tuần. Ngoài ra, codex --help trên máy mình có cờ --oss để chạy với mô hình tại máy qua Ollama hoặc LM Studio; muốn đi đường này, xem bài chạy AI trên máy tính bằng Ollama.
Cài Codex trên VS Code
Extension tên "Codex – OpenAI’s coding agent", ID openai.chatgpt, nhà phát hành OpenAI. Bạn cài từ ô Extensions của VS Code hoặc từ Marketplace; trang IDE có liên kết cài cho VS Code, Cursor và Windsurf.
- Bấm biểu tượng Codex ở thanh bên. Không thấy thì mở Command Palette, chạy Codex: Open Codex Sidebar.
- Chọn Sign in with ChatGPT (hoặc Use API Key). CLI đã đăng nhập thì extension dùng chung.
- Muốn chạy trong WSL, bật
chatgpt.runCodexInWindowsSubsystemForLinux(mặc định tắt); VS Code sẽ tải lại.
Extension đã cài mà đứng im thì máy có thể thiếu C++ build tools: cài bằng winget install --id Microsoft.VisualStudio.2022.BuildTools -e, rồi tắt hẳn VS Code và mở lại.
Muốn thử một lựa chọn khác
Nếu bạn đang cân nhắc thêm một tác tử viết mã khác chạy trong terminal, bài cài Claude Code trên Windows đi theo cùng khuôn: lệnh cài, đăng nhập, cập nhật và giá.
Kiểm lại sau khi cài Codex CLI trên Windows
codex --versionin ra số bản dạngcodex-cli 0.xxx.x.where.exe codexchỉ ra một dòng.codex login statusbáo đã đăng nhập./statustrong phiên làm việc thấy đúng thư mục dự án và chế độ quyền.
- Tác giả
- Quản trị viên
- Đăng ngày
- 2026-11-13
- Cập nhật
- 2026-11-13
- Thời gian đọc
- 9 phút đọc
- Tất cả bài viết