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

エラーを見つける

表示されているエラーメッセージまたは症状を修正方法と照合してください: 問題がリストに記載されていない場合は、以下の診断チェックを実行して、原因を特定してください。
ターミナルをスキップしたい場合は、Claude Code Desktop アプリを使用して、グラフィカルインターフェイスを通じて Claude Code をインストールして使用できます。macOSWindows用にダウンロードして、コマンドラインセットアップなしでコーディングを開始してください。Linux では、Linux インストール手順に従って apt でアプリをインストールしてください。

診断チェックを実行する

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

インストーラーは downloads.claude.ai からダウンロードします。到達可能であることを確認してください:
最初の行が 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_PROXYHTTP_PROXY をプロキシのアドレスに設定してください。プロキシ URL がわからない場合は IT チームに問い合わせるか、ブラウザのプロキシ設定を確認してください。 この例は両方のプロキシ変数を設定してから、プロキシを通じてインストーラーを実行します:

PATH を確認する

インストールが成功しても、claude を実行するときに command not found または not recognized エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では ~/.local/bin/claude に、Windows では %USERPROFILE%\.local\bin\claude.execlaude を配置します。
VS Code 拡張機能claude をこの場所に配置しません。拡張機能ディレクトリ内に CLI のプライベートコピーをバンドルし、独自のチャットパネル用に使用し、PATH に追加しません。拡張機能のみをインストールした場合、~/.local/bin/claude は存在しません。ターミナルから claude を使用するにはスタンドアロンインストールを実行してから、以下を続行してください。
インストールディレクトリが PATH に含まれているかどうかを確認するには、PATH エントリをリストして local/bin でフィルタリングしてください:
これが /Users/you/.local/bin または /home/you/.local/bin を出力する場合、ディレクトリは PATH に含まれており、競合するインストールを確認するにスキップできます。出力がない場合は、シェル設定に追加してください。macOS のデフォルトである Zsh の場合:
ほとんどの Linux ディストリビューションのデフォルトである Bash の場合:
または、ターミナルを閉じて再度開いてください。fish や Nushell などの他のシェルの場合は、シェル独自の設定構文を使用して ~/.local/bin を PATH に追加してから、ターミナルを再起動してください。修正が機能したことを確認してください:

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

複数の Claude Code インストールはバージョンの不一致または予期しない動作を引き起こす可能性があります。インストールされているものを確認してください:
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 を出力する場合、それはエラーではありません。その場所に何もインストールされていないことを意味するため、次のチェックに進んでください。
複数のインストールが見つかった場合は、1 つだけを保持してください。macOS/Linux の ~/.local/bin/claude または Windows の %USERPROFILE%\.local\bin\claude.exe でのネイティブインストールが推奨されます。余分なものを削除してください: npm グローバルインストールをアンインストールします:
レガシーローカル npm インストールを削除します:
macOS で Homebrew インストールを削除します。claude-code@latest cask をインストールした場合は、その名前に置き換えてください:
Windows で WinGet インストールを削除します:

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

インストーラーは macOS と Linux の ~/.local/bin/~/.claude/ への書き込みアクセスが必要です。Windows ではインストール場所は %USERPROFILE% の下にあり、デフォルトではユーザーが書き込み可能なため、このセクションはそこではほとんど適用されません。 ディレクトリが書き込み可能かどうかを確認してください:
いずれかのディレクトリが書き込み可能でない場合は、インストールディレクトリを作成し、ユーザーを所有者として設定してください:

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

claude --version がバージョンを出力しても claude がクラッシュまたはハングする場合は、これらのチェックを実行して原因を特定してください。claude --version がコマンドが見つからないと言う場合は、最初に PATH を確認するに移動してください。以下のコマンドは claude が PATH にあることを前提としています。 バイナリが存在し、実行可能であることを確認してください:
Linux では、不足している共有ライブラリを確認してください。ldd が不足しているライブラリを表示する場合は、システムパッケージをインストールする必要があるかもしれません。Alpine Linux およびその他の musl ベースのディストリビューションについては、Alpine Linux セットアップを参照してください。
バイナリが実行できることを確認してください:

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

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

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

インストールコマンドを実行するときに、次のいずれかのエラーが表示される場合があります:
PowerShell では、同じ問題は解析エラーとして表示され、iex が HTML と CSS を PowerShell として実行しようとします:
表現は PowerShell バージョンとシステム言語によって異なります。Missing expression after unary operator '--' または ParserErrorParseException が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS はこの失敗を識別します。代わりに -OutFile install.ps1 でダウンロードする場合、保存されたファイルは同じウェブページであるため、それも役に立ちません。 リクエストのルーティング方法によっては、HTML ボディなしの 403 が表示される場合があります:
これらはすべて、インストール URL がインストールスクリプトではなく HTML ページまたはエラーステータスを返したことを意味します。HTML ページが「App unavailable in region」と表示される場合、Claude Code はお客様の国では利用できません。サポートされている国を参照してください。 ボディなしの 403 は多くの場合同じ原因がありますが、企業プロキシまたはダウンロードをブロックしているファイアウォールからも発生する可能性があります。サポートされている国にいるのに 403 が表示される場合は、以下の代替インストーラーを試す前にネットワーク接続を確認するを実行してください。これらは同じホストに到達するためです。 それ以外の場合、これはネットワークの問題、地域的なルーティング、または一時的なサービス中断が原因で発生する可能性があります。 解決策:
  1. 別のインストール方法を使用してください macOS では、Homebrew 経由でインストールしてください:
    Windows では、WinGet 経由でインストールしてください:
    その後、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 が早期に終了したためです。 解決策:
  1. ネットワークの安定性を確認してください:Claude Code バイナリは downloads.claude.ai でホストされています。到達可能であることをテストしてください:
    HTTP/2 200 という行はサーバーに到達したことを意味し、元の失敗は一時的なものである可能性があります。インストールコマンドを再試行してください。他の結果は原因を指します:
    • 403:通常はプロキシまたはネットワークフィルターがホストをブロックしているか、Claude Code がお客様の地域では利用できません
    • 5xx:通常は一時的なサービス問題です。数分待ってから再試行してください
    • Could not resolve host または接続タイムアウト:ネットワークがダウンロードをブロックしています
  2. 別のインストール方法を試してください 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 の公開より前のものです。インデックスを更新して再試行してください:
Homebrew が予想より古い Claude Code バージョンをインストールする場合、通常は同じ古いインデックスが原因です。claude-code cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに brew install --cask claude-code@latest を実行してください。2 つの cask の違いについては、リリースチャネルを設定するを参照してください。

TLS または SSL 接続エラー

curl: (35) TLS connect errorschannel: next InitializeSecurityContext failed、または PowerShell の Could not establish trust relationship for the SSL/TLS secure channel などのエラーは TLS ハンドシェイク失敗を示します。 解決策:
  1. システム CA 証明書を更新してください Ubuntu/Debian では:
    macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。
  2. Windows では、インストーラーを実行する前に PowerShell で TLS 1.2 を有効にしてください
  3. プロキシまたはファイアウォール干渉を確認してください:TLS 検査を実行する企業プロキシは、unable to get local issuer certificateSELF_SIGNED_CERT_IN_CHAIN を含むこれらのエラーを引き起こす可能性があります。インストール手順では、インストールダウンロードを企業プロキシの CA に信頼させてください:
    インストール後の Claude Code 自体については、NODE_EXTRA_CA_CERTS を設定して API リクエストが同じバンドルを信頼するようにしてください:
    証明書ファイルがない場合は IT チームに問い合わせてください。また、直接接続で試して、プロキシが原因であることを確認することもできます。
  4. 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 recognizedThe token '&&' is not validA 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/Linux curl -fsSL ... | bash インストーラーを実行しました。ここで curlInvoke-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 で失敗する可能性があります:
npm インストール後に claude を実行すると、同じエラーが claude.ps1 に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する .ps1 ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、ダウンロードされたテキストを直接実行する PowerShell インストーラー irm https://claude.ai/install.ps1 | iex には影響しません。 解決策:
  1. ユーザーのローカルで作成されたスクリプトを許可してから、再試行してください
  2. .cmd ランチャーを呼び出してくださいnpm.cmdclaude.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 ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するのを待ってください。その後、ダウンロードフォルダーを削除してインストーラーを再度実行してください:

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

インストール中に Killed メッセージが表示される場合、通常は Linux のメモリ不足(OOM)キラーがシステムがメモリ不足になったため claude install ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります:
インストールには約 512 MB の空きメモリが必要で、Claude Code を実行するにはさらに多くが必要です。システム要件を参照してください。 解決策:
  1. RAM が限られている場合はスワップスペースを追加してください。スワップはディスク領域をオーバーフロー メモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。 2 GB スワップファイルを作成して有効にしてください:
    その後、インストールを再試行してください:
  2. インストール前に他のプロセスを閉じてメモリを解放してください
  3. 可能であれば、より大きなインスタンスを使用してください。Claude Code には少なくとも 4 GB の RAM が必要です。

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

Docker コンテナで Claude Code をインストールするときに、root として / にインストールするとハングが発生する可能性があります。 解決策:
  1. インストーラーを実行する前に作業ディレクトリを設定してください/ から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用を引き起こします。WORKDIR を設定すると、スキャンが小さなディレクトリに制限されます:
  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 コマンドを実行するためです。プラットフォームのコマンドを再実行してください:
claude --version は再実行がインストールしたバージョンを出力します。

claude update または claude doctor がハング

claude updateclaude 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 updateChecking for updates を出力した直後にハングしました。 以前のバージョンでハングに直面した場合は、ディレクトリを見つけてください。このコマンドの出力では、d で始まる行はそのパスをディレクトリとしてマークします。No such file or directory という行は、そのパスに何も存在せず、原因ではないことを意味します:
ディレクトリを脇に移動するか、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\GitC:\Program Files (x86)\Git
  2. PATH 上の git。そのインストールから bin\bash.exe を使用します。
ステップ 2 では、Claude Code を起動したフォルダーに存在する git、またはそのフォルダーの下の node_modules または .venvenv などの仮想環境フォルダーを含むパスをスキップします。例えば、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.exesh.exebash、または 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.exebash.exe を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。

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

Windows のスタートメニューには 2 つの PowerShell エントリが含まれています:Windows PowerShellWindows 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 などの不足している共有ライブラリに関するエラーが表示される場合、インストーラーはシステムに対応した間違ったバイナリバリアントをダウンロードした可能性があります。
これは、musl クロスコンパイルパッケージがインストールされている glibc ベースのシステムで発生する可能性があり、インストーラーがシステムを musl として誤検出します。 解決策:
  1. システムが使用している libc を確認してください
    GNU libc または GLIBC に言及している出力は glibc を意味します。musl に言及している出力は musl を意味します。
  2. glibc にいるが musl バイナリを取得した場合、インストールを削除して再インストールしてください。https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。ldd --versionls /lib/libc.musl* の出力を含めて GitHub issue をファイルしてください。
  3. 実際に 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 founddyld: cannot load、または Abort trap: 6 が表示される場合、バイナリは macOS バージョンまたはハードウェアと互換性がありません。 Symbol not found エラーが libicucore を参照する場合、macOS バージョンがバイナリがサポートするより古いことを意味します:
ローダーは代わりにバイナリのロードコマンドを拒否する可能性があり、これは macOS バージョンが古すぎることも意味します:
解決策:
  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 に変換することです:
WSL1 にとどまる必要がある場合は、動的リンカーを通じてバイナリを呼び出してください。ホームディレクトリが異なる場合はパスを置き換えて、WSL 内の ~/.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 npmwhich node で確認してください:/mnt/c/ で始まるパスは Windows バイナリで、Linux パスは /usr/ で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは nvm 経由で Node をインストールしてください。 nvm バージョンの競合。 WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL はデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを ~/.bashrc または ~/.zshrc に追加してください:
または現在のセッションで読み込んでください:
nvm が読み込まれているが Windows パスがまだ優先される場合は、Linux Node パスを明示的に先頭に追加してください:
appendWindowsPath = false で Windows PATH インポートを無効にすることは避けてください。これは WSL から Windows 実行可能ファイルを呼び出す機能を破壊します。同様に、Windows 開発に使用する場合は Windows から Node.js をアンインストールすることは避けてください。

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

ネイティブインストーラーが権限エラーで失敗する場合、ターゲットディレクトリが書き込み可能でない可能性があります。ディレクトリ権限を確認するを参照してください。 以前に npm でインストールしていて、npm 固有の権限エラーに直面している場合は、ネイティブインストーラーに切り替えてください:

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

@anthropic-ai/claude-code npm パッケージは、@anthropic-ai/claude-code-darwin-arm64 などのプラットフォーム固有のオプション依存関係を通じてネイティブバイナリを取得します。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを claude コマンドとして所定の位置にコピーします。実行されるまで、claude はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーは所定の位置に留まり、macOS と Linux で claude を実行すると出力されます:
Windows では、bin/claude.exe はその同じシェルスクリプトプレースホルダーであり、実際の実行可能ファイルではないため、PowerShell と CMD はこのメッセージを出力する代わりにファイルを実行できないと報告します。 次の原因を確認してください:
  • オプション依存関係が無効になっています。 npm インストールコマンドから --omit=optional を削除し、pnpm から --no-optional を削除し、yarn から --ignore-optional を削除し、.npmrcoptional=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-arm64darwin-x64linux-x64linux-arm64linux-x64-musllinux-arm64-muslwin32-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 でノードバージョンを切り替えたため)、エラーが名前を付けるディレクトリを削除してください:
その後、残っているテンポラリディレクトリを削除してください。zsh が no matches found を出力する場合、削除するものはありませんでした:
その後、再インストールしてください:
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 フラグを使用した非対話モードでは、存在する場合、キーは常に使用されます。認証の優先順位 を参照して、完全な解決順序を確認してください。 代わりにサブスクリプションを使用するには、環境変数を設定解除し、シェルプロファイルから削除してください:
~/.zshrc~/.bashrc、または ~/.profileexport 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 を使用してください:
このフォールバックは、ネイティブ 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 に戻すには:
1

Keychain アクセスを確認する

claude doctor を実行して Keychain アクセスを確認してください。Keychain が書き込みを拒否する場合、レポートは macOS Keychain is not writable で始まる警告をリストし、その後に推奨される修正を示します。レポートに Keychain 警告がリストされていない場合、Keychain は書き込み可能であり、最後のステップにスキップできます。
2

Keychain をロック解除する

コマンドが 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 認証情報が有効であることを確認してください:
Google Cloud の Agent Platform の場合、ANTHROPIC_VERTEX_PROJECT_IDCLOUD_ML_REGION がシェルに設定されていることを確認してから、アプリケーションのデフォルト認証情報を設定してください:
Microsoft Foundry の場合、ANTHROPIC_FOUNDRY_API_KEY が設定されていることを確認するか、Azure CLI でサインインして、デフォルト認証情報チェーンがアカウントを見つけられるようにしてください:
認証情報がターミナルで機能するが VS Code または JetBrains 拡張機能では機能しない場合、IDE プロセスはおそらくシェル環境を継承していません。IDE 独自の設定でプロバイダー環境変数を設定するか、既にエクスポートされているターミナルから IDE を起動してください。 完全なプロバイダーセットアップについては、Amazon BedrockGoogle 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を参照してください。