エラーを見つける
表示されているエラーメッセージまたは症状を修正方法と照合してください:
問題がリストに記載されていない場合は、以下の診断チェックを実行して、原因を特定してください。
診断チェックを実行する
ネットワーク接続を確認する
インストーラーはdownloads.claude.ai からダウンロードします。到達可能であることを確認してください:
- macOS/Linux
- Windows PowerShell
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 チームに問い合わせるか、ブラウザのプロキシ設定を確認してください。
この例は両方のプロキシ変数を設定してから、プロキシを通じてインストーラーを実行します:
- macOS/Linux
- Windows PowerShell
PATH を確認する
インストールが成功しても、claude を実行するときに command not found または not recognized エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では ~/.local/bin/claude に、Windows では %USERPROFILE%\.local\bin\claude.exe に claude を配置します。
VS Code 拡張機能は
claude をこの場所に配置しません。拡張機能ディレクトリ内に CLI のプライベートコピーをバンドルし、独自のチャットパネル用に使用し、PATH に追加しません。拡張機能のみをインストールした場合、~/.local/bin/claude は存在しません。ターミナルから claude を使用するにはスタンドアロンインストールを実行してから、以下を続行してください。local/bin でフィルタリングしてください:
- macOS/Linux
- Windows PowerShell
- Windows CMD
/Users/you/.local/bin または /home/you/.local/bin を出力する場合、ディレクトリは PATH に含まれており、競合するインストールを確認するにスキップできます。出力がない場合は、シェル設定に追加してください。macOS のデフォルトである Zsh の場合:~/.local/bin を PATH に追加してから、ターミナルを再起動してください。修正が機能したことを確認してください:競合するインストールを確認する
複数の Claude Code インストールはバージョンの不一致または予期しない動作を引き起こす可能性があります。インストールされているものを確認してください:- macOS/Linux
- Windows PowerShell
PATH に見つかったすべての これが何も出力しない場合、ネイティブインストールは
claude バイナリをリストします:claude はまだ PATH にありません。PATH を確認するに戻ってください。claude バイナリが来ることができる 3 つの場所を確認してください。~/.local/bin/claude はネイティブインストーラー、~/.claude/local/ は Claude Code の古いバージョンによって作成されたレガシーローカル npm インストール、npm グローバルリストは -g インストールを示します:~/.local/share/claude/versions/ へのシンボリックリンクを表示します。このパスで自分で作成したスクリプトまたはシンボリックリンクはカスタムランチャーであり、自動更新はそのまま残します。ls コマンドが No such file or directory を出力する場合、それはエラーではありません。その場所に何もインストールされていないことを意味するため、次のチェックに進んでください。~/.local/bin/claude または Windows の %USERPROFILE%\.local\bin\claude.exe でのネイティブインストールが推奨されます。余分なものを削除してください:
npm グローバルインストールをアンインストールします:
- macOS/Linux
- Windows PowerShell
claude-code@latest cask をインストールした場合は、その名前に置き換えてください:
ディレクトリ権限を確認する
インストーラーは macOS と Linux の~/.local/bin/ と ~/.claude/ への書き込みアクセスが必要です。Windows ではインストール場所は %USERPROFILE% の下にあり、デフォルトではユーザーが書き込み可能なため、このセクションはそこではほとんど適用されません。
ディレクトリが書き込み可能かどうかを確認してください:
バイナリが機能することを確認する
claude --version がバージョンを出力しても claude がクラッシュまたはハングする場合は、これらのチェックを実行して原因を特定してください。claude --version がコマンドが見つからないと言う場合は、最初に PATH を確認するに移動してください。以下のコマンドは claude が PATH にあることを前提としています。
バイナリが存在し、実行可能であることを確認してください:
- macOS/Linux
- Windows PowerShell
ldd が不足しているライブラリを表示する場合は、システムパッケージをインストールする必要があるかもしれません。Alpine Linux およびその他の musl ベースのディストリビューションについては、Alpine Linux セットアップを参照してください。
一般的なインストール問題
これらは最も頻繁に遭遇するインストール問題とその解決策です。インストールスクリプトがシェルスクリプトではなく HTML を返す
インストールコマンドを実行するときに、次のいずれかのエラーが表示される場合があります:iex が HTML と CSS を PowerShell として実行しようとします:
Missing expression after unary operator '--' または ParserError と ParseException が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS はこの失敗を識別します。代わりに -OutFile install.ps1 でダウンロードする場合、保存されたファイルは同じウェブページであるため、それも役に立ちません。
リクエストのルーティング方法によっては、HTML ボディなしの 403 が表示される場合があります:
-
別のインストール方法を使用してください:
macOS では、Homebrew 経由でインストールしてください:
Windows では、WinGet 経由でインストールしてください:その後、
claude --versionを実行して確認してください。コマンドは2.1.211 (Claude Code)などのバージョン番号を出力します。シェルがclaudeが見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古いPATHを保持しています。 - 数分後に再試行してください:問題は一時的なことが多いです。待ってから元のコマンドを再度試してください。
インストール後に 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 が早期に終了したためです。
解決策:
-
ネットワークの安定性を確認してください:Claude Code バイナリは
downloads.claude.aiでホストされています。到達可能であることをテストしてください:HTTP/2 200という行はサーバーに到達したことを意味し、元の失敗は一時的なものである可能性があります。インストールコマンドを再試行してください。他の結果は原因を指します:403:通常はプロキシまたはネットワークフィルターがホストをブロックしているか、Claude Code がお客様の地域では利用できません5xx:通常は一時的なサービス問題です。数分待ってから再試行してくださいCould not resolve hostまたは接続タイムアウト:ネットワークがダウンロードをブロックしています
-
別のインストール方法を試してください:
macOS では:
Windows では:その後、
claude --versionを実行して確認してください。コマンドは2.1.211 (Claude Code)などのバージョン番号を出力します。シェルがclaudeが見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古いPATHを保持しています。
Homebrew cask が利用できないか古い
Homebrew がError: Cask 'claude-code' is unavailable: No Cask with this name exists を報告する場合、Homebrew cask インデックスのローカルコピーが cask の公開より前のものです。インデックスを更新して再試行してください:
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 ハンドシェイク失敗を示します。
解決策:
-
システム CA 証明書を更新してください:
Ubuntu/Debian では:
macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。
-
Windows では、インストーラーを実行する前に PowerShell で TLS 1.2 を有効にしてください:
-
プロキシまたはファイアウォール干渉を確認してください:TLS 検査を実行する企業プロキシは、
unable to get local issuer certificateやSELF_SIGNED_CERT_IN_CHAINを含むこれらのエラーを引き起こす可能性があります。インストール手順では、インストールダウンロードを企業プロキシの CA に信頼させてください:インストール後の Claude Code 自体については、- macOS/Linux
- Windows PowerShell
NODE_EXTRA_CA_CERTSを設定して API リクエストが同じバンドルを信頼するようにしてください:証明書ファイルがない場合は IT チームに問い合わせてください。また、直接接続で試して、プロキシが原因であることを確認することもできます。- macOS/Linux
- Windows PowerShell
-
Windows では、ブロックされた失効確認を回避してください。エラー
CRYPT_E_NO_REVOCATION_CHECK (0x80092012)とCRYPT_E_REVOCATION_OFFLINE (0x80092013)は、curl がサーバーに到達したが、ネットワークが証明書失効ルックアップをブロックしていることを意味します。これは企業ファイアウォールの背後では一般的です。失敗したコマンドがinstall.cmdをダウンロードするcurlの場合、--ssl-revoke-best-effortを追加してコマンドプロンプトから再実行してください:スクリプト自体のダウンロードが同じエラーに直面すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、既知の失効証明書は依然として拒否し、ブラウザが失効を処理する方法と一致します。PowerShell インストーラーを PowerShell から実行することで curl の失効確認を完全に回避することもできます。これは .NET を通じてダウンロードし、失効サーバーに到達できない場合は失敗しません: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 を開き、元のインストールコマンドを実行してください:または CMD にとどまり、代わりに CMD インストーラーを使用してください: -
&&が有効ではない:PowerShell にいますが、CMD インストーラーコマンドを実行しました。PowerShell インストーラーを使用してください: -
A parameter cannot be found that matches parameter name 'fsSL':Windows PowerShell で macOS/Linuxcurl -fsSL ... | bashインストーラーを実行しました。ここでcurlはInvoke-WebRequestのエイリアスであり、-fsSLフラグを拒否します。代わりに PowerShell インストーラーを使用してください: -
bashが認識されない:Windows で macOS/Linux インストーラーを実行しました。代わりに PowerShell インストーラーを使用してください: -
コマンドがスクリプトテキストを出力する:ダウンロード半分のコマンドを実行部分なしで実行しました。
irm https://claude.ai/install.ps1単独でダウンロードされたスクリプトをターミナルに出力します。iexにパイプして実行してください:CMD では、-oなしのcurl -fsSL https://claude.ai/install.cmdはバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行してください:
claude --version を実行してください。これは 2.1.211 (Claude Code) などのバージョン番号を出力します。
running scripts is disabled on this system
Windows で npm を通じて Claude Code をインストールまたは実行すると、SecurityError で失敗する可能性があります:
claude を実行すると、同じエラーが claude.ps1 に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する .ps1 ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、ダウンロードされたテキストを直接実行する PowerShell インストーラー irm https://claude.ai/install.ps1 | iex には影響しません。
解決策:
- ユーザーのローカルで作成されたスクリプトを許可してから、再試行してください:
.cmdランチャーを呼び出してください:npm.cmdとclaude.cmdは同じジョブを実行し、ポリシーはそれらをカバーしません。- 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 ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するのを待ってください。その後、ダウンロードフォルダーを削除してインストーラーを再度実行してください:
低メモリ Linux サーバーでインストール中に Killed
インストール中にKilled メッセージが表示される場合、通常は Linux のメモリ不足(OOM)キラーがシステムがメモリ不足になったため claude install ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります:
-
RAM が限られている場合はスワップスペースを追加してください。スワップはディスク領域をオーバーフロー メモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。
2 GB スワップファイルを作成して有効にしてください:
その後、インストールを再試行してください:
- インストール前に他のプロセスを閉じてメモリを解放してください。
- 可能であれば、より大きなインスタンスを使用してください。Claude Code には少なくとも 4 GB の RAM が必要です。
Docker でのインストールハング
Docker コンテナで Claude Code をインストールするときに、root として/ にインストールするとハングが発生する可能性があります。
解決策:
-
インストーラーを実行する前に作業ディレクトリを設定してください。
/から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用を引き起こします。WORKDIRを設定すると、スキャンが小さなディレクトリに制限されます: - 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 コマンドを実行するためです。プラットフォームのコマンドを再実行してください:
- macOS/Linux
- Windows PowerShell
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 という行は、そのパスに何も存在せず、原因ではないことを意味します:
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 を探します:
- デフォルトインストール場所
C:\Program Files\GitとC:\Program Files (x86)\Git。 PATH上のgit。そのインストールからbin\bash.exeを使用します。
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 として設定してください:
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 ビットマシンでもこのエラーをトリガーします。どちらの場合かを確認するには、エラーを生成したのと同じウィンドウで次を実行してください:
True を出力する場合、オペレーティングシステムは問題ありません。ウィンドウを閉じて、x86 サフィックスなしで Windows PowerShell を開き、インストールコマンドを再度実行してください。
これが False を出力する場合、32 ビット版の Windows を使用しています。Claude Code には 64 ビットオペレーティングシステムが必要です。システム要件を参照してください。
Linux musl または glibc バイナリの不一致
インストール後にlibstdc++.so.6 または libgcc_s.so.1 などの不足している共有ライブラリに関するエラーが表示される場合、インストーラーはシステムに対応した間違ったバイナリバリアントをダウンロードした可能性があります。
-
システムが使用している libc を確認してください:
GNU libcまたはGLIBCに言及している出力は glibc を意味します。muslに言及している出力は musl を意味します。 -
glibc にいるが musl バイナリを取得した場合、インストールを削除して再インストールしてください。
https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.jsonのマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。ldd --versionとls /lib/libc.musl*の出力を含めて GitHub issue をファイルしてください。 -
実際に musl にいる場合(Alpine Linux など)、必要なパッケージをインストールしてください:
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 バージョンがバイナリがサポートするより古いことを意味します:
- macOS バージョンを確認してください:Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。
- 古いバージョンを使用している場合は macOS を更新してください。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの別のインストール方法は同じバイナリをダウンロードし、このエラーを解決しません。
WSL1 での Exec format error
WSL で claude を実行すると cannot execute binary file: Exec format error が出力される場合、WSL1 にいて、issue #38788 で追跡されている既知のネイティブバイナリ回帰に直面しています。バイナリのプログラムヘッダーが WSL1 のローダーが処理できない方法で変更されました。
最もクリーンな修正は、PowerShell からディストリビューションを WSL2 に変換することです:
~/.bashrc にこの関数を追加してください:
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 に追加してください:
インストール中の権限エラー
ネイティブインストーラーが権限エラーで失敗する場合、ターゲットディレクトリが書き込み可能でない可能性があります。ディレクトリ権限を確認するを参照してください。 以前に npm でインストールしていて、npm 固有の権限エラーに直面している場合は、ネイティブインストーラーに切り替えてください:npm インストール後にネイティブバイナリが見つからない
@anthropic-ai/claude-code npm パッケージは、@anthropic-ai/claude-code-darwin-arm64 などのプラットフォーム固有のオプション依存関係を通じてネイティブバイナリを取得します。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを claude コマンドとして所定の位置にコピーします。実行されるまで、claude はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーは所定の位置に留まり、macOS と Linux で claude を実行すると出力されます:
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 path 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する .claude-code-* ディレクトリを削除してください。以下のコマンドは npm root -g でグローバルパッケージディレクトリを見つけます。npm error path 行が名前を付けるディレクトリが npm root -g が出力するディレクトリの下にない場合(例えば nvm でノードバージョンを切り替えたため)、エラーが名前を付けるディレクトリを削除してください:
- macOS/Linux
- Windows PowerShell
no matches found を出力する場合、削除するものはありませんでした:claude --version で確認してください。これは 2.1.211 (Claude Code) などのバージョン番号を出力します。
ログインと認証
これらのセクションはログイン失敗、OAuth エラー、およびトークンの問題に対処します。ログインをリセットする
ログインが失敗し、原因が明らかでない場合、クリーンな再認証がほとんどの場合を解決します:/logoutを実行して完全にサインアウトしてください- Claude Code を閉じてください
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 フラグを使用した非対話モードでは、存在する場合、キーは常に使用されます。認証の優先順位 を参照して、完全な解決順序を確認してください。
代わりにサブスクリプションを使用するには、環境変数を設定解除し、シェルプロファイルから削除してください:
- macOS/Linux
- Windows PowerShell
~/.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 ブラウザパスに設定してください:
c を押して OAuth URL をコピーするか、claude auth login が出力する URL をコピーして、ローカルマシンのブラウザで開いてください。
対話型プロンプトにコードを貼り付けても何もしない場合、ターミナルの貼り付けバインディングはおそらく入力フィールドに到達していません。ターミナルの別の貼り付けショートカット(Windows Terminal では右クリックまたは Shift+Insert)を試すか、標準入力から貼り付けられたコードを読み取る claude auth login を使用してください:
ログインしていないか、トークンが期限切れ
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 に戻すには:
1
Keychain アクセスを確認する
claude doctor を実行して Keychain アクセスを確認してください。Keychain が書き込みを拒否する場合、レポートは macOS Keychain is not writable で始まる警告をリストし、その後に推奨される修正を示します。レポートに Keychain 警告がリストされていない場合、Keychain は書き込み可能であり、最後のステップにスキップできます。2
Keychain をロック解除する
claude doctor を再度実行してください。ロック解除が成功した場合、レポートは Keychain 警告をリストしなくなります。3
ロック解除が役に立たない場合は Keychain パスワードを再同期する
Keychain Access を開き、
login キーチェーンを選択して、編集 > キーチェーン「login」のパスワードを変更 を選択してアカウントパスワードと再同期してください。その後、claude doctor を再度実行してください。レポートが Keychain 警告をリストしなくなったら、次のステップに進んでください。4
ログアウトしてから再度ログインする
Keychain が再び書き込み可能になったら、Claude Code は次回認証情報を書き込むときに認証情報を Keychain に戻します。今すぐ強制するには、
/logout を実行してから /login を実行してください。ログアウトすると、プレーンテキストファイルの内容、保存された MCP サーバーログイン、プラグイン機密値を含むすべての保存された認証情報が削除されるため、その後 MCP サーバーを再度認可し、プラグインシークレットを再度入力することを期待してください。再度ログインすると、ログインが Keychain に保存されます。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 認証情報が有効であることを確認してください:
ANTHROPIC_VERTEX_PROJECT_ID と CLOUD_ML_REGION がシェルに設定されていることを確認してから、アプリケーションのデフォルト認証情報を設定してください:
ANTHROPIC_FOUNDRY_API_KEY が設定されていることを確認するか、Azure CLI でサインインして、デフォルト認証情報チェーンがアカウントを見つけられるようにしてください:
まだ立ち往生している
上記のいずれも問題を解決しない場合:- GitHub リポジトリで既知の問題を確認するか、オペレーティングシステム、実行したインストールコマンド、および完全なエラー出力を含めて新しい問題を開いてください
claude --versionが機能するが他に何か問題がある場合は、claude doctorを実行して自動診断レポートを取得してください- セッションを開始できる場合は、Claude Code 内で
/feedbackを使用して問題を報告してください - 問題がインストールではなくアカウントに関するものである場合(ログインループ、認識されないサブスクリプション、無効な組織など)は、Anthropic サポートにお問い合わせください。claude.ai(Console ユーザーの場合:platform.claude.com)にサインインし、左下のイニシャルをクリックして、Get help を選択してください。完全なフローについては、How to get supportを参照してください。