トラブルシューティング集
Claude Code を使っていてよくある問題と対処法をまとめています。
インストール関連
「claude が認識されません」（Windows）
claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、
または操作可能なプログラムの名前として認識されません。対処法:
- PowerShell を閉じて開き直す
- パソコンを再起動する
- インストールコマンドを再実行する
- PATH に
%USERPROFILE%\.claude\local\binを手動追加する
「command not found: claude」（Mac）
zsh: command not found: claude対処法:
- ターミナルを ⌘ + Q で閉じて開き直す
source ~/.zshrcを実行する- インストールコマンド
curl -fsSL https://claude.ai/install.sh | bashを再実行する - パソコンを再起動する
PowerShell でスクリプト実行が禁止される（Windows）
このシステムではスクリプトの実行が無効になっているため...対処法:
powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned「curl: command not found」（Mac）
bash
xcode-select --installポップアップが表示されるので「インストール」をクリックします。
認証関連
ログインできない
- インターネット接続を確認する
- ブラウザで claude.ai にログインできるか確認する
/logoutでログアウトしてから再ログインする- Claude のサブスクリプション（Pro / Max 等）が有効か確認する
「You've exceeded your usage limit」
利用量の上限に達しています。
- Pro プランの場合: 一定時間待つ
- Max プランへのアップグレードを検討する
/costでトークン使用量を確認する
Git 関連
「'git' is not recognized」（Windows）
Git for Windows がインストールされていません。gitforwindows.org からインストールしてください。
push が拒否された
! [rejected] main -> main (fetch first)リモートに自分が持っていない変更があります。
bash
git pull # まず最新を取得
git push # その後に送信認証エラー（GitHub）
remote: Support for password authentication was removedパスワード認証が廃止されています。パーソナルアクセストークンまたは SSH で接続してください。
ネットワーク関連
接続エラー
Unable to connect to the remote server- インターネット接続を確認する
- VPN を使っている場合は一時的にオフにする
- 会社のプロキシ/ファイアウォールが原因の場合は IT 部門に相談する
応答が遅い
- インターネット接続の速度を確認する
- サーバーが混雑している場合は時間をおいて再試行する
/compactで会話履歴を圧縮してトークンを節約する
Claude Code の動作関連
/doctor で診断する
何か問題がある場合は /doctor コマンドで状態を確認できます。問題が検出された場合は修正方法が表示されます。
Permission denied（Mac）
bash
sudo curl -fsSL https://claude.ai/install.sh | bashMac のログインパスワードを入力します。
MCP サーバーが接続できない
.claude/settings.jsonの設定を確認する- トークンが有効か確認する
npx -y <package>でサーバーを直接実行してエラーを確認する- Claude Code を再起動する