Cách cài đặt Claude Code và Codex CLI trên Windows
Các lệnh PowerShell, CMD, WinGet và npm chính xác để cài đặt Claude Code và Codex CLI trên Windows 10 và 11, khi nào nên chọn WSL, và cách sửa lỗi 'claude is not recognized' cùng những lỗi khác bạn sẽ gặp.
Giờ đây cả hai CLI đều cài trên Windows chỉ bằng một dòng lệnh. Phần lớn rắc rối đến sau dòng đó: một terminal không tìm thấy lệnh, một chính sách thực thi (execution policy) chặn npm, một bản phân phối WSL 1 cũ, một lệnh bị dán nhầm shell. Hướng dẫn này đưa ra các lệnh chính xác cho từng cách cài, sau đó là các lỗi và cách sửa.
Thông tin về hai CLI lấy từ tài liệu của Anthropic và OpenAI cùng chính các script cài đặt, đọc ngày 16 tháng 11 năm 2026, với Claude Code 2.1.318 và Codex CLI 0.169.0. Cả hai công cụ thay đổi rất nhanh: nếu một lệnh bên dưới thất bại, hãy xem trang chính thức được liên kết trong từng phần.
Câu trả lời ngắn. Mở PowerShell, không phải CMD, và chạy:
irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Sau đó mở một terminal mới và chạy claude --version và codex --version. Nếu Windows báo rằng claude không được nhận diện, cách sửa PATH nằm trong bảng lỗi ở phía dưới.
Mỗi CLI cần gì trên Windows
| Claude Code | Codex CLI | |
|---|---|---|
| Phiên bản Windows | Windows 10 1809 trở lên, Windows Server 2019 trở lên | Khuyến nghị Windows 11, Windows 10 bản gần đây ở mức "best effort" |
| Bộ xử lý | x64 hoặc ARM64, không bao giờ 32-bit | x64 hoặc ARM64 |
| Tài khoản | Một gói Claude trả phí hoặc một tài khoản Console | Một gói ChatGPT hoặc một khóa API OpenAI |
| Node.js | Chỉ cho cách cài qua npm, phiên bản 22 trở lên | Chỉ cho cách cài qua npm |
| Git for Windows | Tùy chọn | Không bắt buộc |
| Sandbox trên Windows gốc | Không, chỉ trong WSL 2 | Có, sandbox Windows riêng của nó |
| Quyền quản trị để cài đặt | Không | Không |
Hai dòng trong bảng này khiến nhiều người bất ngờ. Claude Code không còn bắt buộc Git for Windows: khi không có, nó dùng PowerShell làm công cụ shell. Và Codex chạy lệnh trong sandbox ngay trên Windows gốc, trong khi Claude Code chỉ làm vậy bên trong WSL 2.
Cài đặt Claude Code trên Windows
Trang cài đặt của Anthropic liệt kê bốn cách. Trình cài đặt gốc là cách được khuyến nghị: nó không cần Node.js và tự cập nhật trong nền.
| Cách cài | Lệnh |
|---|---|
| PowerShell (khuyến nghị) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget install Anthropic.ClaudeCode |
| npm (Node.js 22+) | npm install -g @anthropic-ai/claude-code@latest |
Mỗi cách cài để lại những gì:
- Trình cài đặt gốc:
claude.exetrong%USERPROFILE%\.local\bin, các phiên bản trong%USERPROFILE%\.local\share\claude. Trình cài đặt cảnh báo khi.local\binkhông có trong PATH của bạn, và nó không tự thêm vào cho bạn. - WinGet: không có cập nhật tự động. Bạn cập nhật bằng
winget upgrade Anthropic.ClaudeCode, và Anthropic lưu ý rằng việc cập nhật có thể thất bại khi Claude Code đang chạy, vì Windows khóa file thực thi. - npm: với Node.js cũ hơn bản 22, quá trình cài kết thúc bằng một cảnh báo
EBADENGINE.
Để luôn đi sau bản mới nhất một phiên bản, trên kênh stable:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
Sau đó kiểm tra bản cài. claude --version in ra phiên bản, còn claude doctor chạy một bản chẩn đoán chỉ đọc cho bản cài và các thiết lập của nó.
Nếu bạn có Git for Windows, Claude Code tìm Git Bash trong C:\Program Files\Git, rồi đến C:\Program Files (x86)\Git, rồi đến git trong PATH của bạn. Để ép dùng một bản khác, hãy đặt CLAUDE_CODE_GIT_BASH_PATH trong khối env của settings.json. Giá trị này phải trỏ tới một file tên bash.exe hoặc sh.exe, không phải git-bash.exe.
Cài đặt Codex CLI trên Windows
Trang Windows của OpenAI nói rất rõ: mặc định dùng Codex gốc với sandbox Windows của nó, và chọn WSL khi công cụ của bạn vốn đã nằm trên Linux. Có một nguồn bị chậm cập nhật: trang cài đặt trong repository GitHub vẫn ghi "Windows 11 via WSL2". Tài liệu chính thức đã thay đổi, và trình cài đặt cũng vậy.
| Cách cài | Lệnh |
|---|---|
| Trình cài đặt PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm install -g @openai/codex |
Trình cài đặt PowerShell là cách dễ nhất. Đọc script sẽ thấy nó làm gì: nó cài Codex vào %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, thêm thư mục đó vào PATH của người dùng và vào phiên hiện tại, rồi bảo bạn mở một cửa sổ PowerShell mới. Chạy lại đúng lệnh đó sẽ cập nhật Codex. Với npm, bạn cập nhật bằng cách chạy lại lệnh cài.
Sau đó đăng nhập. Chạy codex và chọn Sign in with ChatGPT, hoặc chạy codex login. Trên máy không có trình duyệt, codex login --device-auth cho bạn một mã để nhập trên thiết bị khác. codex login status cho biết bạn đang đăng nhập bằng tài khoản nào.
Sandbox Windows
Codex có ba cách triển khai sandbox trên Windows:
mxc: cách được khuyến nghị, không cần thiết lập quyền quản trị. Nó cần Windows 11 24H2 (build 26100.9278) hoặc 25H2 (build 26200.9278).elevated: phương án dự phòng được ưu tiên. Nó cần một lần thiết lập duy nhất do quản trị viên phê duyệt.unelevated: cô lập mạng yếu hơn, và không có đường dẫn chỉ đọc.
Bạn chọn trong config.toml:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated" # or "unelevated"
Nếu sandbox thất bại với lỗi 1385, Windows đã từ chối kiểu đăng nhập của tài khoản sandbox. Khi đó OpenAI yêu cầu file CODEX_HOME/.sandbox/sandbox.log. Đừng bao giờ chia sẻ nội dung trong .sandbox-secrets/.
Windows gốc hay WSL?
| Gốc (PowerShell, CMD) | WSL 2 | |
|---|---|---|
| Cài Claude Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash bên trong WSL |
| Cài Codex | trình cài đặt PowerShell | curl -fsSL https://chatgpt.com/codex/install.sh | sh bên trong WSL |
| Sandbox của Claude Code | không có | có, với bubblewrap và socat |
| Sandbox của Codex | sandbox Windows | sandbox Linux |
| Nơi để repository | ở đâu cũng được | trong ~/, không phải trong /mnt/c/ |
Chọn WSL 2 khi dự án của bạn vốn đã build và chạy trên Linux, hoặc khi bạn muốn Claude Code chạy các lệnh của nó trong sandbox. Hãy ở lại Windows gốc khi dự án của bạn là dự án Windows: .NET, script PowerShell, đường dẫn Windows ở khắp nơi.
Ba quy tắc nếu bạn đi theo hướng WSL:
- WSL 2, không bao giờ WSL 1. Codex ngừng hỗ trợ WSL 1 từ phiên bản 0.115. Sandbox của Claude Code từ chối WSL 1 với thông báo
Sandboxing requires WSL2, và việc cài trên WSL 1 có thể thất bại vớiExec format error. Chuyển đổi một bản phân phối bằngwsl --set-version <DistroName> 2. - Cài và chạy bên trong WSL. Chạy lệnh Linux trong terminal WSL, không phải trong terminal PowerShell. Gọi Node.js của Windows từ WSL chính là nguyên nhân gây ra
exec: node: not found: hãy cài Node.js ngay trong bản phân phối, bằng trình quản lý gói của nó hoặc nvm. - Giữ code trong hệ thống file Linux. Cả hai nhà cung cấp đều khuyên để repository ngoài
/mnt/c/, và Anthropic lưu ý rằng các tìm kiếm của Claude Code ở đó kém đầy đủ hơn. Hãy clone nó vào thư mục home Linux của bạn.
"claude is not recognized" và các lỗi khác
| Bạn thấy gì | Vì sao | Cách sửa |
|---|---|---|
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell) | %USERPROFILE%\.local\bin không có trong PATH của bạn | Thêm nó vào PATH của người dùng (lệnh ở bên dưới), rồi mở một terminal mới |
| Vẫn không được nhận diện sau khi thêm | Terminal, hoặc trình soạn thảo chứa nó, đã khởi động trước thay đổi | Đóng và mở lại terminal, cả trình soạn thảo nếu terminal nằm bên trong nó |
| Không được nhận diện ngay sau một lần cập nhật | Một lần cập nhật bị ngắt giữa lúc hoán đổi file đã không để lại claude.exe nào | Đổi tên claude.exe.old.* mới nhất trở lại thành claude.exe (lệnh ở bên dưới) |
'irm' is not recognized | Bạn đã dán dòng PowerShell vào CMD | Mở PowerShell, hoặc dùng dòng dành cho CMD |
The token '&&' is not a valid statement separator | Bạn đã dán dòng CMD vào Windows PowerShell | Dùng dòng dành cho PowerShell |
npm.ps1 cannot be loaded because running scripts is disabled on this system | Chính sách thực thi chặn file shim PowerShell của npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, hoặc gọi npm.cmd |
| Một lỗi về Windows 32-bit trên máy 64-bit | Bạn đã mở "Windows PowerShell (x86)" từ menu Start | Mở PowerShell 64-bit thông thường |
claude mở ứng dụng desktop thay vì CLI | Một ứng dụng desktop Claude cũ đã đặt Claude.exe vào WindowsApps, đứng trước CLI trong PATH | Cập nhật ứng dụng desktop Claude |
requires either Git for Windows (for bash) or PowerShell | Claude Code không tìm thấy shell nào trong hai shell này | Cài Git for Windows, hoặc kiểm tra rằng PowerShell có trong PATH |
EBADENGINE trong lúc npm install | Node.js cũ hơn bản 22 | Cập nhật Node.js, hoặc dùng trình cài đặt gốc |
Cách sửa PATH, trong PowerShell, cho người dùng hiện tại, không cần quyền quản trị:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Để xem Windows tìm ở đâu trước khi bạn thay đổi bất cứ điều gì:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
Đổi tên sau một lần cập nhật bị hỏng:
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
Về chính sách thực thi: Windows PowerShell 5.1, bản đi kèm Windows, mặc định là Restricted trên máy client, đó là lý do một chiếc laptop mới chặn npm.ps1. Phạm vi CurrentUser không cần quyền quản trị. Trình cài đặt gốc của Claude và trình cài đặt của Codex không bị ảnh hưởng: irm | iex và -ExecutionPolicy ByPass không bao giờ nạp một file script từ ổ đĩa.
Cập nhật và gỡ cài đặt
| Claude Code | Codex CLI | |
|---|---|---|
| Cập nhật ngay | claude update (gốc), winget upgrade Anthropic.ClaudeCode, hoặc chạy lại lệnh cài npm | codex update trên các bản có hỗ trợ, chạy lại trình cài đặt PowerShell, hoặc npm install -g @openai/codex |
| Cập nhật tự động | chỉ với bản cài gốc, tắt bằng DISABLE_AUTOUPDATER=1 | không có trong tài liệu |
| Gỡ cài đặt | xóa %USERPROFILE%\.local\bin\claude.exe và %USERPROFILE%\.local\share\claude, hoặc winget uninstall Anthropic.ClaudeCode, hoặc npm uninstall -g @anthropic-ai/claude-code | xóa thư mục cài đặt, hoặc npm uninstall -g @openai/codex |
| Thiết lập còn sót lại | %USERPROFILE%\.claude và %USERPROFILE%\.claude.json | %USERPROFILE%\.codex |
Những gì chúng tôi học được khi chạy CLI agent trên Windows
AgentsRoom khởi chạy Claude Code, Codex và các CLI agent khác song song, và phiên bản Windows của nó đã cho chúng tôi thấy những bản cài này hỏng ở đâu khi rời khỏi terminal. Có bốn điều đáng biết, kể cả khi bạn không bao giờ dùng ứng dụng của chúng tôi.
Một chương trình mở từ menu Start giữ nguyên PATH lúc nó khởi động. Bạn cài Claude Code, thêm .local\bin vào PATH, và một ứng dụng desktop đã mở từ trước vẫn không tìm thấy claude. Khởi động lại terminal là không đủ với những ứng dụng khởi chạy CLI thay cho bạn. AgentsRoom đọc lại PATH của người dùng và của máy từ registry mỗi khi tìm một CLI, nhờ vậy một bản cài vừa thành công không bị báo là thiếu.
npm không cài một file .exe. npm install -g @openai/codex ghi ba file vào %APPDATA%\npm: codex, codex.cmd và codex.ps1. Một chương trình khởi chạy trực tiếp codex sẽ nhận spawn codex ENOENT, vì Windows chỉ thêm .exe vào một tên không có đuôi. Terminal của bạn che giấu điều này, vì PowerShell và CMD đọc PATHEXT. Đây là thêm một lý do để ưu tiên các trình cài đặt gốc, vốn cung cấp một file thực thi thật sự.
Shim của npm cần Node.js lúc chạy. Nếu bạn cài Node.js rồi cài một CLI trong cùng một phiên, shim .cmd được tìm thấy nhưng thất bại với "node is not recognized" trong mọi chương trình đã khởi động trước khi Node.js có trong PATH. Triệu chứng tương tự xảy ra với một trình quản lý phiên bản Node có shim trỏ tới một phiên bản không đang được kích hoạt.
Khởi động một tiến trình trên Windows tốn kém hơn nhiều. Chúng tôi đo được 20 đến 80 ms để tạo một tiến trình trên Windows, so với 1 đến 3 ms trên macOS, và mỗi lần kiểm tra file tốn hơn vì phần mềm diệt virus kiểm tra nó. Bản phát hiện CLI đầu tiên của chúng tôi thử mọi thư mục, mọi tên và mọi đuôi file, và làm ứng dụng đứng hình tới một giây trên Windows. Đọc mỗi thư mục một lần duy nhất đã giải quyết vấn đề.
Trong ứng dụng, Trợ lý cài đặt cài một CLI còn thiếu bằng chính trình cài đặt của nhà cung cấp cho hệ điều hành của bạn (irm https://claude.ai/install.ps1 | iex cho Claude Code, script của OpenAI cho Codex), chuyển sang npm khi script thất bại, và chạy nó trong một terminal mà bạn có thể theo dõi. Khi một CLI không khởi động, CLI Doctor đọc lỗi và đúng lệnh đã chạy, rồi cho bạn biết cái gì đã hỏng. Khi cả hai CLI đã trả lời --version, hướng dẫn bắt đầu sẽ đưa bạn đi tiếp, và bài giới thiệu bản Windows cho biết ứng dụng làm được gì trên Windows.
Câu hỏi thường gặp
Làm sao để cài đặt Claude Code trên Windows?
Mở PowerShell và chạy irm https://claude.ai/install.ps1 | iex. Trong CMD, hãy dùng dòng install.cmd trên trang cài đặt của Anthropic, còn với WinGet thì chạy winget install Anthropic.ClaudeCode. File thực thi nằm trong %USERPROFILE%\.local\bin, thư mục mà trình cài đặt không thêm vào PATH: hãy tự thêm nếu claude không được nhận diện, rồi mở một terminal mới và chạy claude --version.
Có cần WSL để chạy Claude Code hoặc Codex trên Windows không?
Không. Cả hai đều chạy gốc trong PowerShell hoặc CMD trên Windows 10 và 11. WSL 2 đáng dùng khi dự án của bạn vốn đã nằm trên Linux, hoặc khi bạn muốn dùng sandbox của Claude Code, thứ không chạy trên Windows gốc. Hãy dùng WSL 2, không phải WSL 1: Codex đã bỏ hỗ trợ WSL 1 từ phiên bản 0.115.
Vì sao Windows báo 'claude' không được nhận diện ngay sau khi cài?
Trình cài đặt gốc đặt claude.exe vào %USERPROFILE%\.local\bin và in ra cảnh báo nếu thư mục đó không có trong PATH của bạn, nhưng nó không tự sửa PATH. Hãy thêm thư mục này vào PATH của người dùng, rồi đóng và mở lại terminal, cả trình soạn thảo nếu terminal chạy bên trong nó. Một terminal đã mở từ trước vẫn giữ PATH cũ.
Claude Code có cần Git for Windows không?
Không còn cần nữa. Trang cài đặt của Anthropic ghi Git for Windows là tùy chọn: không có nó, Claude Code dùng PowerShell làm công cụ shell. Khi có nó, Claude Code tìm Git Bash trong C:\Program Files\Git, và bạn có thể trỏ tới một bash.exe khác bằng thiết lập CLAUDE_CODE_GIT_BASH_PATH.
Có thể cài Codex CLI trên Windows mà không cần Node.js không?
Có. Trình cài đặt PowerShell của OpenAI tải về một bản Codex độc lập, đặt nó vào %LOCALAPPDATA%\Programs\OpenAI\Codex\bin và thêm thư mục đó vào PATH của người dùng. Chỉ cách cài qua npm, npm install -g @openai/codex, mới cần Node.js.
Nên dùng PowerShell hay CMD để cài đặt?
PowerShell. Cả hai lệnh một dòng chính thức đều là lệnh PowerShell, và các lỗi người ta hay gặp nhất đến từ việc dán một dòng PowerShell vào CMD hoặc ngược lại: 'irm' is not recognized nghĩa là bạn đang ở trong CMD, còn '&&' is not a valid statement separator nghĩa là bạn đang ở trong PowerShell. Hãy dùng PowerShell 64-bit, không phải mục "Windows PowerShell (x86)" trong menu Start.
Tải AgentsRoom
Chạy tất cả agent AI của bạn, trên mọi dự án, trong một cửa sổ duy nhất.
Ứng dụng đồng hành: theo dõi agent khi đi đường
Sử dụng Claude, Codex, Antigravity CLI hoặc nhà cung cấp AI khác.
Gửi lỗi và yêu cầu thẳng vào backlog công khai của bạn.
Đọc agent như một cuộc trò chuyện
Mỗi agent có vai trò, khuôn mặt và một luồng tin nhắn bạn đọc như ứng dụng nhắn tin.

Đọc thêm
Chế độ giọng nói trong Codex, OpenCode, Antigravity và Claude Code: CLI nào có?
Chúng tôi đã kiểm tra năm CLI agent lập trình và hai ứng dụng vào ngày 13 tháng 10 năm 2026. Codex CLI và oh-my-pi trò chuyện được bằng giọng nói, Claude Code và Antigravity CLI chỉ đọc chính tả vào prompt, OpenCode không có gì tích hợp sẵn. Cách khởi động từng công cụ, âm thanh được gửi đi đâu, và giọng nói tốn bao nhiêu token.
Đọc bài viếtClaude Code vs Codex CLI: nên chọn cái nào năm 2026 (và vì sao nên dùng cả hai)
So sánh thẳng thắn giữa Claude Code và Codex CLI: giá, tốc độ, MCP, khả năng kiểm soát. Và vì sao sau vài tuần, tôi ngừng phải chọn giữa hai cái.
Đọc bài viếtCách xóa Co-Authored-By Claude khỏi các commit Git của bạn
Claude Code ký tên vào commit của bạn bằng một trailer Co-Authored-By và vào pull request bằng một dòng Generated with Claude Code. Cài đặt để xóa chúng, file cần đặt cài đặt đó, và cách dọn sạch những commit bạn đã push.
Đọc bài viết