Claude Code トラブルシューティング

settings.json エラーで起動しない

症状: hooksエラーが表示されて設定がスキップされる
原因: hooksの構造が間違っている
NG（直接command）OK（hooks配列内）
{ "matcher":"",
  "command":"script.sh",
  "timeout":5000 }
 
{ "matcher":"",
  "hooks":[{
    "type":"command",
    "command":"script.sh",
    "timeout":5000
  }]}
全hookエントリに hooks: [{"type":"command","command":"..."}] 構造が必要

コンテキストウィンドウ超過

症状: 会話が長すぎてエラーになる
対処:
1. /compact で会話を要約
2. /clear で会話履歴をリセット
3. 新しいセッションを開始
長い作業は適宜 /compact で節約するのがコツ

MCPサーバー接続エラー

症状: MCP tool not found や connection error
対処:
1. settings.jsonのmcpServers設定を確認
2. コマンドパスが正しいか確認: which コマンド名
3. APIキーが有効か確認
4. Claude Codeを再起動

権限エラー（Permission denied）

症状: ツール実行時に権限確認が出続ける
対処:
1. settings.jsonの defaultMode を確認
2. permissions.allow に対象コマンドを追加
3. bypassPermissions で全許可も可能（個人開発向け）

レート制限（Rate limit）

症状: 429 Too Many Requests エラー
対処:
1. 少し待ってから再実行
2. ローカルプロキシ（glm_rate_proxy等）で制御
3. フォールバックモデルに切り替え

応答が遅い・止まってる

対処:
1. Esc で現在の応答をキャンセル
2. ネットワーク接続を確認
3. /model で別モデルに切り替え
4. tmuxを使っているならセッションは維持される

CLAUDE.mdが読み込まれない

原因: カレントディレクトリが間違っている
対処: プロジェクトディレクトリで起動する
cd ~/projects/my-project && claude

スマホからのSSH接続トラブル

症状原因対処
Software caused connection abort一時的な通信エラーping 100.115.156.98 で確認後、SSH再試行
Connection timed outPCがスリープ or TailscaleオフラインPC画面をつける / Tailscale起動確認
tmux: not foundTermux（スマホ側）に入力してるPC側で実行: 先にSSHで入ってから
wsl: not foundTermuxはLinux（WSLではない）PC側のコマンド。SSHで入ってから使う
接続切れてClaudeが消えたtmuxを使っていない次回から tmux new -s claude 経由で起動
← ガイド一覧に戻る