メインコンテンツへスキップ
見出し画像

Claude Codeをインストールできない原因と直し方|Windows診断表

    Windowsでインストールできないときは、画面に出た英語の一文から、公式が案内している直し方を引けます。

    コマンドを貼った場所と、コマンドの種類が合っていないだけ、という例が公式の一覧にいくつも載っています。

    正常なときの表示も実際に確かめて載せました。自分の画面と見比べてください。

    先に確認する3つ

    エラーの文を読む前に、次の3つだけ確かめます。ここで原因が分かることがあります。

    1. コマンドを貼ったのは、PowerShellとCMDのどちらか

    Windowsの黒い画面(ターミナル)にはPowerShellとCMDがあり、インストールのコマンドも別です。見分けは、入力欄の左に出る文字です。

    • 「PS C:\Users\…>」のようにPSで始まる → PowerShell

    • 「C:\Users\…>」のようにPSがない → CMD


    画像

    PowerShellで貼る1行は次のとおりです。

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

    CMDで貼る1行は次のとおりです。

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

    公式の説明では、管理者として実行する必要はありません。実行しても進み具合は表示されないので、終わったかどうかは新しいターミナルを開いて確かめます。

    claude --version

    バージョン番号が出れば成功です。

    2. Windowsが64ビットか

    PowerShellで次を実行します。

    [Environment]::Is64BitOperatingSystem

    Trueなら問題ありません。Falseの場合は32ビット版のWindowsで、Claude Codeは64ビットのOSが必要です。公式のシステム要件には、Windows 10の1809以上またはWindows Server 2019以上とも書かれています。

    3. ダウンロード元に届いているか

    インストーラーはdownloads.claude.aiから取得するので、そこに届くかを確かめます。次のコマンドをPowerShellで実行してください。curlではなくcurl.exeと書くのは、PowerShellのcurlが別の機能の別名で、このオプションを受け付けないためです。

    curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

    最初の行がHTTP/1.1 200 OKなら届いています。それ以外は次のとおりです。

    • 403:通常は、プロキシやネットワークフィルターが止めています。Claude Codeが使えない地域の場合もあるので、公式のサポート対象国も確かめます

    • 5xx:通常は一時的な不具合です。数分待ってやり直します

    • 何も出ない、Could not resolve host、タイムアウト:ネットワークが接続を止めています。原因の例は、会社のファイアウォールやプロキシ、地域的なネットワーク制限、TLS/SSLの問題です。地域的な制限なら、VPNや別の回線を試します

    画面の表示から探す診断表

    エラーの文をそのまま見比べてください。左が画面に出る表示、右が公式に載っている原因と直し方です。

    画像

    以降は、表の項目を原因ごとに詳しく書きます。「Native installation exists but … is not in your PATH」は「claudeが見つからない」と同じ対処です。「App unavailable in region」は対象外の国という意味で、公式のサポート対象国のページで確かめます。

    「'irm' is not recognized」などが出る:コマンドの種類が違う

    次のどれかが出たときは、別のターミナルや別のOS用のコマンドを貼ったか、コマンドの一部しか実行していません。公式の整理を、表示ごとに並べると次のとおりです。

    • 'irm' is not recognized:CMDにPowerShell用を貼っています。スタートメニューで「PowerShell」を検索して開き直し、PowerShell用の1行を実行します。CMDのまま進めたいときは、CMD用の1行を使います。

    • The token '&&' is not a valid statement separator:PowerShellにCMD用を貼っています。PowerShell用の1行に差し替えます。

    • A parameter cannot be found that matches parameter name 'fsSL':macOSとLinux用のcurlのコマンドをPowerShellで実行しています。PowerShellでは、curlが別の機能の別名で、-fsSLを受け付けません。PowerShell用の1行で実行し直します。

    • 'bash' is not recognized as the name of a cmdlet:macOSとLinux用のコマンドをWindowsで実行しています。PowerShell用の1行を実行します。

    • 何もインストールされず、長い文章が表示される:ダウンロードだけして、実行する部分が抜けています。「irm」から始まる1行の途中で止めずに、最後の「| iex」まで付けて実行します。CMDで、install.cmdを保存せずに表示だけされたときも、末尾の「-o install.cmd」以降まで付けた全文で実行します。

    どれも、直したあとは新しいターミナルを開いてclaude --versionを実行して確かめます。

    インストールは終わったのに「claude」が見つからない

    「'claude' is not recognized」と出るのに、インストール自体は終わっているときは、インストール先のフォルダがPATHに入っていません。PATHは、黒い画面がプログラムを探しに行くフォルダの一覧です。公式では、Windowsの置き場所は %USERPROFILE%\.local\bin\claude.exeと書かれています。

    PowerShellで、手順を3つに分けて確かめます。

    1つめ。プログラムがあるかを確かめます。

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

    Falseなら、公式のインストーラーで入れたプログラムがありません。npmやWinGetで入れた覚えがなければ、先ほどのPowerShell用の1行で入れ直します。Trueなら次へ進みます。

    2つめ。フォルダがPATHにあるかを確かめます。

    $env:PATH -split ';' | Select-String '\.local\\bin'

    C:\Users\(ユーザー名)\.local\binのように1行出れば、PATHに入っています。何も出なければ、次の2行を実行してユーザーのPATHに足してください。

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

    3つめ。ターミナルを開き直して、claude --versionを実行します。

    それでも見つからないときは、VS Codeなどエディターの中のターミナルを使っていないかを見ます。エディターの中のターミナルは、エディターを開いた時点のPATHを引き継ぐため、エディターを閉じて開き直してください。

    CMDで確かめるときは、同じ確認をdir "%USERPROFILE%\.local\bin\claude.exe" とecho %PATH% | findstr /i "local\bin" でできます。PATHに足すときは、システム設定の「環境変数」を開いて、ユーザーのPATHに %USERPROFILE%\.local\binを加えます。

    手元のWindows 11で確かめた、各コマンドの正常なときの表示

    ここまでのコマンドと、PATH上でclaudeが見つかる場所を表示するwhere.exe claudeを、Claude Codeが入っている手元のPCで実行しました。自分の画面と見比べるための記録です。

    画像
    • 日付は2026年10月18日。OSはWindows 11 Home、PowerShellは5.1です

    • Is64BitOperatingSystemはTrue

    • Test-PathはTrue

    • PATHの確認では、C:\Users\(ユーザー名)\.local\binが1行出ました

    • where.exe claudeは、.local\binのclaude.exeを指しました

    • claude --versionは2.1.178 (Claude Code)でした

    • curl.exeの最初の行はHTTP/1.1 200 OKでした

    バージョン番号は、入っているバージョンによって変わります。見るのは、番号が出るかどうかです。この記録は1台のPCの結果で、別の環境では表示が違うことがあります。

    途中で止まる:32ビット・ファイルが使用中・シェルが見つからない

    「Claude Code does not support 32-bit Windows」

    Windowsのスタートメニューには、PowerShellが2つあります。「Windows PowerShell」と「Windows PowerShell (x86)」です。x86のほうは32ビットのプロセスで動くので、64ビットのPCでもこのエラーが出ます。ウィンドウを閉じて、x86と付いていないほうを開き、同じコマンドを実行します。先ほどのIs64BitOperatingSystemがFalseなら32ビット版のWindowsで、この方法は使えません。

    「The process cannot access the file … because it is being used by another process」

    インストーラーが %USERPROFILE%\.claude\downloadsに書き込めなかったときの表示です。前回のインストールがまだ動いているか、ウイルス対策ソフトがダウンロード中のファイルを調べている間に起きます。公式の手順は次のとおりです。

    1. インストーラーを動かしている他のPowerShellを閉じ、ウイルス対策のスキャンが終わるまで待つ

    2. downloadsフォルダを消して、もう一度インストールする

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

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

    Git for Windowsは必須ではありません。Claude Codeは、Git BashがなければPowerShellを使います。このエラーは、どちらも見つからなかったという意味です。公式が挙げる直し方は、主に次の2つです。

    • PowerShellが見つからないなら、フォルダC:\Windows\System32\WindowsPowerShell\v1.0\ をPATHに加える(PowerShell 7を入れる方法もあります)

    • Git for Windowsを入れる(git-scm.com/downloads/win)。セットアップで「Add to PATH」を選び、入れ終わったらターミナルを開き直す

    npmで入れて「running scripts is disabled on this system」が出る

    npmでインストールしたり、動かしたりしたときに出ることがある表示です。PowerShell用のインストーラーでは起きません。PowerShellの実行ポリシーが、npmが作る .ps1のファイルを止めています。公式が挙げる直し方は3つです。

    • 自分のPCで作ったスクリプトの実行を許可する(Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser)

    • npmとclaudeを、.ps1ではなく .cmdのほうで呼ぶ(npm.cmd、claude.cmd)

    • npmをやめて、上のPowerShell用のインストーラーを使う(.ps1ではなく実行ファイルが入る)

    公式が挙げるのは以上の3つです。このうちPowerShell用の1行で入れる方法は、実行ポリシーの設定を変えずに済みます。

    更新したあとに消えた、またはデスクトップアプリが開く

    更新の直後に「'claude' is not recognized」と出る

    .local\binにclaude.exeがあるかを確かめます。公式によると、Windowsでは更新のときに、古いclaude.exeがclaude.exe.old.(数字)という名前のバックアップになります。更新が途中で失敗すると、claude.exeがなくなってバックアップだけが残ることがあります。その場合は、PowerShellで次を実行します。いちばん新しいバックアップがclaude.exeに戻ります。

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

    claude.exe.oldの付いたファイルが無いとき、または戻したあとも動かないときは、再インストールします。

    claudeと打つとデスクトップアプリが開く

    古いバージョンのClaude Desktopが、コマンドより先に見つかる場所へ登録されている場合です。公式の対処は、Claude Desktopを最新にすることです。

    直ったかの確認と、それでも直らないとき

    新しいターミナルでclaude --versionを実行し、バージョン番号が出れば直っています。

    それでも直らないときは、公式ページの最後に3つの案内があります。

    • claude --versionが動くのに別の不具合があるなら、claude doctorを実行して診断レポートを出す

    • OSと実行したコマンドと、エラーの全文を添えて、公式のGitHubに報告する

    • ログインのループや、契約が認識されないなど、アカウントの問題ならAnthropicのサポートに連絡する

    黒い画面を使いたくないときは、公式がデスクトップアプリ(Claude Code Desktop)も案内しています。コマンドなしで始められます。

    公式の案内は、Claude Code Docsの「インストールとログインのトラブルシューティング」を、2026年10月18日に確認しました。画面の表示や直し方は更新されることがあるので、直らないときは公式ページの最新も見てください。

     
     
    プログラミングの経験がない人が、AIでゲームを作り始めるときに最初に詰まる所を、1記事1つの困りごとで扱います。道具を入れる、画面を開く、最初の1本を動かす、まで。手順は実際に動かして確かめた範囲だけを書き、料金や仕様は公式で確認した日付を付けます。

    あなたへのおすすめ