メインコンテンツへスキップ

​
インストール問題のトラブルシューティング

ターミナルを完全にスキップしたい場合は、Claude Code デスクトップアプリを使用して、グラフィカルインターフェイスを通じて Claude Code をインストールおよび使用できます。macOSまたはWindows用にダウンロードして、コマンドラインセットアップなしでコーディングを開始します。
表示されているエラーメッセージまたは症状を見つけます：
表示内容解決策
command not found: claude または 'claude' is not recognizedPATH を修正する
syntax error near unexpected token '<'インストールスクリプトが HTML を返す
curl: (56) Failure writing output to destinationスクリプトをダウンロードしてから実行する
Linux でのインストール中に Killed低メモリサーバーにスワップスペースを追加する
TLS connect error または SSL/TLS secure channelCA 証明書を更新する
Failed to fetch version またはダウンロードサーバーに到達できないネットワークとプロキシ設定を確認する
irm is not recognized または && is not validシェルに適切なコマンドを使用する
Claude Code on Windows requires git-bashGit Bash をインストールまたは設定する
Error loading shared libraryシステムに適切なバイナリバリアントをインストールする
Linux での Illegal instructionアーキテクチャの不一致
macOS での dyld: cannot load または Abort trapバイナリの互換性
Invoke-Expression: Missing argument in parameter listインストールスクリプトが HTML を返す
App unavailable in regionClaude Code はお客様の国では利用できません。サポートされている国を参照してください。
unable to get local issuer certificate企業 CA 証明書を設定する
OAuth error または 403 Forbidden認証を修正する
問題がリストに記載されていない場合は、これらの診断手順を実行してください。

​
インストール問題のデバッグ

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

インストーラーは storage.googleapis.com からダウンロードします。到達可能であることを確認します： 
curl -sI https://storage.googleapis.com
これが失敗する場合、ネットワークが接続をブロックしている可能性があります。一般的な原因：
  • Google Cloud Storage をブロックしている企業ファイアウォールまたはプロキシ
  • 地域的なネットワーク制限：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

​
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 local/bin
出力がない場合、ディレクトリが見つかりません。シェル設定に追加します：
# Zsh (macOS デフォルト)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux デフォルト)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
または、ターミナルを閉じて再度開きます。修正が機能したことを確認します：
claude --version

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

複数の Claude Code インストールはバージョンの不一致または予期しない動作を引き起こす可能性があります。インストールされているものを確認します：
PATH に見つかったすべての claude バイナリをリストします：
which -a claude
ネイティブインストーラーと npm バージョンが存在するかどうかを確認します：
ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null
複数のインストールが見つかった場合は、1 つだけを保持します。~/.local/bin/claude でのネイティブインストールが推奨されます。余分なインストールを削除します： npm グローバルインストールをアンインストールします： 
npm uninstall -g @anthropic-ai/claude-code
macOS で Homebrew インストールを削除します： 
brew uninstall --cask claude-code

​
ディレクトリのアクセス許可を確認する

インストーラーは ~/.local/bin/ と ~/.claude/ への書き込みアクセスが必要です。インストールがアクセス許可エラーで失敗する場合、これらのディレクトリが書き込み可能かどうかを確認します： 
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 がインストールされているがスタートアップでクラッシュまたはハングする場合、これらのチェックを実行して原因を絞り込みます。 バイナリが存在し、実行可能であることを確認します： 
ls -la $(which claude)
Linux では、不足している共有ライブラリを確認します。ldd が不足しているライブラリを表示する場合、システムパッケージをインストールする必要があります。Alpine Linux およびその他の musl ベースのディストリビューションについては、Alpine Linux セットアップを参照してください。 
ldd $(which claude) | grep "not found"
バイナリが実行できることを確認するための簡単なサニティチェックを実行します： 
claude --version

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

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

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

インストールコマンドを実行すると、次のいずれかのエラーが表示される場合があります： 
bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'
PowerShell では、同じ問題は次のように表示されます： 
Invoke-Expression: Missing argument in parameter list.
これは、インストール URL がインストールスクリプトではなく HTML ページを返したことを意味します。HTML ページに「App unavailable in region」と表示されている場合、Claude Code はお客様の国では利用できません。サポートされている国を参照してください。 それ以外の場合、これはネットワークの問題、地域的なルーティング、または一時的なサービス中断が原因で発生する可能性があります。 解決策：
  1. 別のインストール方法を使用する： macOS または Linux では、Homebrew 経由でインストールします： 
    brew install --cask claude-code
    Windows では、WinGet 経由でインストールします： 
    winget install Anthropic.ClaudeCode
  2. 数分後に再試行する：問題は一時的なことが多いです。待ってから元のコマンドを再度試してください。

​
インストール後の command not found: claude

インストールが完了しましたが、claude が機能しません。正確なエラーはプラットフォームによって異なります：
プラットフォームエラーメッセージ
macOSzsh: command not found: claude
Linuxbash: claude: command not found
Windows CMD'claude' is not recognized as an internal or external command
PowerShellclaude : The term 'claude' is not recognized as the name of a cmdlet
これは、インストールディレクトリがシェルの検索パスに含まれていないことを意味します。各プラットフォームの修正については、PATH を確認するを参照してください。

​
curl: (56) Failure writing output to destination

curl ... | bash コマンドはスクリプトをダウンロードし、パイプ（|）を使用して Bash に直接実行するために渡します。このエラーは、スクリプトのダウンロードが完了する前に接続が切断されたことを意味します。一般的な原因には、ネットワーク中断、ダウンロードがストリーム中にブロックされた、またはシステムリソースの制限が含まれます。 解決策：
  1. ネットワークの安定性を確認する：Claude Code バイナリは Google Cloud Storage でホストされています。到達可能であることをテストします： 
    curl -fsSL https://storage.googleapis.com -o /dev/null
    コマンドが静かに完了する場合、接続は問題なく、問題は一時的である可能性があります。インストールコマンドを再試行してください。エラーが表示される場合、ネットワークがダウンロードをブロックしている可能性があります。
  2. 別のインストール方法を試す： macOS または Linux： 
    brew install --cask claude-code
    Windows： 
    winget install Anthropic.ClaudeCode

​
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（Homebrew 経由）： 
    brew install ca-certificates
  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 を含むこれらのエラーを引き起こす可能性があります。NODE_EXTRA_CA_CERTS を企業 CA 証明書バンドルに設定します： 
    export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
    証明書ファイルがない場合は IT チームに問い合わせてください。直接接続でも試して、プロキシが原因であることを確認できます。

​
Failed to fetch version from storage.googleapis.com

インストーラーがダウンロードサーバーに到達できませんでした。これは通常、storage.googleapis.com がネットワークでブロックされていることを意味します。 解決策：
  1. 接続を直接テストする： 
    curl -sI https://storage.googleapis.com
  2. プロキシの背後にいる場合、HTTPS_PROXY を設定して、インストーラーがそれを通じてルーティングできるようにします。詳細については、プロキシ設定を参照してください。 
    export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
  3. 制限されたネットワーク上にいる場合、別のネットワークまたは VPN を試すか、別のインストール方法を使用します： macOS または Linux： 
    brew install --cask claude-code
    Windows： 
    winget install Anthropic.ClaudeCode

​
Windows：irm または && が認識されない

'irm' is not recognized または The token '&&' is not valid が表示される場合、シェルに対して間違ったコマンドを実行しています。
  • 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

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

VPS またはクラウドインスタンスでインストール中に Killed が表示される場合： 
Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Linux OOM キラーがプロセスを終了しました。システムがメモリ不足になったためです。Claude Code には少なくとも 4 GB の利用可能な RAM が必要です。 解決策：
  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 をインストールする場合、ルートとして / にインストールするとハングが発生する可能性があります。 解決策：
  1. インストーラーを実行する前に作業ディレクトリを設定する。/ から実行すると、インストーラーはファイルシステム全体をスキャンし、メモリ使用量が過剰になります。WORKDIR を設定すると、スキャンが小さなディレクトリに制限されます： 
    WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash
  2. Docker メモリ制限を増やす（Docker Desktop を使用している場合）： 
    docker build --memory=4g .

​
Windows：Claude Desktop が claude CLI コマンドをオーバーライドする

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

​
Windows：「Claude Code on Windows requires git-bash」

ネイティブ Windows の Claude Code には、Git Bash を含むGit for Windowsが必要です。 Git がインストールされていない場合、git-scm.com/downloads/winからダウンロードしてインストールします。セットアップ中に「Add to PATH」を選択します。インストール後、ターミナルを再起動します。 Git が既にインストールされているが Claude Code がそれを見つけられない場合は、settings.json ファイルでパスを設定します： 
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Git が別の場所にインストールされている場合は、PowerShell で where.exe git を実行してパスを見つけ、そのディレクトリから bin\bash.exe パスを使用します。

​
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 /bin/ls | head -1
    linux-vdso.so または /lib/x86_64-linux-gnu/ への参照が表示される場合、glibc を使用しています。musl が表示される場合、musl を使用しています。
  2. glibc を使用しているが musl バイナリを取得した場合、インストールを削除して再インストールします。GCS バケット https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json から正しいバイナリを手動でダウンロードすることもできます。ldd /bin/ls と ls /lib/libc.musl* の出力を含むGitHub issueを提出してください。
  3. 実際に musl を使用している場合（Alpine Linux）、必要なパッケージをインストールします： 
    apk add libgcc libstdc++ ripgrep

​
Linux での Illegal instruction

インストーラーが OOM Killed メッセージではなく Illegal instruction を出力する場合、ダウンロードされたバイナリが CPU アーキテクチャと一致しません。これは、ARM サーバーが x86 バイナリを受け取った場合、または必要な命令セットがない古い CPU で一般的に発生します。 
bash: line 142: 2238232 Illegal instruction    "$binary_path" install ${TARGET:+"$TARGET"}
解決策：
  1. アーキテクチャを確認する： 
    uname -m
    x86_64 は 64 ビット Intel/AMD を意味し、aarch64 は ARM64 を意味します。バイナリが一致しない場合は、出力を含むGitHub issueを提出してください。
  2. アーキテクチャの問題が解決されている間、別のインストール方法を試す： 
    brew install --cask claude-code

​
macOS での dyld: cannot load

インストール中に dyld: cannot load または Abort trap: 6 が表示される場合、バイナリは 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 バージョンがサポートしていないロードコマンドを使用しています。
  3. 別のインストール方法として Homebrew を試す： 
    brew install --cask claude-code

​
Windows インストール問題：WSL でのエラー

WSL で次の問題が発生する可能性があります： OS/プラットフォーム検出の問題：インストール中にエラーが発生する場合、WSL は Windows npm を使用している可能性があります。試してください：
  • インストール前に npm config set os linux を実行する
  • npm install -g @anthropic-ai/claude-code --force --no-os-check でインストールする。sudo を使用しないでください。
Node が見つからないエラー：claude を実行するときに exec: node: not found が表示される場合、WSL 環境は Windows インストールの Node.js を使用している可能性があります。which npm と which node で確認できます。これらは /usr/ で始まる Linux パスではなく /mnt/c/ を指す必要があります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたはnvm経由で Node をインストールしてみてください。 nvm バージョンの競合：WSL と Windows の両方に nvm がインストールされている場合、WSL で Node バージョンを切り替えるときにバージョンの競合が発生する可能性があります。これは WSL がデフォルトで Windows PATH をインポートするため、Windows nvm/npm が WSL インストールより優先されるためです。 この問題は以下で識別できます：
  • which npm と which node を実行する - /mnt/c/ で始まる Windows パスを指す場合、Windows バージョンが使用されています
  • WSL で nvm を使用してノードバージョンを切り替えた後、機能が破損する
この問題を解決するには、Linux PATH を修正して、Linux ノード/npm バージョンが優先されるようにします： 主要な解決策：nvm がシェルに適切にロードされていることを確認する 最も一般的な原因は、nvm が非対話型シェルにロードされていないことです。シェル設定ファイル（~/.bashrc、~/.zshrc など）に以下を追加します： 
# nvm が存在する場合はロードする
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
代替案：PATH の順序を調整する nvm が適切にロードされているが Windows パスがまだ優先される場合、シェル設定で Linux パスを PATH の先頭に明示的に追加できます： 
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
appendWindowsPath = false で Windows PATH インポートを無効にすることは避けてください。これは WSL から Windows 実行可能ファイルを呼び出す機能を破壊します。同様に、Windows 開発に使用する場合は Windows から Node.js をアンインストールすることは避けてください。

​
WSL2 サンドボックスセットアップ

サンドボックスは WSL2 でサポートされていますが、追加のパッケージをインストールする必要があります。/sandbox を実行するときに「Sandbox requires socat and bubblewrap」というエラーが表示される場合は、依存関係をインストールします： 
sudo apt-get install bubblewrap socat
WSL1 はサンドボックスをサポートしていません。「Sandboxing requires WSL2」が表示される場合は、WSL2 にアップグレードするか、サンドボックスなしで Claude Code を実行する必要があります。

​
インストール中のアクセス許可エラー

ネイティブインストーラーがアクセス許可エラーで失敗する場合、ターゲットディレクトリが書き込み可能でない可能性があります。ディレクトリのアクセス許可を確認するを参照してください。 以前に npm でインストールしており、npm 固有のアクセス許可エラーが発生している場合は、ネイティブインストーラーに切り替えます： 
curl -fsSL https://claude.ai/install.sh | bash

​
アクセス許可と認証

これらのセクションでは、ログイン失敗、トークンの問題、およびアクセス許可プロンプトの動作に対処します。

​
繰り返されるアクセス許可プロンプト

同じコマンドを繰り返し承認する必要がある場合は、/permissions コマンドを使用して、特定のツールが承認なしで実行されるようにできます。アクセス許可ドキュメントを参照してください。

​
認証の問題

認証の問題が発生している場合：
  1. /logout を実行して完全にサインアウトします
  2. Claude Code を閉じます
  3. claude で再起動して、認証プロセスを再度完了します
ブラウザがログイン中に自動的に開かない場合は、c を押して OAuth URL をクリップボードにコピーし、手動でブラウザに貼り付けます。

​
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でサブスクリプションがアクティブであることを確認します
  • Console ユーザー：管理者によって「Claude Code」または「Developer」ロールが割り当てられていることを確認します
  • プロキシの背後：企業プロキシは API リクエストに干渉する可能性があります。ネットワーク設定でプロキシセットアップを参照してください。

​
WSL2 での OAuth ログイン失敗

WSL2 でのブラウザベースのログインは、WSL が Windows ブラウザを開くことができない場合に失敗する可能性があります。BROWSER 環境変数を設定します： 
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude
または URL を手動でコピーします：ログインプロンプトが表示されたら、c を押して OAuth URL をコピーし、Windows ブラウザに貼り付けます。

​
「ログインしていません」またはトークンの期限切れ

Claude Code がセッション後に再度ログインするよう求める場合、OAuth トークンが期限切れになった可能性があります。 /login を実行して再認証します。これが頻繁に発生する場合は、システムクロックが正確であることを確認してください。トークン検証は正確なタイムスタンプに依存しています。

​
設定ファイルの場所

Claude Code は複数の場所に設定を保存します：
ファイル目的
~/.claude/settings.jsonユーザー設定（アクセス許可、フック、モデルオーバーライド）
.claude/settings.jsonプロジェクト設定（ソース管理にチェックイン）
.claude/settings.local.jsonローカルプロジェクト設定（コミットされない）
~/.claude.jsonグローバル状態（テーマ、OAuth、MCP サーバー）
.mcp.jsonプロジェクト MCP サーバー（ソース管理にチェックイン）
managed-mcp.json管理対象 MCP サーバー
管理対象設定管理対象設定（サーバー管理、MDM/OS レベルのポリシー、またはファイルベース）
Windows では、~ はユーザーホームディレクトリ（C:\Users\YourName など）を指します。 これらのファイルの設定の詳細については、設定とMCPを参照してください。

​
設定をリセットする

Claude Code をデフォルト設定にリセットするには、設定ファイルを削除できます： 
# すべてのユーザー設定と状態をリセット
rm ~/.claude.json
rm -rf ~/.claude/

# プロジェクト固有の設定をリセット
rm -rf .claude/
rm .mcp.json
これにより、すべての設定、MCP サーバー設定、およびセッション履歴が削除されます。

​
パフォーマンスと安定性

これらのセクションでは、リソース使用量、応答性、および検索動作に関連する問題について説明します。

​
CPU またはメモリ使用量が多い

Claude Code はほとんどの開発環境で動作するように設計されていますが、大規模なコードベースを処理する場合、かなりのリソースを消費する可能性があります。パフォーマンスの問題が発生している場合：
  1. /compact を定期的に使用してコンテキストサイズを削減します
  2. 主要なタスク間で Claude Code を閉じて再起動します
  3. 大規模なビルドディレクトリを .gitignore ファイルに追加することを検討してください

​
コマンドがハングまたはフリーズする

Claude Code が応答しないように見える場合：
  1. Ctrl+C を押して現在の操作をキャンセルしてみます
  2. 応答しない場合は、ターミナルを閉じて再起動する必要があります

​
検索と発見の問題

Search ツール、@file メンション、カスタムエージェント、およびカスタムスキルが機能していない場合は、システム ripgrep をインストールします： 
# macOS (Homebrew)  
brew install ripgrep

# Windows (winget)
winget install BurntSushi.ripgrep.MSVC

# Ubuntu/Debian
sudo apt install ripgrep

# Alpine Linux
apk add ripgrep

# Arch Linux
pacman -S ripgrep
その後、環境で USE_BUILTIN_RIPGREP=0 を設定します。

​
WSL での遅い、または不完全な検索結果

WSL でファイルシステム間で作業する場合のディスク読み取りパフォーマンスペナルティにより、WSL で Claude Code を使用する場合、Search ツール使用時に予想より少ないマッチが返される可能性があります。検索は機能しますが、ネイティブファイルシステムより少ない結果を返します。
この場合、/doctor は Search を OK として表示します。
解決策：
  1. より具体的な検索を送信する：検索するファイル数を減らすために、ディレクトリまたはファイルタイプを指定します：「auth-service パッケージで JWT 検証ロジックを検索」または「JS ファイルで md5 ハッシュの使用を見つける」。
  2. プロジェクトを Linux ファイルシステムに移動する：可能であれば、プロジェクトが Windows ファイルシステム（/mnt/c/）ではなく Linux ファイルシステム（/home/）に配置されていることを確認します。
  3. ネイティブ Windows を使用する：WSL ではなく Windows でネイティブに Claude Code を実行することを検討して、ファイルシステムのパフォーマンスを向上させます。

​
IDE 統合の問題

Claude Code が IDE に接続しない場合、または IDE ターミナル内で予期しない動作をする場合は、以下の解決策を試してください。

​
WSL2 で JetBrains IDE が検出されない

WSL2 で Claude Code を使用していて、JetBrains IDE を使用している場合、「No available IDEs detected」エラーが表示される場合、これは WSL2 のネットワーク設定または Windows ファイアウォールが接続をブロックしている可能性があります。

​
WSL2 ネットワークモード

WSL2 はデフォルトで NAT ネットワークを使用し、IDE 検出を妨げる可能性があります。2 つのオプションがあります： オプション 1：Windows ファイアウォールを設定する（推奨）
  1. WSL2 IP アドレスを見つけます： 
    wsl hostname -I
# 出力例：172.21.123.45
  2. 管理者として PowerShell を開き、ファイアウォールルールを作成します： 
    New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16
    ステップ 1 の WSL2 サブネットに基づいて IP 範囲を調整します。
  3. IDE と Claude Code の両方を再起動します
オプション 2：ミラーリングネットワークに切り替える Windows ユーザーディレクトリの .wslconfig に追加します： 
[wsl2]
networkingMode=mirrored
その後、PowerShell から wsl --shutdown で WSL を再起動します。
これらのネットワーク問題は WSL2 にのみ影響します。WSL1 はホストのネットワークを直接使用し、これらの設定は必要ありません。
JetBrains の追加設定のヒントについては、JetBrains IDE ガイドを参照してください。

​
Windows IDE 統合の問題を報告する

Windows で IDE 統合の問題が発生している場合は、次の情報を含むissue を作成してください：
  • 環境タイプ：ネイティブ Windows（Git Bash）または WSL1/WSL2
  • WSL ネットワークモード（該当する場合）：NAT またはミラーリング
  • IDE 名とバージョン
  • Claude Code 拡張機能/プラグインバージョン
  • シェルタイプ：Bash、Zsh、PowerShell など

​
JetBrains IDE ターミナルで Escape キーが機能しない

Claude Code を JetBrains ターミナルで使用していて、Esc キーがエージェントを中断しない場合、これは JetBrains のデフォルトショートカットとのキーバインディングの競合が原因である可能性があります。 この問題を修正するには：
  1. 設定 → ツール → ターミナルに移動します
  2. 次のいずれかを実行します：
    • 「Move focus to the editor with Escape」をオフにするか、
    • 「Configure terminal keybindings」をクリックして「Switch focus to Editor」ショートカットを削除します
  3. 変更を適用します
これにより、Esc キーが Claude Code 操作を適切に中断できるようになります。

​
Markdown フォーマットの問題

Claude Code は、コードフェンスに言語タグがない Markdown ファイルを生成することがあります。これは GitHub、エディター、およびドキュメントツールでの構文強調表示と読みやすさに影響します。

​
コードブロックに言語タグがない

生成された Markdown で次のようなコードブロックに気付いた場合： 
```
function example() {
  return "hello";
}
```text
適切にタグ付けされたブロックの代わりに： 
```javascript
function example() {
  return "hello";
}
```text
解決策：
  1. Claude に言語タグを追加するよう依頼する：「このマークダウンファイルのすべてのコードブロックに適切な言語タグを追加してください」とリクエストします。
  2. 編集後の自動フォーマットフック を使用する：言語タグがないコードブロックを検出して追加するための自動フォーマットフックを設定します。編集後のコード自動フォーマットの例を参照してください。
  3. 手動検証：Markdown ファイルを生成した後、適切なコードブロックフォーマットを確認し、必要に応じて修正をリクエストします。

​
一貫性のないスペースとフォーマット

生成された Markdown に過度な空行または一貫性のないスペースがある場合： 解決策：
  1. フォーマット修正をリクエストする：Claude に「このマークダウンファイルのスペースとフォーマットの問題を修正してください」とリクエストします。
  2. フォーマットツールを使用する：prettier またはカスタムフォーマットスクリプトなどの Markdown フォーマッターを実行するフックを設定します。
  3. フォーマット設定を指定する：プロンプトまたはプロジェクトメモリファイルにフォーマット要件を含めます。

​
Markdown フォーマットの問題を減らす

フォーマットの問題を最小化するには：
  • リクエストで明示的にする：「言語タグ付きコードブロック付きの適切にフォーマットされた Markdown」を要求します
  • プロジェクト規約を使用する：CLAUDE.mdで推奨される Markdown スタイルを文書化します
  • 検証フックを設定する：一般的なフォーマットの問題を自動的に検証および修正するための後処理フックを使用します

​
さらにヘルプを得る

ここで説明されていない問題が発生している場合：
  1. Claude Code 内で /bug コマンドを使用して、Anthropic に問題を直接報告します
  2. GitHub リポジトリで既知の問題を確認します
  3. /doctor を実行して問題を診断します。以下をチェックします：
    • インストールタイプ、バージョン、および検索機能
    • 自動更新ステータスと利用可能なバージョン
    • 無効な設定ファイル（不正な形式の JSON、不正な型）
    • MCP サーバー設定エラー
    • キーバインディング設定の問題
    • コンテキスト使用量の警告（大規模な CLAUDE.md ファイル、高い MCP トークン使用量、到達不可能なアクセス許可ルール）
    • プラグインとエージェントのロードエラー
  4. Claude に直接その機能と機能について質問します - Claude はドキュメントへの組み込みアクセスを持っています