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 Code | Codex CLI | |
|---|---|---|
| Versi Windows | Windows 10 1809 atau lebih baru, Windows Server 2019 atau lebih baru | Windows 11 direkomendasikan, Windows 10 terbaru secara "best effort" |
| Prosesor | x64 atau ARM64, tidak pernah 32-bit | x64 atau ARM64 |
| Akun | Paket Claude berbayar atau akun Console | Paket ChatGPT atau API key OpenAI |
| Node.js | Hanya untuk jalur npm, versi 22 atau lebih baru | Hanya untuk jalur npm |
| Git for Windows | Opsional | Tidak diperlukan |
| Sandbox di Windows native | Tidak, hanya di WSL 2 | Ya, sandbox Windows miliknya sendiri |
| Hak admin untuk memasang | Tidak | Tidak |
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.
| Jalur | Perintah |
|---|---|
| PowerShell (direkomendasikan) | 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 |
Apa yang ditinggalkan setiap jalur:
- Installer native:
claude.exedi%USERPROFILE%\.local\bin, versi-versinya di%USERPROFILE%\.local\share\claude. Installer memperingatkan Anda jika.local\bintidak 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.
| Jalur | Perintah |
|---|---|
| Installer PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm 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 Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash di dalam WSL |
| Memasang Codex | installer PowerShell | curl -fsSL https://chatgpt.com/codex/install.sh | sh di dalam WSL |
| Sandbox Claude Code | tidak tersedia | tersedia, dengan bubblewrap dan socat |
| Sandbox Codex | sandbox Windows | sandbox Linux |
| Tempat menyimpan repositori | di mana saja | di 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:
- 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 denganExec format error. Konversi distribusi denganwsl --set-version <DistroName> 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. - 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 lihat | Penyebab | Solusi |
|---|---|---|
'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 Anda | Tambahkan ke PATH pengguna (perintah di bawah), lalu buka terminal baru |
| Masih tidak dikenali setelah ditambahkan | Terminal, atau editor yang membungkusnya, dibuka sebelum perubahan | Tutup dan buka kembali terminal, juga editornya jika terminal berada di dalamnya |
| Tidak dikenali tepat setelah pembaruan | Pembaruan yang terputus di tengah pertukaran file tidak menyisakan claude.exe | Ganti nama claude.exe.old.* yang paling baru kembali menjadi claude.exe (perintah di bawah) |
'irm' is not recognized | Anda menempelkan baris PowerShell ke CMD | Buka PowerShell, atau gunakan baris CMD |
The token '&&' is not a valid statement separator | Anda menempelkan baris CMD ke Windows PowerShell | Gunakan baris PowerShell |
npm.ps1 cannot be loaded because running scripts is disabled on this system | Kebijakan eksekusi memblokir shim PowerShell milik npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, atau panggil npm.cmd |
| Error tentang Windows 32-bit di PC 64-bit | Anda membuka "Windows PowerShell (x86)" dari menu Start | Buka PowerShell 64-bit yang biasa |
claude membuka aplikasi desktop, bukan CLI | Aplikasi desktop Claude versi lama menaruh Claude.exe di WindowsApps, mendahului CLI di PATH | Perbarui aplikasi desktop Claude |
requires either Git for Windows (for bash) or PowerShell | Claude Code tidak menemukan satu pun dari kedua shell itu | Pasang Git for Windows, atau pastikan PowerShell ada di PATH |
EBADENGINE saat npm install | Node.js lebih lama dari versi 22 | Perbarui 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 Code | Codex CLI | |
|---|---|---|
| Perbarui sekarang | claude update (native), winget upgrade Anthropic.ClaudeCode, atau pemasangan npm dijalankan ulang | codex update pada rilis yang mendukungnya, installer PowerShell dijalankan ulang, atau npm install -g @openai/codex |
| Pembaruan otomatis | hanya instalasi native, dimatikan dengan DISABLE_AUTOUPDATER=1 | tidak didokumentasikan |
| Menghapus | hapus %USERPROFILE%\.local\bin\claude.exe dan %USERPROFILE%\.local\share\claude, atau winget uninstall Anthropic.ClaudeCode, atau npm uninstall -g @anthropic-ai/claude-code | hapus 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.
Unduh AgentsRoom
Jalankan semua agen AI Anda, di semua proyek Anda, dari satu jendela.
Aplikasi pendamping: pantau agen Anda saat bepergian
Gunakan Claude, Codex, Antigravity CLI, atau penyedia AI lainnya.
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.

Lanjutkan membaca
Mode Suara di Codex, OpenCode, Antigravity, dan Claude Code: CLI Mana yang Punya?
Kami memeriksa lima CLI agen coding dan dua aplikasi pada 13 Oktober 2026. Codex CLI dan oh-my-pi bisa bercakap dengan suara, Claude Code dan Antigravity CLI hanya mendikte ke prompt, OpenCode tidak punya apa pun bawaan. Cara memulai masing-masing, ke mana audionya pergi, dan berapa biaya suara dalam token.
Baca artikelAgen Review Seharusnya Tidak Bisa Menulis. Begini Cara Kami Memberlakukannya, CLI demi CLI.
Dalam sebuah run 17 node, agen release mengedit sebuah tes untuk mengubah suite merah menjadi hijau, lalu dua agen review menulis perbaikan yang sama dan bertabrakan. Prompt-nya bilang: review saja. Tidak bertahan. Inilah insidennya, mengapa instruksi tertulis tidak bisa memikul aturan itu, dan flag persis yang membuat Claude Code, Codex, Grok, Antigravity, dan OpenCode menolak menulis.
Baca artikelCara Menghapus Co-Authored-By Claude dari Commit Git Anda
Claude Code menandatangani commit Anda dengan trailer Co-Authored-By dan pull request Anda dengan baris Generated with Claude Code. Pengaturan yang menghapusnya, file tempat menaruhnya, dan cara membersihkan commit yang sudah Anda push.
Baca artikel