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 CodeCodex CLI
Phiên bản WindowsWindows 10 1809 trở lên, Windows Server 2019 trở lênKhuyế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-bitx64 hoặc ARM64
Tài khoảnMột gói Claude trả phí hoặc một tài khoản ConsoleMột gói ChatGPT hoặc một khóa API OpenAI
Node.jsChỉ cho cách cài qua npm, phiên bản 22 trở lênChỉ cho cách cài qua npm
Git for WindowsTùy chọnKhông bắt buộc
Sandbox trên Windows gốcKhông, chỉ trong WSL 2Có, sandbox Windows riêng của nó
Quyền quản trị để cài đặtKhôngKhô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àiLệnh
PowerShell (khuyến nghị)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget 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.exe trong %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\bin khô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àiLệnh
Trình cài đặt PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm 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 Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash bên trong WSL
Cài Codextrình cài đặt PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh bên trong WSL
Sandbox của Claude Codekhông cócó, với bubblewrap và socat
Sandbox của Codexsandbox Windowssandbox Linux
Nơi để repositoryở đâu cũng đượctrong ~/, 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:

  1. 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ới Exec format error. Chuyển đổi một bản phân phối bằng wsl --set-version <DistroName> 2.
  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.
  3. 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ì saoCá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ạnThê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êmTerminal, 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ậtMộ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 recognizedBạn đã dán dòng PowerShell vào CMDMở PowerShell, hoặc dùng dòng dành cho CMD
The token '&&' is not a valid statement separatorBạn đã dán dòng CMD vào Windows PowerShellDùng dòng dành cho PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemChính sách thực thi chặn file shim PowerShell của npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, hoặc gọi npm.cmd
Một lỗi về Windows 32-bit trên máy 64-bitBạn đã mở "Windows PowerShell (x86)" từ menu StartMở PowerShell 64-bit thông thường
claude mở ứng dụng desktop thay vì CLIMột ứng dụng desktop Claude cũ đã đặt Claude.exe vào WindowsApps, đứng trước CLI trong PATHCập nhật ứng dụng desktop Claude
requires either Git for Windows (for bash) or PowerShellClaude Code không tìm thấy shell nào trong hai shell nàyCài Git for Windows, hoặc kiểm tra rằng PowerShell có trong PATH
EBADENGINE trong lúc npm installNode.js cũ hơn bản 22Cậ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 CodeCodex CLI
Cập nhật ngayclaude update (gốc), winget upgrade Anthropic.ClaudeCode, hoặc chạy lại lệnh cài npmcodex 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ự độngchỉ với bản cài gốc, tắt bằng DISABLE_AUTOUPDATER=1không có trong tài liệu
Gỡ cài đặtxó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-codexó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.

Kỹ Sư DevOpsNgười Viết Nội DungNhà Phát Triển FrontendNhân Viên Kinh DoanhNhà Phát Triển BackendHuấn Luyện Viên & Đào TạoKiến Trúc Sư Phần MềmChuyên Viên Pháp ChếKỹ Sư QATài Chính & Hành ChínhNhà Phát Triển Full-StackNhà Thiết Kế Sáng TạoNhà Phát Triển Di ĐộngNhà Nghiên CứuKỹ Sư Bảo MậtNhân Sự & Tuyển Dụng
Quản Lý Dự ÁnBiên Dịch ViênChuyên Gia GitChuyên Viên Phân Tích Dữ LiệuChuyên Gia SEOKế ToánChuyên Gia Địa Phương HóaTruyền Thông & PRNgười Đưa Ra Ý TưởngVận Hành & LogisticsChuyên Gia Tiếp ThịChăm Sóc Khách HàngTrợ lý dự ánNhân Viên Mua HàngQuản Lý Cộng ĐồngTrợ Lý Cá Nhân

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.

Tải AgentsRoomMiễn phí

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

Tải tiện ích mở rộng
Chrome Web Store

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.

Giao diện hội thoại

Giao diện hội thoại AgentsRoom: công việc của một AI coding agent hiển thị như một luồng trò chuyện
Nhiều dự án
Đa nhà cung cấp
Nhiều agent
Trạng thái trực tiếp
File diff & commit
Ứng dụng đồng hành mobile
Xem trước trực tiếp
Đội agent
Tự động hóa trình duyệt
Dev theo backlog
Thư viện prompt
Thư viện skill
Xem tất cả tính năng

Đọc thêm