Claude Media
Claude Code Windowsインストール — ネイティブとWSL、どちらを選ぶか

Claude Code Windowsインストール — ネイティブとWSL、どちらを選ぶか

Claude Code WindowsはPowerShellの1行でネイティブに入り、WSL2ならLinux用のインストーラーで入ります。サンドボックスが要るならWSL2、Windowsのツールで開発するならネイティブが合います。

Claude CodeはWindowsで2通りに動きます。PowerShellやCMDから入れるネイティブ版と、WSL2のLinuxの中に入れる版です。最短なら、PowerShellでirm https://claude.ai/install.ps1 | iexを実行し、新しいターミナルでclaudeと打ってログインするだけで使えます。

どちらを選ぶかで変わるのは、あとから使える機能です。コマンドを隔離するサンドボックスはWSL2でしか動きません。Windowsのツールで開発するならネイティブ、Linuxのツールで開発するかサンドボックスが要るならWSL2が合います。

Claude Code Windowsの動作要件と必要なプラン

インストール前に見るのは、OSの版・CPU・契約プランの3つです。

数字

Claude Code Windowsを動かす条件

  • OS

    Windows 10 1809以降

    Windows Server 2019以降も可

  • ハードウェア

    メモリ4GB以上

    x64またはARM64のCPU

  • Pro

    $20/月

    年払いは月$17(一括$200)

  • Max

    $100/月から

    Proの5倍か20倍の使用量

32ビット版のWindowsでは動きません

ログインにはPro・Max・Team・Enterpriseのいずれかのプランか、Consoleアカウントが要ります。無料プランにはClaude Codeが含まれません。Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry経由で使う方法もあります。使用量や従量課金との損得は、Claude Codeの料金の比較で見積もれます。

Claude Code Windowsはネイティブ版とWSL2版のどちらを選ぶか

分かれ目は、プロジェクトの置き場所とサンドボックスの要否です。

くらべる

ネイティブWindowsとWSL2の違い

PowerShell・CMDから導入

ネイティブWindows

  • 追加の準備は不要。Git for Windowsは任意
  • サンドボックスは使えない。コマンドは隔離なしで動く
  • Windowsのツールチェーンとパスをそのまま扱える
Linuxの中に導入

WSL2

  • WSL2の有効化が必要。Git for Windowsは不要
  • サンドボックスが使える(bubblewrapとsocatで隔離)
  • プロジェクトは/home側に置くと速い

WSL1も選択肢には並んでいますが、サンドボックスは使えません。最近のバイナリでは起動時にExec format errorが出る既知の不具合もあります(後述)。

性能の差は、ファイルの置き場所で出ます。

  1. 後輩

    WSL2に入れたら、Cドライブにあるいつものプロジェクトをそのまま開けばいいですよね?

  2. 先輩

    動きはするけど、/mnt/c/越しだと読み取りが遅くて、検索で見つかる件数が減ることがあるんだ。しかもclaude doctorはこの状態でも検索をOKと表示する。

  3. 後輩

    診断で気づけないんですか。じゃあどうすれば?

  4. 先輩

    プロジェクトをLinux側の/home/へ移すのが一番。Windows側に置いたまま使うなら、ネイティブ版で開けばファイルシステムをまたがずに済むよ。

ターミナルを使わずに操作したいなら、Desktopアプリという入口もあります。DesktopのCodeタブからは、WSL2の中でセッションを開くこともできます。

ネイティブWindowsでClaude Codeを始める3手順

管理者権限は要りません。PowerShellかCMDのどちらから入れても、入るものは同じです。

手順

ネイティブWindowsで使い始めるまで

  1. 1

    PowerShellかCMDを開く

    スタートメニューで「PowerShell」と検索して開きます。プロンプトの行頭がPS C:\ならPowerShell、C:\だけならCMDです。

  2. 2

    シェルに合うコマンドを1行実行する

    下のコマンドを貼り付けて実行します。ダウンロード中は進捗が表示されないので、終わるまで待ちます。

  3. 3

    新しいターミナルで確かめてログインする

    ウィンドウを開き直し、claude --versionでバージョン番号が出れば導入済みです。続けて作業フォルダーでclaudeと打ち、ブラウザーの案内に沿ってログインします。

PowerShellでは次の1行です。

irm https://claude.ai/install.ps1 | iex

CMDでは次のコマンドです。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

実行ファイルは%USERPROFILE%\.local\bin\claude.exeに置かれます。ネイティブ版はバックグラウンドで自動更新されます。

落とし穴

ウィンドウを開き直してもclaudeが見つからない

インストール先がPATHに入っていないときです。インストーラーは出力のSetup notes:にその旨を書き、直し方を示します。文言はNative installation exists but C:\Users\you\.local\bin is not in your PATH.です。ただしPATHそのものは書き換えません。メッセージを読み飛ばすと、何度開き直しても'claude' is not recognizedのままです。直し方は後半の切り分けの節にあります。

導入後の状態はclaude doctorで確かめられます。セッションを始めずに、インストールの状態・設定ファイルの検証エラー・警告と直し方を表示する読み取り専用の診断です。

バージョンやチャネルを選んで入れる

インストーラーには、チャネル(latestかstable)か、特定の版番号を渡せます。stableはおおむね1週間前のリリースで、大きな不具合が出たバージョンを飛ばします。PowerShellではirmの結果をスクリプトブロックにして引数を渡します。

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

CMDはinstall.cmdの後ろにstableや2.1.89を付けます。入れた後はclaude --versionが2.1.89 (Claude Code)のように指定どおりの番号を表示します。インストール時に選んだチャネルが、その後の自動更新の既定になります。

入れた後の切り替えはclaude installサブコマンドでもできます。v2.1.311のclaude install --helpは次の説明を返します。

Usage: claude install [options] [target]
 
Install Claude Code native build. Use [target] to specify version (stable,
latest, or specific version)
 
Options:
  --force     Force installation even if already installed
  -h, --help  Display help for command

WinGetで入れる

WinGetを使うなら次の1行です。curlを通らないので、curlの証明書失効確認で止まる環境の回避策にもなります。

winget install Anthropic.ClaudeCode

WinGet版は既定では自動更新されず、winget upgrade Anthropic.ClaudeCodeで更新します。settings.jsonのenvでCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEを1にする方法もあります。新しい版が出ると、Claude Codeがこのアップグレードを裏で実行します。ただしClaude Codeの実行中は実行ファイルがロックされて失敗することがあり、その場合は手で打つコマンドが表示されます。削除はwinget uninstall Anthropic.ClaudeCodeです。

複数台に配るなら、構成ファイルから一括で入れるwinget importの手順が使えます。

WSL2にClaude Codeを入れる手順

WSL2版は、Linuxのディストリビューション(Ubuntuなど)の中で入れて、その中で起動します。PowerShellやCMDから入れたものとは別のインストールになります。

手順

WSL2で使い始めるまで

  1. 1

    ディストリビューションがWSL2か確かめる

    PowerShellでwsl -l -vを実行し、VERSIONの列が2になっているかを見ます。1なら先にWSL2へ変換します。

  2. 2

    WSLのターミナルでLinux用のインストーラーを実行する

    Ubuntuなどのターミナルを開き、下のinstall.shを実行します。Git for Windowsは要りません。

  3. 3

    プロジェクトをLinux側に置いて起動する

    /home/配下のフォルダーでclaudeを起動します。ログインでブラウザーから戻れないときは、ブラウザーに出たコードをターミナルのPaste code here if promptedに貼り付けます。

curl -fsSL https://claude.ai/install.sh | bash

WSL2からブラウザーがまったく開かない場合は、BROWSER環境変数にWindows側のブラウザーのパスを入れてからclaudeを起動します。Windows Terminalで貼り付けが効かないときは、右クリックかShift+Insertで貼り付けるか、標準入力からコードを読むclaude auth loginを使います。

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

サンドボックスを使うには、ディストリビューションにbubblewrapとsocatを入れます。Ubuntuならsudo apt-get install bubblewrap socatです。Claude Codeを再起動して/sandboxを開くと、足りない依存がDependenciesタブに並びます。Sandboxing requires WSL2と出たら、そのディストリビューションはWSL1のままです。

Claude CodeをWSL2で使うでは、npmで入れてnode: not foundになる問題、Ubuntu 24.04のAppArmor設定、サンドボックスの細かな設定を扱います。隔離の方式をコンテナまで含めて選ぶなら、サンドボックスの選び方の6種類の比較が役立ちます。

WSL1でExec format errorが出たとき

WSLでclaudeを実行してcannot execute binary file: Exec format errorと出るなら、WSL1のままです。ネイティブバイナリのヘッダーが変わり、WSL1のローダーが読めなくなった既知の不具合です(anthropics/claude-codeのissue #38788)。

セットアップのページは、インストール方法の表でWSL1を「WSL2が使えない場合」の選択肢として並べています。一方でインストールのトラブルシューティングのページは、この不具合を載せています。表だけを見てWSL1を選ぶと、ここでつまずきます。

いちばん手早い直し方は、PowerShellでディストリビューションをWSL2へ変換することです。

wsl --set-version <DistroName> 2

WSL1に留まる必要がある場合は、WSL1のExec format errorの直し方でも扱う回避策として、WSL内の~/.bashrcに動的リンカー経由で呼ぶ関数を足します。追記したらsource ~/.bashrcで読み込み直します。

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

Git for Windowsの有無でシェルが変わる

ネイティブ版では、Git for Windowsを入れるかどうかで、Claude Codeがコマンドを実行するシェルが変わります。入れなくても動きますが、推奨はされています。

くらべる

Git for Windowsの有無とシェルツール

PowerShellツール

入れない場合

PowerShellツールが自動で有効になり、主なシェルになります。pwsh.exe(PowerShell 7以降)を探し、無ければpowershell.exe(5.1)を使います。

Bashツール+PowerShellツール

入れた場合

Git BashがBashツールになり、POSIXのスクリプトをそのまま回せます。ログの監視などに使うMonitorツールも、Git Bashを必要とします。PowerShellツールも並んで使えます。

Git Bashを入れた環境でPowerShellツールが並ぶかどうかは、認証の経路で既定が違います。claude.aiアカウントとConsoleアカウントでは既定で有効です。Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundryのセッションは別です。settings.jsonでCLAUDE_CODE_USE_POWERSHELL_TOOLを1にして有効にします。0にするとPowerShellツールが止まります。Git Bashが無い環境で0にすると使えるシェルがなくなり、後述のエラーで起動できません。

PowerShellツールには、知っておくと迷わない挙動がいくつかあります。

  • PowerShellのプロファイルは読み込まれず、Windowsではサンドボックスも使えない
  • -ExecutionPolicy Bypassをプロセス範囲だけに付けて起動するので、既定の実行ポリシーのままでも.ps1が動く。グループポリシーのMachinePolicy・UserPolicyは上書きしない。マシンの実効ポリシーに従わせるならCLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICYを1にする
  • Git Bashがある環境でBashを拒否するルールを書くと、PowerShellツールも止まる

古い解説で「Git for Windowsは必須」と書かれているのは、要件が途中で変わったためです。

あゆみ

Claude Code Windowsのシェルとインストールにかかわる変更

  1. 2026年3月26日v2.1.84でPowerShellツールがプレビュー公開

    当初は設定で有効にする方式でした。

  2. 2026年4月28日v2.1.120でGit for Windowsが不要に

    Git Bashが無いときはPowerShellをシェルツールとして使うようになりました。

  3. 2026年7月24日v2.1.219でGit Bashのパス指定を厳格化

    Git Bashを指すパスの名前が検査されるようになりました。

  4. 2026年9月23日v2.1.281で更新時のclaude.exe消失を修正

    同時に更新したセッション同士が互いのバックアップを消す競合を直しました。

  5. 2026年10月9日v2.1.296でShift-JISなどの編集を拒否

    非UTF-8のファイルの日本語が置き換わる不具合を、編集の拒否に変えました。

Git Bashを見つけられないとき

Git for Windowsを入れたのにGit Bashが使われない場合は、まず既定の探索順に照らして原因を絞ります。

手順

Git Bashの探索順(CLAUDE_CODE_GIT_BASH_PATH未設定のとき)

  1. 1

    既定のインストール先を見る

    C:\Program Files\GitとC:\Program Files (x86)\Gitのbash.exeを探します。

  2. 2

    PATH上のgitを見る

    PATH上のgitが属するGitのbin\bash.exeを使います。起動したフォルダーの中にあるgitや、その下のnode_modules・.venv・envの中にあるgitは対象外です。プロジェクトに置かれた実行ファイルを誤って走らせないための除外です。

  3. 3

    見つからなければパスを指定する

    PowerShellでwhere.exe gitを実行して場所を調べ、そのGitのbin\bash.exeをsettings.jsonに書きます。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

指定したのに効かないときは、ファイル名を見直します。

前と後

CLAUDE_CODE_GIT_BASH_PATHに書くファイル

BEFORE

ランチャーを指定して無視される

v2.1.219以降は、bash.exe・sh.exe・bash・sh以外の名前のファイルを指定すると、変数は無視されて自動検出に戻ります。Git for Windowsのランチャーgit-bash.exeが典型で、存在しないパスも同じ扱いです。--debugを付けて起動すると警告が出ます。

AFTER

bin配下のbash.exeを指定する

C:\Program Files\Git\bin\bash.exeのようにbin配下のbash.exeを書くと、そのGit Bashが使われます。

v2.1.219より前は、パスが存在しないとClaude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH pathで起動時に終了していました。名前が正しいのに使われない場合は、AppLockerやEDRがbash.exeを止めている可能性があります(企業環境の節)。scoopで入れたGitが見つからないときは、scoopのGit Bashの設定で切り分けられます。

Windowsで動かないときの切り分け

導入直後のつまずきは、ほぼPATH・シェル・権限・文字コードの4つに分かれます。上から順に確かめます。

切り分け

ネイティブWindowsで動かないときの確認順

  1. Q新しいターミナルでclaude --versionが番号を返す?
    答えがいいえのとき

    PATHの問題です。すぐ下のPowerShellの手順で、実行ファイルの有無とPATHを確かめて追加します。

    答えがはい
  2. Q起動時にGit for Windows or PowerShellのエラーが出ない?
    答えがいいえのとき

    使えるシェルが見つかっていません。PowerShellのフォルダーをPATHに足すか、PowerShell 7かGit for Windowsを入れます(下のエラー表)。

    答えがはい
  3. Qrunning scripts is disabledや32-bitのエラーが出ない?
    答えがいいえのとき

    npmが作る.ps1を実行ポリシーが止めているか、x86版のPowerShellを開いています。下の個別の節で対処します。

    答えがはい
  4. Q日本語のファイルを編集でき、文字化けもしない?
    答えがいいえのとき

    Shift-JISなど非UTF-8のファイルが対象です。下の文字コードの節で直します。

    答えがはい

導入は完了

claude doctorで警告が無いことを確かめて、作業を始めます。

PATHの確認は、PowerShellで実行ファイルの有無を見るところから始めます。Test-PathがFalseならネイティブ版は入っていないので、インストールからやり直します。Trueなのに2行目が何も表示しないなら、PATHに入っていません。

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
$env:PATH -split ';' | Select-String '\.local\\bin'

PATHに入っていなければ、ユーザーのPATHに追加します。追加は永続的なので1回で済みます。ターミナルを開き直してからclaude --versionで確かめます。

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

VS CodeなどエディターのターミナルはエディターからPATHを受け継ぐので、エディターごと終了して開き直します。CMDだけで作業する場合は、システムの環境変数の画面でユーザーのPATHに%USERPROFILE%\.local\binを足します。macOS・Linuxも含めて同じ症状を追うなら、command not found: claudeの直し方も参考になります。

エラー文言から原因を引く

Windowsのインストールで出る文言と原因の対応です。表に無い症状としては、defines.jsonのSyntax Errorがあります。

出た文言原因
irm is not recognized原因PowerShell用のコマンドをCMDで実行している
The token && is not a valid statement separator原因CMD用のコマンドをPowerShellで実行している
A parameter cannot be found that matches parameter name fsSL原因macOS・Linux用のcurl -fsSLをPowerShellで実行している。PowerShellではcurlがInvoke-WebRequestの別名
bash is not recognized原因macOS・Linux用のインストーラーをWindowsで実行している
スクリプトの本文が表示されるだけ原因irmだけを実行し、| iexを付けていない
System.Xml.XmlDocument is not recognized原因インストールスクリプトでなくWebページやXMLが返っている
Claude Code on Windows requires either Git for Windows (for bash) or PowerShell原因Git BashもPowerShellも見つからない
Claude Code does not support 32-bit Windows原因x86のPowerShellを開いている、または32ビット版Windows
CRYPT_E_NO_REVOCATION_CHECK / CRYPT_E_REVOCATION_OFFLINE原因証明書の失効確認先に届かない
The process cannot access the file原因前回の試行が残っているか、アンチウイルスがスキャン中
running scripts is disabled on this system原因npmが作る.ps1をPowerShellの実行ポリシーが止めている
'claude' is not recognized(更新直後)原因更新でclaude.exeが退避されたまま戻っていない

System.Xml.XmlDocumentの文言は、irmが返ってきた中身をXMLとして解釈したときに出ます。原因は地域の制限・プロキシ・一時的な障害で、install.ps1の切り分けで順に確かめられます。

Git BashもPowerShellも見つからない

次のエラーは、Git BashとPowerShellのどちらも見つからないときに出ます。

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

PowerShellのPATH漏れが原因なら、既定の場所である次のフォルダーをPATHに足します。

C:\Windows\System32\WindowsPowerShell\v1.0\

pwshを含むPowerShell 7を入れても解消します。Git for Windowsを入れる場合は、セットアップ中に「Add to PATH」を選び、終わったらターミナルを開き直します。

32ビットのPowerShellを開いている

スタートメニューにはPowerShellの入口が2つあります。64ビット機でも、x86と付く方は32ビットのプロセスとして動くため、インストールが失敗します。

画面

スタートメニューでPowerShellを選ぶ(模式図)

1
Windows PowerShell
2
Windows PowerShell (x86)

開くのは番号1の方です。番号2で32ビット非対応のエラーが出たら、同じウィンドウで[Environment]::Is64BitOperatingSystemを実行します。TrueならOSは64ビットなので、番号1を開き直して再実行します。FalseならOS自体が32ビット版で、Claude Codeは動きません。

TLS検証エラーで止まる

CRYPT_E_NO_REVOCATION_CHECKは、curlはサーバーに届いたのに、証明書の失効確認の問い合わせをネットワークが塞いでいる状態です。企業のファイアウォール配下でよく起きます。CMDでは、自分で実行するcurlに--ssl-revoke-best-effortを付けて再実行します。

curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

スクリプトが内部で行うダウンロードは、同じエラーなら自動でこの方式に切り替えて再試行します。この方式は失効確認先に届かなくても止まらず、失効が確定した証明書は拒否します。

.NET経由でダウンロードするPowerShellのインストーラーに切り替えても回避できます。curlを使わないWinGetでも入ります。PowerShell 5.1でCould not create SSL/TLS secure channelが出る場合は、同じウィンドウでTLS 1.2を有効にしてからインストーラーを実行します。

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Claude Desktopがclaudeコマンドを奪う

古いClaude Desktopアプリは、WindowsApps配下にClaude.exeを登録します。これがPATH上でClaude CodeのCLIより優先され、claudeと打つとDesktopアプリが起動します。Claude Desktopを最新版に更新すると解消します。

VS Code拡張だけではclaudeコマンドが無い

VS Code拡張は自分のチャット画面用のCLIを拡張フォルダーの中に持つだけで、PATHには足しません。拡張だけを入れた環境では%USERPROFILE%\.local\binにclaudeは作られません。ターミナルで使うには、別にネイティブ版を入れます。

更新直後にclaude.exeが消える

Windowsの更新は、既存のclaude.exeを別名に退避してから新しいファイルを置く順で進みます。差し替えにも退避の巻き戻しにも失敗すると、claude.exe.old.に数字のタイムスタンプが続くバックアップだけが残ります。最新のバックアップを元の名前に戻すのは、PowerShellの次の1行です。

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

バックアップが無いか、戻しても動かないときは、インストールコマンドを再実行します。v2.1.281より前は、claude.exeが無いままバックアップが消えることがありました。

npm経由でPowerShellの実行ポリシーに阻まれる

npmで入れた環境では、running scripts is disabled on this system(PSSecurityException)が出ることがあります。npmが作るnpm.ps1やclaude.ps1を、PowerShellの実行ポリシーが止めている状態です。対処は3つあります。

  • Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserで自分のユーザーだけ許可する
  • .ps1ではなくnpm.cmd・claude.cmdのランチャーを呼ぶ
  • npmをやめてネイティブのインストーラーに切り替える

実行ポリシーが対象にするのはスクリプトファイルです。irm ... | iexで実行するPowerShellのインストーラーそのものは止められません。

ダウンロードファイルをアンチウイルスが掴んで離さない

Failed to download binary: The process cannot access the fileは、書き込み先のフォルダーが使用中の状態です。場所は%USERPROFILE%\.claude\downloadsです。前回のインストールが残っているか、アンチウイルスが途中のファイルを調べています。他のPowerShellウィンドウを閉じ、スキャンが終わるのを待ってから、フォルダーを消して再実行します。

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

日本語のファイルが文字化けする・編集を断られる

Claude Codeのファイル編集は、保存をUTF-8で行います。Shift-JISやWindows-1252で保存された日本語ファイルを書き換えると読めない文字が混ざるため、v2.1.296以降は編集そのものを断ります。ファイル全体の書き直しは、読めなかった文字(U+FFFD)を含む内容なら断られます。含まなければ書き直せますが、保存はUTF-8になり元の文字コードは失われます。断られたときは、文字コードを保つシェルのコマンドで直させるか、先にUTF-8へ変換します。

PowerShellツールの側では、PowerShell 5.1でも>や>>のリダイレクトはUTF-8で書かれます。ネイティブコマンドの標準入力に渡す文字列もUTF-8です。古いツールがShift-JISを前提にしている場合は、ここで食い違いが出ます。

企業のWindows環境でClaude Codeを入れるときの注意

管理対象のデバイスでは、個人のPCとは別の壁に当たります。

管理対象デバイスで当たりやすい壁

  • AppLocker・グループポリシーのソフトウェア制限・EDRがclaude.exeや、そこから起動するcmd.exe・bash.exeを止めることがある。IT部門に許可リストへの登録を依頼する
  • TLS検査を行う社内プロキシの配下では、社内CAの証明書をWindowsの証明書ストアに入れてもらう。インストール後の本体にはNODE_EXTRA_CA_CERTSで同じ証明書を指定する
  • サンドボックスを必須にするfailIfUnavailableを全台に配ると、サンドボックスの無いネイティブWindowsではClaude Codeが起動時に終了する

最後の点は、配布の仕方で避けられます。macOSとLinuxにだけ管理設定を配るか、Windowsの利用者にはWSL2かコンテナで使ってもらう形です。

版の管理にかかわる設定は、効く強さが2段階あります。minimumVersionは自動更新とclaude updateが下限より古い版を入れないようにする設定で、どの設定ファイルにも書けます。起動そのものを止めるのは管理設定のrequiredMinimumVersionとrequiredMaximumVersionで、範囲外の版では起動を拒否します。

requiredMinimumVersionはv2.1.163以降で、管理設定に置いたときだけ効きます。ほかの場所に書くと警告なしに無視されます。確認は起動時だけなので、動いているセッションは止まりません。下限より古くてもclaude update・claude install・claude doctorは動くので、更新して復旧できます。

更新の経路そのものを止めたい場合は、DISABLE_AUTOUPDATERを1にすると裏での更新確認だけが止まります。claude updateやclaude installまで含めて止めるのはDISABLE_UPDATESです。自社の配布経路で版を固定する組織向けの設定です。権限まわりの設計は、個人・チーム・企業のレイヤー別にClaude Codeセキュリティ・権限ガイドが扱っています。

よくある質問

ARM64版のWindowsでも動きますか

動きます。システム要件はx64またはARM64のCPUで、npmの対応プラットフォームにもwin32-arm64があります。ただしARM64機ではclaude.exeが0xC0000005で落ちるクラッシュが報告されています。

Windows版とWSL2版で設定やMCPの構成は共有されますか

共有されません。WSL2の~はWindowsのユーザーフォルダーとは別のホームです。~/.claude配下の設定・許可済みツール・MCPサーバーの構成もそれぞれ独立します。両方使うなら、必要な設定を両方に用意します。

管理者は、Windowsの管理設定にwslInheritsWindowsSettings: trueを置くと、WSL側にもWindowsの管理ポリシーを読ませられます。この値はHKLMのレジストリかC:\Program Files\ClaudeCode\配下の管理設定に置いたときだけ効きます。

アンインストールはどうしますか

ネイティブ版は、PowerShellで実行ファイルとバージョンのファイルを消します。WinGetで入れた場合はwinget uninstall Anthropic.ClaudeCodeです。

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

設定とセッション履歴は%USERPROFILE%\.claudeと%USERPROFILE%\.claude.jsonにあり、消すと許可済みツールやMCPの構成も失われます。VS Code拡張・JetBrainsプラグイン・Desktopアプリが残っていると、次に起動したときこのフォルダーが作り直されます。

まとめ

ネイティブ版とWSL2版は別のインストールなので、サンドボックスが必要になった時点でWSL2側に入れ足す始め方もできます。まず試すだけなら、PowerShellの1行で済むネイティブ版から入れる手があります。

macOS・Linuxも含めた全体像ならClaude Codeのインストールガイド、エラーメッセージから引くならインストールエラーの切り分けチェックリストが入口です。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/setup
  2. code.claude.com/docs/ja/troubleshoot-install
  3. code.claude.com/docs/ja/sandboxing
  4. code.claude.com/docs/ja/tools-reference
  5. code.claude.com/docs/ja/settings-reference
  6. code.claude.com/docs/ja/desktop-wsl
  7. code.claude.com/docs/ja/troubleshooting
  8. code.claude.com/docs/en/changelog
  9. claude.com/ja/pricing
この記事を共有:XはてブLinkedIn