トラブルシューティングガイド
よくある問題と解決方法をまとめました。
Claude Code関連
Claude Codeが起動しない
症状: claude コマンドを実行しても反応がない、またはエラーが出る
解決策:
-
Node.jsがインストールされているか確認
node --version表示されない場合:
brew install node -
Claude Codeを再インストール
npm install -g @anthropic-ai/claude-code -
ターミナルを再起動
認証エラー
症状: 「認証が必要です」「ログインしてください」等のメッセージ
解決策:
-
再度認証を実行
claudeブラウザが開くので、再度ログイン
-
それでもダメな場合、キャッシュをクリア
rm -rf ~/.claude claude -
メンターに相談
応答が遅い・止まる
症状: Claudeからの応答がずっと返ってこない
解決策:
Ctrl + Cで中断- 再度同じ指示を送る
- 頻発する場合は
/clearしてから再試行
Token制限に達した
症状: 「制限に達しました」等のメッセージ
解決策:
- Maxプランへの切り替え: メンターに声をかけてください（会社負担で切り替えます）
- 一時的な対処:
/clearで履歴をクリアすると、少し余裕ができます
コード実行関連
「ファイルが見つかりません」
症状: FileNotFoundError、No such file or directory
解決策:
-
現在のディレクトリを確認
今どのフォルダにいる？ -
ファイルの存在を確認
ls でファイル一覧を見せて -
正しいパスを指定して再実行
「権限がありません」
症状: Permission denied
解決策:
-
実行権限を付与
chmod +x でスクリプトに実行権限を付けて -
それでもダメな場合
pythonコマンドで直接実行して 例: python script.py
日本語が文字化けする
症状: 文字化け、□□□、????
解決策:
-
Claudeに依頼
文字コードをUTF-8に統一して -
ファイル読み込み時にエンコーディングを指定
ファイルを読み込むとき encoding='utf-8' を指定して
モジュールが見つからない
症状: ModuleNotFoundError、No module named ‘xxx’
解決策:
-
Claudeに依頼
必要なモジュールをインストールして -
手動でインストール
pip install モジュール名
VS Code関連
ターミナルが開かない
解決策:
- メニューから「ターミナル」→「新しいターミナル」
- ショートカット: `Ctrl + “ （バッククォート）
ファイルの変更が反映されない
解決策:
- ファイルを保存（
Cmd + S） - VS Codeのウィンドウを再読み込み（
Cmd + Shift + P→ 「Reload Window」）
開発で困ったとき
何から始めればいいかわからない
対処:
- Claudeに聞く
○○を作りたいんだけど、どこから始めればいい？ - 小さな部品から作り始める
- メンターに相談
複雑になりすぎてわからなくなった
対処:
/clearで履歴をクリア- 最小限の機能だけ作り直す
シンプルに○○だけできるものを一から作って - 一つずつ機能を追加していく
エラーが消えない
対処:
- エラーメッセージをそのままClaudeに見せる
- 「別の方法で試して」と言う
- それでもダメなら:
このアプローチは諦めて、別の方法で○○を実現して - メンターに相談
Claudeの提案が理解できない
対処:
- 説明を求める
もっと詳しく説明して 初心者向けに説明して - 部分的に質問
この行は何をしている？ - メンターに説明を求める
緊急連絡先
メンターを呼ぶタイミング
- 15分以上同じ問題で詰まっている
- エラーの意味がわからない
- そもそも何を聞けばいいかわからない
- 方向性に迷っている
手を挙げてください！ 一人で悩む時間がもったいないです。
それでも解決しない場合
- スクリーンショットを撮る: エラー画面の写真があると説明しやすい
- 状況を整理: 「○○をしようとして、△△のコマンドを実行したら、□□というエラーが出た」
- メンターに共有: 上記を伝える
一緒に解決しましょう！