Cara Memasang Claude Code dan Codex CLI di Windows

Perintah PowerShell, CMD, WinGet, dan npm yang tepat untuk memasang Claude Code dan Codex CLI di Windows 10 dan 11, kapan memilih WSL, dan cara mengatasi 'claude is not recognized' serta error lain yang akan Anda temui.

Kedua CLI kini bisa dipasang di Windows dengan satu baris perintah. Sebagian besar masalah justru muncul setelah baris itu: terminal yang tidak menemukan perintahnya, kebijakan eksekusi (execution policy) yang memblokir npm, distribusi WSL 1 yang sudah tua, perintah yang ditempel di shell yang salah. Panduan ini memberikan perintah yang tepat untuk setiap jalur pemasangan, lalu error-error yang muncul beserta cara mengatasinya.

Fakta tentang kedua CLI diambil dari dokumentasi Anthropic dan OpenAI serta dari skrip installer-nya sendiri, dibaca pada 16 November 2026, dengan Claude Code 2.1.318 dan Codex CLI 0.169.0. Kedua alat ini berubah cepat: jika sebuah perintah di bawah gagal, periksa halaman resmi yang ditautkan di setiap bagian.

Jawaban singkatnya. Buka PowerShell, bukan CMD, lalu jalankan:

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

Lalu buka terminal baru dan jalankan claude --version dan codex --version. Jika Windows menjawab bahwa claude tidak dikenali, cara memperbaiki PATH ada di tabel error lebih ke bawah.

Yang dibutuhkan setiap CLI di Windows

Claude CodeCodex CLI
Versi WindowsWindows 10 1809 atau lebih baru, Windows Server 2019 atau lebih baruWindows 11 direkomendasikan, Windows 10 terbaru secara "best effort"
Prosesorx64 atau ARM64, tidak pernah 32-bitx64 atau ARM64
AkunPaket Claude berbayar atau akun ConsolePaket ChatGPT atau API key OpenAI
Node.jsHanya untuk jalur npm, versi 22 atau lebih baruHanya untuk jalur npm
Git for WindowsOpsionalTidak diperlukan
Sandbox di Windows nativeTidak, hanya di WSL 2Ya, sandbox Windows miliknya sendiri
Hak admin untuk memasangTidakTidak

Dua baris di tabel ini sering mengejutkan orang. Claude Code tidak lagi mewajibkan Git for Windows: tanpanya, ia memakai PowerShell sebagai alat shell. Dan Codex menjalankan perintah di dalam sandbox di Windows native, sedangkan Claude Code hanya melakukannya di dalam WSL 2.

Memasang Claude Code di Windows

Halaman setup Anthropic mencantumkan empat jalur. Installer native adalah yang direkomendasikan: tidak butuh Node.js dan memperbarui dirinya sendiri di latar belakang.

JalurPerintah
PowerShell (direkomendasikan)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

Apa yang ditinggalkan setiap jalur:

  • Installer native: claude.exe di %USERPROFILE%\.local\bin, versi-versinya di %USERPROFILE%\.local\share\claude. Installer memperingatkan Anda jika .local\bin tidak ada di PATH Anda, dan ia tidak menambahkannya untuk Anda.
  • WinGet: tidak ada pembaruan otomatis. Anda memperbarui dengan winget upgrade Anthropic.ClaudeCode, dan Anthropic mencatat bahwa pembaruan bisa gagal saat Claude Code sedang berjalan, karena Windows mengunci file executable-nya.
  • npm: dengan Node.js yang lebih lama dari versi 22, pemasangan berakhir dengan peringatan EBADENGINE.

Untuk tetap satu rilis di belakang yang terbaru, di kanal stable:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Lalu periksa hasil pemasangan. claude --version menampilkan versinya, dan claude doctor menjalankan diagnosis baca-saja atas instalasi dan pengaturannya.

Jika Anda punya Git for Windows, Claude Code mencari Git Bash di C:\Program Files\Git, lalu C:\Program Files (x86)\Git, lalu git yang ada di PATH Anda. Untuk memaksa yang lain, atur CLAUDE_CODE_GIT_BASH_PATH di blok env pada settings.json Anda. Nilainya harus menunjuk ke file bernama bash.exe atau sh.exe, bukan git-bash.exe.

Memasang Codex CLI di Windows

Halaman Windows OpenAI jelas: secara default gunakan Codex secara native dengan sandbox Windows-nya, dan pilih WSL jika tooling Anda memang sudah berada di Linux. Ada satu sumber yang tertinggal: halaman instalasi di repositori GitHub masih menulis "Windows 11 via WSL2". Dokumentasi resmi sudah berubah, begitu juga installer-nya.

JalurPerintah
Installer PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

Installer PowerShell adalah yang paling mudah. Membaca skripnya menunjukkan apa yang dilakukannya: ia memasang Codex di %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, menambahkan folder itu ke PATH pengguna Anda dan ke sesi saat ini, lalu meminta Anda membuka jendela PowerShell baru. Menjalankan perintah yang sama sekali lagi akan memperbarui Codex. Dengan npm, Anda memperbarui dengan menjalankan ulang perintah pemasangan.

Lalu login. Jalankan codex dan pilih Sign in with ChatGPT, atau jalankan codex login. Di mesin tanpa browser, codex login --device-auth memberi Anda kode untuk diketik di perangkat lain. codex login status memberi tahu Anda sedang login sebagai siapa.

Sandbox Windows

Codex punya tiga implementasi sandbox di Windows:

  • mxc: yang direkomendasikan, tanpa setup admin. Butuh Windows 11 24H2 (build 26100.9278) atau 25H2 (build 26200.9278).
  • elevated: cadangan yang diutamakan. Butuh setup satu kali yang disetujui administrator.
  • unelevated: isolasi jaringan lebih lemah, dan tanpa path baca-saja.

Anda memilihnya di config.toml:

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

Jika sandbox gagal dengan error 1385, Windows menolak tipe login akun sandbox. Dalam kasus itu OpenAI meminta CODEX_HOME/.sandbox/sandbox.log. Jangan pernah membagikan isi .sandbox-secrets/.

Windows native atau WSL?

Native (PowerShell, CMD)WSL 2
Memasang Claude Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash di dalam WSL
Memasang Codexinstaller PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh di dalam WSL
Sandbox Claude Codetidak tersediatersedia, dengan bubblewrap dan socat
Sandbox Codexsandbox Windowssandbox Linux
Tempat menyimpan repositoridi mana sajadi bawah ~/, bukan di bawah /mnt/c/

Pilih WSL 2 jika proyek Anda memang di-build dan dijalankan di Linux, atau jika Anda ingin Claude Code menjalankan perintahnya di dalam sandbox. Tetaplah native jika proyek Anda adalah proyek Windows: .NET, skrip PowerShell, path Windows di mana-mana.

Tiga aturan jika Anda memilih jalur WSL:

  1. WSL 2, jangan pernah WSL 1. Codex berhenti mendukung WSL 1 sejak versi 0.115. Sandbox Claude Code menolak WSL 1 dengan Sandboxing requires WSL2, dan pemasangan di WSL 1 bisa gagal dengan Exec format error. Konversi distribusi dengan wsl --set-version <DistroName> 2.
  2. Pasang dan jalankan di dalam WSL. Jalankan perintah Linux di terminal WSL, bukan di terminal PowerShell. Memanggil Node.js milik Windows dari WSL adalah penyebab exec: node: not found: pasang Node.js di dalam distribusi itu sendiri, dengan package manager-nya atau nvm.
  3. Simpan kode di sistem file Linux. Kedua vendor menyarankan agar repositori disimpan di luar /mnt/c/, dan Anthropic mencatat bahwa pencarian Claude Code di sana kurang lengkap. Clone di bawah folder home Linux Anda.

"claude is not recognized" dan error lainnya

Yang Anda lihatPenyebabSolusi
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin tidak ada di PATH AndaTambahkan ke PATH pengguna (perintah di bawah), lalu buka terminal baru
Masih tidak dikenali setelah ditambahkanTerminal, atau editor yang membungkusnya, dibuka sebelum perubahanTutup dan buka kembali terminal, juga editornya jika terminal berada di dalamnya
Tidak dikenali tepat setelah pembaruanPembaruan yang terputus di tengah pertukaran file tidak menyisakan claude.exeGanti nama claude.exe.old.* yang paling baru kembali menjadi claude.exe (perintah di bawah)
'irm' is not recognizedAnda menempelkan baris PowerShell ke CMDBuka PowerShell, atau gunakan baris CMD
The token '&&' is not a valid statement separatorAnda menempelkan baris CMD ke Windows PowerShellGunakan baris PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemKebijakan eksekusi memblokir shim PowerShell milik npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, atau panggil npm.cmd
Error tentang Windows 32-bit di PC 64-bitAnda membuka "Windows PowerShell (x86)" dari menu StartBuka PowerShell 64-bit yang biasa
claude membuka aplikasi desktop, bukan CLIAplikasi desktop Claude versi lama menaruh Claude.exe di WindowsApps, mendahului CLI di PATHPerbarui aplikasi desktop Claude
requires either Git for Windows (for bash) or PowerShellClaude Code tidak menemukan satu pun dari kedua shell ituPasang Git for Windows, atau pastikan PowerShell ada di PATH
EBADENGINE saat npm installNode.js lebih lama dari versi 22Perbarui Node.js, atau gunakan installer native

Perbaikan PATH, di PowerShell, untuk pengguna saat ini, tanpa hak admin:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Untuk memeriksa di mana Windows mencari sebelum Anda mengubah apa pun:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude

Penggantian nama setelah pembaruan yang rusak:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Soal kebijakan eksekusi: Windows PowerShell 5.1, yang bawaan Windows, secara default disetel ke Restricted di PC klien, itulah sebabnya laptop baru memblokir npm.ps1. Cakupan CurrentUser tidak butuh hak admin. Installer native Claude dan installer Codex tidak terpengaruh: irm | iex dan -ExecutionPolicy ByPass tidak pernah memuat file skrip dari disk.

Memperbarui dan menghapus

Claude CodeCodex CLI
Perbarui sekarangclaude update (native), winget upgrade Anthropic.ClaudeCode, atau pemasangan npm dijalankan ulangcodex update pada rilis yang mendukungnya, installer PowerShell dijalankan ulang, atau npm install -g @openai/codex
Pembaruan otomatishanya instalasi native, dimatikan dengan DISABLE_AUTOUPDATER=1tidak didokumentasikan
Menghapushapus %USERPROFILE%\.local\bin\claude.exe dan %USERPROFILE%\.local\share\claude, atau winget uninstall Anthropic.ClaudeCode, atau npm uninstall -g @anthropic-ai/claude-codehapus folder instalasi, atau npm uninstall -g @openai/codex
Pengaturan yang tertinggal%USERPROFILE%\.claude dan %USERPROFILE%\.claude.json%USERPROFILE%\.codex

Yang kami pelajari dari menjalankan CLI agen di Windows

AgentsRoom menjalankan Claude Code, Codex, dan CLI agen lainnya berdampingan, dan versi Windows-nya mengajari kami di mana pemasangan ini rusak begitu keluar dari terminal. Empat hal ini layak diketahui walaupun Anda tidak pernah memakai aplikasi kami.

Program yang dibuka dari menu Start tetap memakai PATH saat ia dimulai. Anda memasang Claude Code, menambahkan .local\bin ke PATH, dan aplikasi desktop yang sudah terbuka tetap tidak menemukan claude. Me-restart terminal tidak cukup untuk aplikasi yang menjalankan CLI atas nama Anda. AgentsRoom membaca ulang PATH pengguna dan PATH mesin dari registry setiap kali mencari CLI, sehingga pemasangan yang baru saja berhasil tidak dilaporkan sebagai tidak ada.

npm tidak memasang .exe. npm install -g @openai/codex menulis tiga file ke %APPDATA%\npm: codex, codex.cmd, dan codex.ps1. Program yang menjalankan codex secara langsung mendapat spawn codex ENOENT, karena Windows hanya menambahkan .exe ke nama tanpa ekstensi. Terminal Anda menyembunyikan hal ini, karena PowerShell dan CMD membaca PATHEXT. Ini satu alasan lagi untuk memilih installer native, yang memang menyediakan executable.

Shim npm butuh Node.js saat dijalankan. Jika Anda memasang Node.js lalu sebuah CLI dalam sesi yang sama, shim .cmd ditemukan tetapi gagal dengan "node is not recognized" di program mana pun yang dibuka sebelum Node.js ada di PATH. Gejala yang sama terjadi dengan version manager Node yang shim-nya menunjuk ke versi yang sedang tidak aktif.

Memulai proses jauh lebih mahal di Windows. Kami mengukur 20 sampai 80 ms untuk membuat sebuah proses di Windows, dibandingkan 1 sampai 3 ms di macOS, dan setiap pemeriksaan file lebih mahal karena antivirus memeriksanya. Deteksi CLI pertama kami mencoba setiap folder, nama, dan ekstensi, dan membuat aplikasi membeku hingga satu detik di Windows. Membaca setiap folder sekali saja sudah memperbaikinya.

Di aplikasi, Asisten pemasangan memasang CLI yang belum ada dengan installer resmi dari vendornya untuk OS Anda (irm https://claude.ai/install.ps1 | iex untuk Claude Code, skrip OpenAI untuk Codex), beralih ke npm jika skrip gagal, dan menjalankannya di terminal yang bisa Anda pantau. Jika sebuah CLI tidak mau berjalan, CLI Doctor membaca error dan perintah persisnya, lalu memberi tahu Anda apa yang rusak. Begitu kedua CLI menjawab --version, panduan memulai akan membawa Anda melanjutkan, dan catatan rilis Windows menjelaskan apa yang dilakukan aplikasi ini di Windows.

Pertanyaan yang sering diajukan

Bagaimana cara memasang Claude Code di Windows?

Buka PowerShell lalu jalankan irm https://claude.ai/install.ps1 | iex. Di CMD, gunakan baris install.cmd dari halaman setup Anthropic, dan dengan WinGet jalankan winget install Anthropic.ClaudeCode. Binary-nya ditaruh di %USERPROFILE%\.local\bin, folder yang tidak ditambahkan installer ke PATH Anda: tambahkan sendiri jika claude tidak dikenali, lalu buka terminal baru dan jalankan claude --version.

Apakah saya butuh WSL untuk menjalankan Claude Code atau Codex di Windows?

Tidak. Keduanya berjalan native di PowerShell atau CMD pada Windows 10 dan 11. WSL 2 layak dipakai jika proyek Anda memang sudah berada di Linux, atau jika Anda ingin sandbox Claude Code, yang tidak berjalan di Windows native. Gunakan WSL 2, bukan WSL 1: Codex menghentikan dukungan WSL 1 sejak versi 0.115.

Mengapa Windows bilang 'claude' tidak dikenali tepat setelah dipasang?

Installer native menaruh claude.exe di %USERPROFILE%\.local\bin dan menampilkan peringatan jika folder itu tidak ada di PATH Anda, tetapi ia tidak mengubah PATH sendiri. Tambahkan folder itu ke PATH pengguna Anda, lalu tutup dan buka kembali terminal, juga editornya jika terminal berjalan di dalamnya. Terminal yang sudah terbuka sebelumnya tetap memakai PATH lamanya.

Apakah Claude Code membutuhkan Git for Windows?

Tidak lagi. Halaman setup Anthropic mencantumkan Git for Windows sebagai opsional: tanpanya, Claude Code memakai PowerShell sebagai alat shell. Dengannya, Claude Code menemukan Git Bash di C:\Program Files\Git, dan Anda bisa menunjuk bash.exe lain lewat pengaturan CLAUDE_CODE_GIT_BASH_PATH.

Bisakah memasang Codex CLI di Windows tanpa Node.js?

Bisa. Installer PowerShell dari OpenAI mengunduh Codex mandiri, menaruhnya di %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, dan menambahkan folder itu ke PATH pengguna Anda. Hanya jalur npm, npm install -g @openai/codex, yang membutuhkan Node.js.

Sebaiknya pakai PowerShell atau CMD untuk memasangnya?

PowerShell. Kedua perintah satu baris resmi adalah perintah PowerShell, dan error yang paling sering ditemui berasal dari menempelkan baris PowerShell ke CMD atau sebaliknya: 'irm' is not recognized berarti Anda berada di CMD, dan '&&' is not a valid statement separator berarti Anda berada di PowerShell. Gunakan PowerShell 64-bit, bukan entri "Windows PowerShell (x86)" di menu Start.

Insinyur DevOpsPenulisPengembang FrontendTenaga PenjualanPengembang BackendCoach & PelatihArsitek Perangkat LunakPenasihat HukumInsinyur QAKeuangan & AdministrasiPengembang Full-StackDesainer KreatifPengembang MobilePenelitiInsinyur KeamananSDM & Rekrutmen
Manajer ProyekPenerjemahAhli GitAnalis DataSpesialis SEOAkuntanSpesialis LokalisasiKomunikasi & HumasPemikir KreatifOperasional & LogistikSpesialis PemasaranLayanan PelangganAsisten proyekStaf PengadaanManajer KomunitasAsisten Pribadi

Unduh AgentsRoom

Jalankan semua agen AI Anda, di semua proyek Anda, dari satu jendela.

Unduh AgentsRoomGratis

Aplikasi pendamping: pantau agen Anda saat bepergian

Gunakan Claude, Codex, Antigravity CLI, atau penyedia AI lainnya.

Dapatkan ekstensi
Chrome Web Store

Kirim bug dan permintaan langsung ke backlog publik Anda.

Agen yang dibaca seperti percakapan

Setiap agen punya peran, wajah, dan utas yang Anda baca seperti aplikasi pesan.

Tampilan percakapan

Tampilan percakapan AgentsRoom: pekerjaan agen AI coding ditampilkan sebagai utas obrolan
Beberapa proyek
Multi-penyedia
Beberapa agen
Status langsung
File diff & commit
Pendamping mobile
Pratinjau langsung
Tim agen
Otomatisasi browser
Dev berbasis backlog
Pustaka prompt
Pustaka skill
Lihat semua fitur

Lanjutkan membaca