トラブルシューティング

よくある問題と解決方法をまとめています。

環境構築

Claude Codeがインストールできない

症状: npm install -g @anthropic-ai/claude-code でエラー

解決策:

1. Node.jsがインストールされているか確認

   node --version

2. インストールされていない場合は Node.js をインストール
3. 権限エラーの場合は sudo をつけて実行（Mac）

   sudo npm install -g @anthropic-ai/claude-code

GitHubに接続できない

症状: ssh -T git@github.com でエラー

解決策:

1. SSHキーが設定されているか確認

   ls ~/.ssh/id_ed25519.pub

2. なければClaude Codeに「GitHubにSSHキーを設定して」と依頼
3. GitHubのSettings → SSH and GPG keys でキーが登録されているか確認

開発中

画面が真っ白

原因: JavaScriptエラーが発生している

解決策:

1. ブラウザの開発者ツールを開く（F12 または Command+Option+I）
2. Consoleタブでエラーを確認
3. エラーメッセージをClaude Codeに貼り付けて修正依頼

npm run dev でエラー

よくあるエラー:

エラー	原因	解決策
MODULE_NOT_FOUND	パッケージ不足	npm install を実行
EADDRINUSE	ポートが使用中	他のターミナルを閉じるか、ポートを変更
ENOENT	ファイルがない	パスを確認、ファイルを作成

データベース接続エラー

症状: 「connection refused」「timeout」など

解決策:

1. .env.local に環境変数が設定されているか確認
2. Vercelダッシュボードでデータベースが作成されているか確認
3. 環境変数の値が正しいかコピーし直す

変更が反映されない

解決策:

1. ブラウザをハードリフレッシュ
   • Mac: Command + Shift + R
   • Windows: Ctrl + Shift + R
2. 開発サーバーを再起動
   • ターミナルで Ctrl + C で停止
   • npm run dev で再起動
3. キャッシュをクリア

   rm -rf .next
   npm run dev

デプロイ

Vercelでビルドエラー

解決策:

1. エラーログを確認（Vercelダッシュボード → Deployments → 該当のデプロイ）
2. よくある原因：
   • 環境変数が設定されていない
   • TypeScriptの型エラー
   • importのパスが間違っている
3. エラーメッセージをClaude Codeに貼り付けて修正依頼

本番環境だけエラー

原因: 環境変数が本番に設定されていない

解決策:

1. Vercelダッシュボード → Settings → Environment Variables
2. ローカルの .env.local と同じ変数を設定
3. 再デプロイ

デプロイ後にデータベースエラー

解決策:

1. Vercel Storage でデータベースが接続されているか確認
2. 「Connect to Project」でプロジェクトに接続
3. 再デプロイ

その他

ターミナルが固まった

解決策:

1. Ctrl + C で処理を中断
2. それでもダメなら新しいターミナルウィンドウを開く

Claude Codeが応答しない

解決策:

1. インターネット接続を確認
2. Claude Codeを再起動（Ctrl + C → claude）
3. Claudeアカウントの制限を確認（使いすぎの場合、一時的に制限される）

ファイルを間違えて消した

解決策:

1. Gitで管理されていれば復元可能

   git checkout -- [ファイルパス]

2. Claude Codeに「さっき消したファイルを復元して」と依頼

解決しない場合

1. エラーメッセージをコピー
2. 状況を整理（何をしたらエラーになったか）
3. コーチに相談（10分ルール）

10分ルール

10分以上詰まったら、必ずコーチに声をかけてください。 解決に時間をかけすぎるより、早く次に進む方が学びになります。