インストールとログインのトラブルシューティング

Claude Code のインストールまたはサインイン時に、コマンドが見つからない、PATH、権限、ネットワーク、認証エラーを修正します。

インストールが失敗した場合、またはサインインできない場合は、以下からエラーを見つけてください。Claude Code が動作している場合のランタイム問題については、トラブルシューティングを参照してください。設定が適用されない、またはフックが発火しないなどの設定の問題については、設定をデバッグするを参照してください。

エラーを見つける

表示されているエラーメッセージまたは症状を修正方法と照合してください：

問題がリストに記載されていない場合は、以下の診断チェックを実行して、原因を特定してください。

診断チェックを実行する

ネットワーク接続を確認する

インストーラーは downloads.claude.ai からダウンロードします。到達可能であることを確認してください：

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

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

最初の行が 200 ステータスを表示している場合、サーバーに到達しました。macOS と Linux では HTTP/2 200 が表示され、Windows に含まれる curl.exe からは HTTP/1.1 200 OK が表示されます。その他の結果は原因を示しています：

• 403：通常、プロキシまたはネットワークフィルターがホストをブロックしているか、Claude Code がお客様の地域では利用できません
• 5xx：通常、一時的なサービスの問題です。数分待ってから再試行してください

出力がない、Could not resolve host、または接続タイムアウトが表示される場合、ネットワークが接続をブロックしています。一般的な原因：

• downloads.claude.ai をブロックしている企業ファイアウォールまたはプロキシ
• 地域的なネットワーク制限：VPN または別のネットワークを試してください
• TLS/SSL の問題：システムの CA 証明書を更新するか、HTTPS_PROXY が設定されているかどうかを確認してください

企業プロキシの背後にいる場合は、インストール前に HTTPS_PROXY と HTTP_PROXY をプロキシのアドレスに設定してください。プロキシ URL がわからない場合は IT チームに問い合わせるか、ブラウザのプロキシ設定を確認してください。

この例は両方のプロキシ変数を設定してから、プロキシを通じてインストーラーを実行します：

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

PATH を確認する

インストールが成功しても、claude を実行するときに command not found または not recognized エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では ~/.local/bin/claude に、Windows では %USERPROFILE%\.local\bin\claude.exe に claude を配置します。

インストールディレクトリが PATH に含まれているかどうかを確認するには、PATH エントリをリストして local/bin でフィルタリングしてください：

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

claude --version

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

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

claude --version

echo %PATH% | findstr /i "local\bin"

claude --version

競合するインストールを確認する

複数の Claude Code インストールはバージョンの不一致または予期しない動作を引き起こす可能性があります。インストールされているものを確認してください：

which -a claude

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

where.exe claude

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

複数のインストールが見つかった場合は、1 つだけを保持してください。macOS/Linux の ~/.local/bin/claude または Windows の %USERPROFILE%\.local\bin\claude.exe でのネイティブインストールが推奨されます。余分なものを削除してください：

npm グローバルインストールをアンインストールします：

npm uninstall -g @anthropic-ai/claude-code

レガシーローカル npm インストールを削除します：

rm -rf ~/.claude/local

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

macOS で Homebrew インストールを削除します。claude-code@latest cask をインストールした場合は、その名前に置き換えてください：

brew uninstall --cask claude-code

Windows で WinGet インストールを削除します：

winget uninstall Anthropic.ClaudeCode

ディレクトリ権限を確認する

インストーラーは macOS と Linux の ~/.local/bin/ と ~/.claude/ への書き込みアクセスが必要です。Windows ではインストール場所は %USERPROFILE% の下にあり、デフォルトではユーザーが書き込み可能なため、このセクションはそこではほとんど適用されません。

ディレクトリが書き込み可能かどうかを確認してください：

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

いずれかのディレクトリが書き込み可能でない場合は、インストールディレクトリを作成し、ユーザーを所有者として設定してください：

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

バイナリが機能することを確認する

claude --version がバージョンを出力しても claude がクラッシュまたはハングする場合は、これらのチェックを実行して原因を特定してください。claude --version がコマンドが見つからないと言う場合は、最初に PATH を確認するに移動してください。以下のコマンドは claude が PATH にあることを前提としています。

バイナリが存在し、実行可能であることを確認してください：

ls -la "$(command -v claude)"

Get-Command claude | Select-Object Source

Linux では、不足している共有ライブラリを確認してください。ldd が不足しているライブラリを表示する場合は、システムパッケージをインストールする必要があるかもしれません。Alpine Linux およびその他の musl ベースのディストリビューションについては、Alpine Linux セットアップを参照してください。

ldd "$(command -v claude)" | grep "not found"

バイナリが実行できることを確認してください：

claude --version

一般的なインストール問題

これらは最も頻繁に遭遇するインストール問題とその解決策です。

インストールスクリプトがシェルスクリプトではなく HTML を返す

インストールコマンドを実行するときに、次のいずれかのエラーが表示される場合があります：

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

PowerShell では、同じ問題は解析エラーとして表示され、iex が HTML と CSS を PowerShell として実行しようとします：

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

表現は PowerShell バージョンとシステム言語によって異なります。Missing expression after unary operator '--' または ParserError と ParseException が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS はこの失敗を識別します。代わりに -OutFile install.ps1 でダウンロードする場合、保存されたファイルは同じウェブページであるため、それも役に立ちません。

リクエストのルーティング方法によっては、HTML ボディなしの 403 が表示される場合があります：

curl: (22) The requested URL returned error: 403

これらはすべて、インストール URL がインストールスクリプトではなく HTML ページまたはエラーステータスを返したことを意味します。HTML ページが「App unavailable in region」と表示される場合、Claude Code はお客様の国では利用できません。サポートされている国を参照してください。

ボディなしの 403 は多くの場合同じ原因がありますが、企業プロキシまたはダウンロードをブロックしているファイアウォールからも発生する可能性があります。サポートされている国にいるのに 403 が表示される場合は、以下の代替インストーラーを試す前にネットワーク接続を確認するを実行してください。これらは同じホストに到達するためです。

それ以外の場合、これはネットワークの問題、地域的なルーティング、または一時的なサービス中断が原因で発生する可能性があります。

解決策：

1. 別のインストール方法を使用してください：

   macOS では、Homebrew 経由でインストールしてください：

   brew install --cask claude-code
   

   Windows では、WinGet 経由でインストールしてください：

   winget install Anthropic.ClaudeCode
   

   その後、claude --version を実行して確認してください。コマンドは 2.1.211 (Claude Code) などのバージョン番号を出力します。シェルが claude が見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古い PATH を保持しています。

2. 数分後に再試行してください：問題は一時的なことが多いです。待ってから元のコマンドを再度試してください。

インストール後に `command not found: claude`

インストールが完了しましたが、claude が機能しません。正確なエラーはプラットフォームによって異なります：

これは、インストールディレクトリがシェルの検索パスに含まれていないことを意味します。各プラットフォームの修正については、PATH を確認するを参照してください。

`curl: (56) Failure writing output to destination`

curl ... | bash コマンドはスクリプトをダウンロードして Bash にパイプして実行します。このエラーと関連する curl: (23) Failure writing output to destination は、Bash がスクリプト全体を受け取らなかったことを意味します。終了コード 56 はダウンロード自体が中断されたことを示し、終了コード 23 は curl がパイプに受け取ったものを書き込めなかったことを示します。通常は Bash が早期に終了したためです。

ネットワーク接続を確認するのチェックで downloads.claude.ai に到達できることをテストしてください。サーバーに到達した場合、元の失敗は一時的なものである可能性があります。インストールコマンドを再試行してください。別のインストール方法を試すこともできます。

Homebrew cask が利用できないか古い

Homebrew が Error: Cask 'claude-code' is unavailable: No Cask with this name exists を報告する場合、Homebrew cask インデックスのローカルコピーが cask の公開より前のものです。インデックスを更新して再試行してください：

brew update
brew install --cask claude-code

Homebrew が予想より古い Claude Code バージョンをインストールする場合、通常は同じ古いインデックスが原因です。claude-code cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに brew install --cask claude-code@latest を実行してください。2 つの cask の違いについては、リリースチャネルを設定するを参照してください。

TLS または SSL 接続エラー

curl: (35) TLS connect error、schannel: next InitializeSecurityContext failed、または PowerShell の Could not establish trust relationship for the SSL/TLS secure channel などのエラーは TLS ハンドシェイク失敗を示します。

解決策：

1. システム CA 証明書を更新してください：

   Ubuntu/Debian では：

   sudo apt-get update && sudo apt-get install ca-certificates
   

   macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。

2. Windows では、インストーラーを実行する前に PowerShell で TLS 1.2 を有効にしてください：

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

3. プロキシまたはファイアウォール干渉を確認してください：TLS 検査を実行する企業プロキシは、unable to get local issuer certificate や SELF_SIGNED_CERT_IN_CHAIN を含むこれらのエラーを引き起こす可能性があります。インストール手順では、インストールダウンロードを企業プロキシの CA に信頼させてください：

   macOS/Linux Windows PowerShell

   curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
   

   インストール後の Claude Code 自体については、NODE_EXTRA_CA_CERTS を設定して API リクエストが同じバンドルを信頼するようにしてください：

   macOS/Linux Windows PowerShell

   export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
   

   証明書ファイルがない場合は IT チームに問い合わせてください。また、直接接続で試して、プロキシが原因であることを確認することもできます。

4. Windows では、ブロックされた失効確認を回避してください。エラー CRYPT_E_NO_REVOCATION_CHECK (0x80092012) と CRYPT_E_REVOCATION_OFFLINE (0x80092013) は、curl がサーバーに到達したが、ネットワークが証明書失効ルックアップをブロックしていることを意味します。これは企業ファイアウォールの背後では一般的です。失敗したコマンドが install.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
   

   スクリプト自体のダウンロードが同じエラーに直面すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、既知の失効証明書は依然として拒否し、ブラウザが失効を処理する方法と一致します。PowerShell インストーラーを PowerShell から実行することで curl の失効確認を完全に回避することもできます。これは .NET を通じてダウンロードし、失効サーバーに到達できない場合は失敗しません：

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

   winget install Anthropic.ClaudeCode でインストールすることもできます。これは curl を完全に回避します。

`Failed to fetch version from downloads.claude.ai`

インストーラーがダウンロードサーバーに到達できませんでした。これは通常、downloads.claude.ai がネットワークでブロックされていることを意味します。ネットワーク接続を確認するを参照してください。

Windows での間違ったインストールコマンド

'irm' is not recognized、The token '&&' is not valid、A parameter cannot be found that matches parameter name 'fsSL'、または 'bash' is not recognized as the name of a cmdlet が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドがスクリプトのテキストを出力する場合、その一部のみを実行しました。

• irm が認識されない：CMD にいて、PowerShell ではありません。2 つのオプションがあります：

  スタートメニューで「PowerShell」を検索して PowerShell を開き、元のインストールコマンドを実行してください：

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

  または CMD にとどまり、代わりに CMD インストーラーを使用してください：

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

• && が有効ではない：PowerShell にいますが、CMD インストーラーコマンドを実行しました。PowerShell インストーラーを使用してください：

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

• A parameter cannot be found that matches parameter name 'fsSL'：Windows PowerShell で macOS/Linux curl -fsSL ... | bash インストーラーを実行しました。ここで curl は Invoke-WebRequest のエイリアスであり、-fsSL フラグを拒否します。代わりに PowerShell インストーラーを使用してください：

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

• bash が認識されない：Windows で macOS/Linux インストーラーを実行しました。代わりに PowerShell インストーラーを使用してください：

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

• コマンドがスクリプトテキストを出力する：ダウンロード半分のコマンドを実行部分なしで実行しました。irm https://claude.ai/install.ps1 単独でダウンロードされたスクリプトをターミナルに出力します。iex にパイプして実行してください：

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

  CMD では、-o なしの curl -fsSL https://claude.ai/install.cmd はバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行してください：

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

どのインストーラーを使用するにしても、それが機能したことを確認してください。新しいターミナルを開いて claude --version を実行してください。これは 2.1.211 (Claude Code) などのバージョン番号を出力します。

`running scripts is disabled on this system`

Windows で npm を通じて Claude Code をインストールまたは実行すると、SecurityError で失敗する可能性があります：

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

npm インストール後に claude を実行すると、同じエラーが claude.ps1 に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する .ps1 ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、ダウンロードされたテキストを直接実行する PowerShell インストーラー irm https://claude.ai/install.ps1 | iex には影響しません。

解決策：

1. ユーザーのローカルで作成されたスクリプトを許可してから、再試行してください：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. .cmd ランチャーを呼び出してください：npm.cmd と claude.cmd は同じジョブを実行し、ポリシーはそれらをカバーしません。
3. npm の代わりに PowerShell インストーラーを使用してください。これは .ps1 スクリプトではなくバイナリをインストールします。

Windows インストール中の `The process cannot access the file`

PowerShell インストーラーが Failed to download binary: The process cannot access the file ... because it is being used by another process で失敗する場合、インストーラーは %USERPROFILE%\.claude\downloads に書き込むことができませんでした。これは通常、以前のインストール試行がまだ実行されているか、アンチウイルスソフトウェアがそのフォルダー内の部分的にダウンロードされたバイナリをスキャンしていることを意味します。

インストーラーを実行している他の PowerShell ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するのを待ってください。その後、ダウンロードフォルダーを削除してインストーラーを再度実行してください：

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

低メモリ Linux サーバーでインストール中に Killed

インストール中に Killed メッセージが表示される場合、通常は Linux のメモリ不足（OOM）キラーがシステムがメモリ不足になったため claude install ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります：

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

インストールには約 512 MB の空きメモリが必要で、Claude Code を実行するにはさらに多くが必要です。システム要件を参照してください。

解決策：

1. RAM が限られている場合はスワップスペースを追加してください。スワップはディスク領域をオーバーフロー メモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。

   2 GB スワップファイルを作成して有効にしてください：

   sudo fallocate -l 2G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile
   

   その後、インストールを再試行してください：

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

2. インストール前に他のプロセスを閉じてメモリを解放してください。

3. 可能であれば、より大きなインスタンスを使用してください。Claude Code には少なくとも 4 GB の RAM が必要です。

Docker でのインストールハング

Docker コンテナで Claude Code をインストールするときに、root として / にインストールするとハングが発生する可能性があります。

解決策：

1. インストーラーを実行する前に作業ディレクトリを設定してください。/ から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用を引き起こします。WORKDIR を設定すると、スキャンが小さなディレクトリに制限されます：

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

2. Docker Desktop を使用している場合は Docker にさらにメモリを与えてください。ビルドコンテナーは Docker Desktop 仮想マシンに割り当てられたメモリを共有するため、Docker Desktop で Settings > Resources を開き、メモリ制限を上げて、ビルドを再実行してください。

インストール中の `Raw mode is not supported`

組織のサーバー管理設定にセキュリティ承認が必要な変更が含まれている場合、Claude Code v2.1.246 より前のバージョンは claude install 中に承認ダイアログを表示しようとします。ダイアログは stdin 上のターミナルが必要です。インストーラーが curl -fsSL https://claude.ai/install.sh | bash のようにパイプから claude install を実行する場合、stdin はターミナルではなくパイプであるため、インストールは Raw mode is not supported を含むエラーで失敗します。

Claude Code v2.1.246 以降は claude install または claude update 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ構成が設定フェッチを待つ場合（forceRemoteSettingsRefresh を設定する場合など）、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは依然として失敗します。

他のすべての構成では、インストーラーを再実行するとこのエラーを超えます。スクリプトは古いバージョンをインストールするよう求めても最新リリースの install コマンドを実行するためです。プラットフォームのコマンドを再実行してください：

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

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

claude --version は再実行がインストールしたバージョンを出力します。

`claude update` または `claude doctor` がハング

claude update と claude doctor はシェル構成ファイルで古い claude エイリアスをスキャンします：~/.zshrc、~/.bashrc、~/.config/fish/config.fish、および macOS では存在する ~/.bash_profile、~/.bash_login、または ~/.profile の最初のもの。ZDOTDIR を設定する場合、Zsh ファイルは代わりに $ZDOTDIR/.zshrc です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、/status のシステム診断セクションを空白のままにしました。claude doctor は出力なしでハングしました。claude update は Checking for updates を出力した直後にハングしました。

以前のバージョンでハングに直面した場合は、ディレクトリを見つけてください。このコマンドの出力では、d で始まる行はそのパスをディレクトリとしてマークします。No such file or directory という行は、そのパスに何も存在せず、原因ではないことを意味します：

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

ディレクトリを脇に移動するか、v2.1.214 以降に更新してください。claude update は影響を受けたバージョンでハングするため、代わりにインストールスクリプトを再実行して更新してください。

Claude Desktop が Windows の `claude` コマンドをオーバーライドする

Claude Desktop の古いバージョンをインストールした場合、WindowsApps ディレクトリに Claude.exe を登録して、Claude Code CLI よりも PATH の優先度を取得する可能性があります。claude を実行すると、CLI ではなく Desktop アプリが開きます。

Claude Desktop を最新バージョンに更新して、この問題を修正してください。

Windows での Claude Code は Git for Windows（Bash 用）または PowerShell が必要です

Git for Windows はオプションです。Claude Code は Git Bash がない場合、PowerShell ツールを使用するため、このエラーはどちらのシェルも見つからなかったことを意味します。

PowerShell が PATH にない場合、デフォルトの場所は C:\Windows\System32\WindowsPowerShell\v1.0\ です。そのディレクトリを PATH に追加するか、pwsh を提供する PowerShell 7 をインストールしてください。

Git for Windows をインストールする代わりに、git-scm.com/downloads/win からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後、ターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作するときに便利です。

Git が既にインストールされているが Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。CLAUDE_CODE_GIT_BASH_PATH が設定されていない場合、Claude Code は次の順序で bash.exe を探します：

1. デフォルトインストール場所 C:\Program Files\Git と C:\Program Files (x86)\Git。
2. PATH 上の git。そのインストールから bin\bash.exe を使用します。

ステップ 2 では、Claude Code を起動したフォルダーに存在する git、またはそのフォルダーの下の node_modules または .venv や env などの仮想環境フォルダーを含むパスをスキップします。例えば、C:\dev\env\myproject から起動した場合の C:\dev\env\myproject\Git。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行するのを防ぎます。Git がそのような場所にある場合は、CLAUDE_CODE_GIT_BASH_PATH でそれを指します。

Claude Code を特定の Git インストールに指すには、PowerShell で where.exe git を実行してそれを見つけ、そのインストールから bin\bash.exe パスを settings.json ファイルで CLAUDE_CODE_GIT_BASH_PATH として設定してください：

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

CLAUDE_CODE_GIT_BASH_PATH が正しいパスに設定されており、ファイルが存在するが Claude Code がそれを使用しない場合は、ファイルの名前を最初に確認してください。Claude Code は bash.exe、sh.exe、bash、または sh という名前のファイルのみを受け入れます。Git for Windows の git-bash.exe ランチャーなど、他の名前では、変数を無視して自動検出にフォールバックし、--debug で表示される警告をログに記録します。存在しないパスは同じフォールバックと警告を取得します。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルを使用し、パスが存在しない場合は Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path で起動時に終了しました。

ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、または EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに claude.exe と、cmd.exe や bash.exe を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。

Claude Code は 32 ビット Windows をサポートしていません

Windows のスタートメニューには 2 つの PowerShell エントリが含まれています：Windows PowerShell と Windows PowerShell (x86)。x86 エントリは 32 ビットプロセスとして実行され、64 ビットマシンでもこのエラーをトリガーします。どちらの場合かを確認するには、エラーを生成したのと同じウィンドウで次を実行してください：

[Environment]::Is64BitOperatingSystem

これが True を出力する場合、オペレーティングシステムは問題ありません。ウィンドウを閉じて、x86 サフィックスなしで Windows PowerShell を開き、インストールコマンドを再度実行してください。

これが False を出力する場合、32 ビット版の Windows を使用しています。Claude Code には 64 ビットオペレーティングシステムが必要です。システム要件を参照してください。

Linux musl または glibc バイナリの不一致

インストール後に libstdc++.so.6 または libgcc_s.so.1 などの不足している共有ライブラリに関するエラーが表示される場合、インストーラーはシステムに対応した間違ったバイナリバリアントをダウンロードした可能性があります。

Error loading shared library libstdc++.so.6: No such file or directory

これは、musl クロスコンパイルパッケージがインストールされている glibc ベースのシステムで発生する可能性があり、インストーラーがシステムを musl として誤検出します。

解決策：

1. システムが使用している libc を確認してください：

   ldd --version 2>&1 | head -1
   

   GNU libc または GLIBC に言及している出力は glibc を意味します。musl に言及している出力は musl を意味します。

2. glibc にいるが musl バイナリを取得した場合、インストールを削除して再インストールしてください。https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。ldd --version と ls /lib/libc.musl* の出力を含めて GitHub issue をファイルしてください。

3. 実際に musl にいる場合（Alpine Linux など）、必要なパッケージをインストールしてください：

   apk add libgcc libstdc++ ripgrep
   

   Alpine では、ripgrep はコミュニティリポジトリにあります。apk がパッケージが見つからないと報告する場合は、Alpine Linux セットアップを参照してください。

`Illegal instruction`

claude またはインストーラーを実行すると Illegal instruction が出力される場合、ネイティブバイナリはプロセッサがサポートしていない CPU 命令を使用しています。2 つの異なる原因があります。

アーキテクチャの不一致。 インストーラーは間違ったバイナリをダウンロードしました。例えば、ARM サーバーで x86。macOS または Linux では uname -m で、PowerShell では $env:PROCESSOR_ARCHITECTURE で確認してください。結果が受け取ったバイナリと一致しない場合は、出力を含めて GitHub issue をファイルしてください。

不足している AVX 命令セット。 アーキテクチャは正しいが、それでも Illegal instruction が表示される場合、CPU は AVX またはバイナリが必要とする別の命令がない可能性があります。これは約 2013 年以前の Intel および AMD プロセッサに影響します。仮想マシンでは、ハイパーバイザーが AVX をゲストに渡さない場合があります。

VPS または VM では、grep -m1 -ow avx /proc/cpuinfo を実行してください。空の結果は AVX がゲストで利用できないことを意味します。

ネイティブバイナリの回避策はありません。issue #50384 でステータスを追跡し、報告するときに Linux では grep -m1 "model name" /proc/cpuinfo から、macOS では sysctl -n machdep.cpu.brand_string から CPU モデルを含めてください。

別のインストール方法は同じネイティブバイナリをダウンロードし、どちらの原因も解決しません。

macOS での `dyld: cannot load`

インストール中に dyld: Symbol not found、dyld: cannot load、または Abort trap: 6 が表示される場合、バイナリは macOS バージョンまたはハードウェアと互換性がありません。

Symbol not found エラーが libicucore を参照する場合、macOS バージョンがバイナリがサポートするより古いことを意味します：

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

ローダーは代わりにバイナリのロードコマンドを拒否する可能性があり、これは macOS バージョンが古すぎることも意味します：

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

解決策：

1. macOS バージョンを確認してください：Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。

2. 古いバージョンを使用している場合は macOS を更新してください。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの別のインストール方法は同じバイナリをダウンロードし、このエラーを解決しません。

WSL1 での `Exec format error`

WSL で claude を実行すると cannot execute binary file: Exec format error が出力される場合、WSL1 にいて、issue #38788 で追跡されている既知のネイティブバイナリ回帰に直面しています。バイナリのプログラムヘッダーが WSL1 のローダーが処理できない方法で変更されました。

最もクリーンな修正は、PowerShell からディストリビューションを WSL2 に変換することです：

wsl --set-version <DistroName> 2

WSL1 にとどまる必要がある場合は、動的リンカーを通じてバイナリを呼び出してください。ホームディレクトリが異なる場合はパスを置き換えて、WSL 内の ~/.bashrc にこの関数を追加してください：

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

その後、source ~/.bashrc を実行して claude を再試行してください。

WSL での npm インストールエラー

これらの問題は、WSL 内で npm install -g を使用して Claude Code をインストールした場合に適用されます。ネイティブインストーラーを使用した場合は、このセクションをスキップしてください。

OS またはプラットフォーム検出の問題。 npm がインストール中にプラットフォームの不一致を報告する場合、WSL は Windows npm を取得している可能性があります。最初に npm config set os linux を実行してから、npm install -g @anthropic-ai/claude-code --force でインストールしてください。sudo を使用しないでください。

claude を実行するときの exec: node: not found。 WSL 環境は Windows インストール Node.js を使用している可能性があります。which npm と which node で確認してください：/mnt/c/ で始まるパスは Windows バイナリで、Linux パスは /usr/ で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは nvm 経由で Node をインストールしてください。

nvm バージョンの競合。 WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL はデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを ~/.bashrc または ~/.zshrc に追加してください：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

または現在のセッションで読み込んでください：

source ~/.nvm/nvm.sh

nvm が読み込まれているが Windows パスがまだ優先される場合は、Linux Node パスを明示的に先頭に追加してください：

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

インストール中の権限エラー

ネイティブインストーラーが権限エラーで失敗する場合、ターゲットディレクトリが書き込み可能でない可能性があります。ディレクトリ権限を確認するを参照してください。

以前に npm でインストールしていて、npm 固有の権限エラーに直面している場合は、ネイティブインストーラーに切り替えてください：

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

npm インストール後にネイティブバイナリが見つからない

@anthropic-ai/claude-code npm パッケージは、@anthropic-ai/claude-code-darwin-arm64 などのプラットフォーム固有のオプション依存関係を通じてネイティブバイナリを取得します。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを claude コマンドとして所定の位置にコピーします。実行されるまで、claude はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーは所定の位置に留まり、macOS と Linux で claude を実行すると出力されます：

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

Windows では、bin/claude.exe はその同じシェルスクリプトプレースホルダーであり、実際の実行可能ファイルではないため、PowerShell と CMD はこのメッセージを出力する代わりにファイルを実行できないと報告します。

次の原因を確認してください：

• オプション依存関係が無効になっています。 npm インストールコマンドから --omit=optional を削除し、pnpm から --no-optional を削除し、yarn から --ignore-optional を削除し、.npmrc が optional=false を設定していないことを確認してから、再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックはありません。
• インストールスクリプトが無効になっています。 --ignore-scripts と一部の pnpm 構成は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように node node_modules/@anthropic-ai/claude-code/install.cjs を実行するか、フラグなしで再インストールしてください。postinstall が環境で実行できない場合、node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs はダウンロードされたパッケージを見つけて起動し、各起動時に追加の Node プロセスのコストがかかります。ラッパーが代わりに Could not find native binary package を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。
• サポートされていないプラットフォーム。 プリビルドバイナリは darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64、および win32-arm64 用に公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。システム要件を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。
• 企業 npm ミラーがプラットフォームパッケージを欠いています。 レジストリがメタパッケージに加えて 8 つすべての @anthropic-ai/claude-code-* プラットフォームパッケージをミラーしていることを確認してください。

npm `ENOTEMPTY` エラー（更新または再インストール中）

既存のインストール上で npm install -g @anthropic-ai/claude-code を実行すると、npm は古いパッケージディレクトリを脇に移動しながら失敗する可能性があります：

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

npm error path 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する .claude-code-* ディレクトリを削除してください。以下のコマンドは npm root -g でグローバルパッケージディレクトリを見つけます。npm error path 行が名前を付けるディレクトリが npm root -g が出力するディレクトリの下にない場合（例えば nvm でノードバージョンを切り替えたため）、エラーが名前を付けるディレクトリを削除してください：

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

その後、再インストールしてください：

npm install -g @anthropic-ai/claude-code

claude --version で確認してください。これは 2.1.211 (Claude Code) などのバージョン番号を出力します。

ログインと認証

これらのセクションはログイン失敗、OAuth エラー、およびトークンの問題に対処します。

ログインをリセットする

ログインが失敗し、原因が明らかでない場合、クリーンな再認証がほとんどの場合を解決します：

1. /logout を実行して完全にサインアウトしてください
2. Claude Code を閉じてください
3. claude で再起動して、認証プロセスを再度完了してください

ログイン中にブラウザが自動的に開かない場合は、c を押して OAuth URL をクリップボードにコピーしてから、手動でブラウザに貼り付けてください。これは、URL が狭いまたは SSH ターミナルで行をまたいでラップされ、直接クリックできない場合にも機能します。

OAuth エラー：無効なコード

OAuth error: Invalid code. Please make sure the full code was copied が表示される場合、ログインコードが期限切れになったか、コピー貼り付け中に切り詰められました。

解決策：

• ブラウザが開いた後、Enter キーを押して迅速にログインを完了してください
• ブラウザが自動的に開かない場合は、c を入力して完全な URL をコピーしてください
• リモート/SSH セッションを使用している場合、ブラウザは間違ったマシンで開く可能性があります。ターミナルに表示されている URL をコピーして、代わりにローカルブラウザで開いてください。

ログイン後の 403 Forbidden

ログイン後に API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} が表示される場合：

• Claude Pro/Max ユーザー：claude.ai/settings でサブスクリプションがアクティブであることを確認してください
• Anthropic Console ユーザー：アカウントに「Claude Code」または「Developer」ロールがあることを確認してください。管理者は Anthropic Console の設定 → メンバーで割り当てます。
• プロキシの背後：企業プロキシは API リクエストに干渉する可能性があります。ネットワーク設定 を参照してプロキシセットアップを確認してください。

このオーガニゼーションはアクティブなサブスクリプションで無効になっています

アクティブな Claude サブスクリプションがあるにもかかわらず API Error: 400 ... "This organization has been disabled" が表示される場合、ANTHROPIC_API_KEY 環境変数がサブスクリプションをオーバーライドしています。これは、前の雇用主またはプロジェクトからの古い API キーがシェルプロファイルに設定されている場合に一般的に発生します。

ANTHROPIC_API_KEY が存在し、承認されている場合、Claude Code はサブスクリプションの OAuth 認証情報の代わりにそのキーを使用します。-p フラグを使用した非対話モードでは、存在する場合、キーは常に使用されます。認証の優先順位 を参照して、完全な解決順序を確認してください。

代わりにサブスクリプションを使用するには、環境変数を設定解除し、シェルプロファイルから削除してください：

unset ANTHROPIC_API_KEY
claude

Remove-Item Env:ANTHROPIC_API_KEY
claude

~/.zshrc、~/.bashrc、または ~/.profile で export ANTHROPIC_API_KEY=... 行を確認して削除し、変更を永続的にしてください。Windows では、$PROFILE の PowerShell プロファイルと ANTHROPIC_API_KEY のユーザー環境変数を確認してください。Claude Code 内で /status を実行して、どの認証方法がアクティブであるかを確認してください。

WSL2、SSH、またはコンテナでの OAuth ログイン失敗

Claude Code が WSL2 で実行されている場合、SSH 経由でリモートマシンで実行されている場合、またはコンテナ内で実行されている場合、ブラウザは通常、別のホストで開き、そのリダイレクトは Claude Code のローカルコールバックサーバーに到達できません。サインイン後、ブラウザは自動的にリダイレクトされるのではなく、ログインコードを表示します。ターミナルの Paste code here if prompted プロンプトにそのコードを貼り付けてログインを完了してください。

WSL2 からブラウザがまったく開かない場合は、BROWSER 環境変数を Windows ブラウザパスに設定してください：

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

または、対話型ログインプロンプトで c を押して OAuth URL をコピーするか、claude auth login が出力する URL をコピーして、ローカルマシンのブラウザで開いてください。

対話型プロンプトにコードを貼り付けても何もしない場合、ターミナルの貼り付けバインディングはおそらく入力フィールドに到達していません。ターミナルの別の貼り付けショートカット（Windows Terminal では右クリックまたは Shift+Insert）を試すか、標準入力から貼り付けられたコードを読み取る claude auth login を使用してください：

claude auth login

このフォールバックは、ネイティブ Windows またはコードを対話型プロンプトに貼り付けるのが失敗するその他のターミナルにも適用されます。

ログインしていないか、トークンが期限切れ

Claude Code がセッション後に再度ログインするよう求める場合、OAuth トークンが期限切れになった可能性があります。

/login を実行して再認証してください。これが頻繁に発生する場合は、トークン検証が正しいタイムスタンプに依存するため、システムクロックが正確であることを確認してください。

1 台のマシン上の並列セッションは保存されたログインを共有し、その更新を調整して、1 つのプロセスだけが一度にトークンを更新するようにします。v2.1.211 より前では、マシンをスリープから起動すると、2 つのセッションが同じトークンで更新される可能性があり、これは保存されたログインを取り消し、すべてのオープンセッションに一度にログインするよう求めました。

macOS では、Claude Code は認証情報をログイン Keychain に保存します。Keychain が書き込みを拒否する場合（SSH セッションでロックされている場合、またはパスワードがアカウントパスワードと同期していない場合など）、Claude Code は代わりにログインをプレーンテキスト ~/.claude/.credentials.json ファイルに保存します。Keychain が再び書き込み可能になるまで、API キーを作成する Console ログインは失敗します。

Keychain を再び書き込み可能にし、ログインを暗号化された Keychain に戻すには：

security unlock-keychain ~/Library/Keychains/login.keychain-db

Bedrock、Agent Platform、または Foundry 認証情報が読み込まれない

Claude Code をクラウドプロバイダーを使用するように設定し、Amazon Bedrock で Could not load credentials from any providers、Google Cloud の Agent Platform で Could not load the default credentials、または Microsoft Foundry で ChainedTokenCredential authentication failed が表示される場合、クラウドプロバイダー CLI は現在のシェルで認証されていない可能性があります。

Amazon Bedrock の場合、AWS 認証情報が有効であることを確認してください：

aws sts get-caller-identity

Google Cloud の Agent Platform の場合、ANTHROPIC_VERTEX_PROJECT_ID と CLOUD_ML_REGION がシェルに設定されていることを確認してから、アプリケーションのデフォルト認証情報を設定してください：

gcloud auth application-default login

Microsoft Foundry の場合、ANTHROPIC_FOUNDRY_API_KEY が設定されていることを確認するか、Azure CLI でサインインして、デフォルト認証情報チェーンがアカウントを見つけられるようにしてください：

az login

認証情報がターミナルで機能するが VS Code または JetBrains 拡張機能では機能しない場合、IDE プロセスはおそらくシェル環境を継承していません。IDE 独自の設定でプロバイダー環境変数を設定するか、既にエクスポートされているターミナルから IDE を起動してください。

完全なプロバイダーセットアップについては、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を参照してください。

まだ立ち往生している

上記のいずれも問題を解決しない場合：

1. GitHub リポジトリで既知の問題を確認するか、オペレーティングシステム、実行したインストールコマンド、および完全なエラー出力を含めて新しい問題を開いてください
2. claude --version が機能するが他に何か問題がある場合は、claude doctor を実行して自動診断レポートを取得してください
3. セッションを開始できる場合は、Claude Code 内で /feedback を使用して問題を報告してください
4. 問題がインストールではなくアカウントに関するものである場合（ログインループ、認識されないサブスクリプション、無効な組織など）は、Anthropic サポートにお問い合わせください。claude.ai（Console ユーザーの場合：platform.claude.com）にサインインし、左下のイニシャルをクリックして、Get help を選択してください。完全なフローについては、How to get supportを参照してください。