シリーズ「お父さんから娘へのWEB・AI入門ガイド」第23弾
✉ お父さんから娘へ
vol.21でインストール、vol.22でWebページを作る体験をしてきた。
でも正直に言う——エラーが出るのは当たり前だ。
「インストールしたはずなのにclaudeが認識されない」
「認証画面でエラーが出て先に進めない」
「作業フォルダに日本語が入っていたら動かない」
こういうつまずきは、初心者だから起きるのではなく
Windows環境特有の仕様によって起きることが多い。
今日はよくあるエラーと対処法を全部まとめておく。
「なんか動かない」と思ったら、この記事に戻ってきてくれ。
📚
このシリーズのインストール手順はvol.21、実践編はvol.22で解説しています。まず当該記事を確認してからこのページに戻ってきてください。
まず最初にやること：/doctor コマンドで自己診断する
エラーの原因を一つずつ手動で調べる前に、Claude Code自身に「どこがおかしいか」を診断してもらう方法がある。Claude Codeが起動できている状態なら、次のコマンドを試してほしい。
💻 自己診断コマンド
/doctor
claude doctor
/doctorを実行すると、インストール状況・設定の有効性・認証状態・コンテキスト使用量を自動でチェックしてまとめて表示してくれる。エラーの8割はこのコマンドで原因がわかると言われており、まず最初に試す価値がある。表示されたエラーメッセージをClaudeに貼り付けて「これはどういう意味？」と聞けばさらに詳しく教えてくれる。
💡 エラーが出たときの基本姿勢
エラーメッセージは「壊れた」サインではなく「ここを直せばいい」という案内板だ。エラーメッセージ全文をそのままClaudeに貼り付けて「これの解決方法を教えて」と聞くのが最速の解決策だ。細かく原因を自分で調べなくていい。
よくあるエラー一覧
❌ エラー①
「claudeは認識されていません」または「command not found: claude」
claude : 用語 ‘claude’ は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。
原因：インストール後にPowerShellを再起動していないため、PATHが更新されていない。最も多いパターン。
✅ 解決策①：PowerShellを完全に閉じて再起動する
PowerShellのウィンドウを完全に閉じてから、もう一度開く。それでも出る場合はPCを再起動してから試す。これで90%は解決する。
✅ 解決策②：PATHを手動で追加する（再起動後も出る場合）
PowerShellで次のコマンドを実行してPATHを永続的に設定する。
💻 PATH永続化コマンド
[Environment]::SetEnvironmentVariable(“PATH”, “$env:USERPROFILE\.local\bin;$([Environment]::GetEnvironmentVariable(‘PATH’, ‘User’))”, “User”)
# 実行後PowerShellを再起動する
✅ 解決策③：バージョン確認で場所を特定する
💻 インストール済みかどうか確認
where.exe claude
# パスが表示されればインストール済み。表示されなければ再インストールが必要
❌ エラー②
「git: The term ‘git’ is not recognized」
git : 用語 ‘git’ は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。
原因：Git for Windowsがインストールされていない、またはインストール後にPowerShellを再起動していない。Claude CodeはWindowsでGit for Windowsが必須。
✅ 解決策：Git for Windowsをインストールする
ブラウザで「git for windows」と検索して公式サイト（git-scm.com）からダウンロード・インストールする。インストール時の設定はすべてデフォルトのままでOK。インストール完了後はPowerShellを再起動して確認する。
💻 Gitのインストール確認
git –version
git version 2.47.1.windows.1 ← このように表示されればOK
⚠ Gitのパスを手動で指定する方法（Gitが入っているのにエラーが出る場合）
Git for Windowsがインストール済みでもエラーが出る場合は、PowerShellで次の環境変数を設定する。
$env:CLAUDE_CODE_GIT_BASH_PATH = “C:\Program Files\Git\bin\bash.exe”
❌ エラー③
認証画面でエラー・「Not authenticated」が続く
Authentication failed. Please check your subscription plan.
原因：主に3パターン。①Claudeアカウントが無料プランで有料プランに未加入。②企業・学校のネットワーク（プロキシ・VPN）がAnthropicのサーバーへの通信をブロックしている。③ブラウザでのログイン後にPowerShellが認証を検知できていない。
✅ 解決策①：プランを確認する
claude.aiにアクセスして、ログインしているアカウントがProプラン以上かどうか確認する。無料プランではClaude Codeは使えない。
✅ 解決策②：ネットワーク環境を変える
会社・学校のWi-Fiで起きている場合は、自宅Wi-Fiやスマホのテザリングに切り替えてから再度認証を試みる。通信がブロックされているケースで効果的。
✅ 解決策③：claudeコマンドを再実行して認証し直す
💻 認証のやり直し
claude logout
claude ← 再度起動して認証画面を出す
❌ エラー④
日本語・スペース入りフォルダで動作がおかしい
Error: Cannot read path ‘C:\Users\田中花子\Documents\マイプロジェクト’
原因：Claude Codeを含む多くの開発ツールは、フォルダパスに日本語・全角文字・スペースが含まれていると正しく動作しないことがある。Windowsのユーザー名が日本語の場合も同様の問題が起きる。
✅ 解決策：作業フォルダをアルファベット・数字のみのパスに移動する
vol.22でも紹介した通り、作業フォルダはC:\claude-workのようにアルファベットと数字だけのパスに置く習慣をつけると、この問題は完全に回避できる。
💻 安全な作業フォルダの作り方
mkdir C:\claude-work
cd C:\claude-work
claude
⚠ ファイルが文字化けする場合
日本語のテキストファイルを扱うとき、Windowsの文字コード（Shift_JIS・CP932）が原因で文字化けが起きることがある。Claude Codeに「このファイルはShift_JISかもしれない。UTF-8として読んで」と伝えると対処してくれる。
❌ エラー⑤
「このシステムではスクリプトの実行が無効になっています」
このシステムではスクリプトの実行が無効になっているため、ファイル C:\… を読み込むことができません。
原因：WindowsのPowerShellがセキュリティ上の理由でスクリプトの実行を制限している。特に会社のPCで多く見られる。
✅ 解決策：実行ポリシーを変更する
💻 実行ポリシーの変更（管理者権限不要）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 確認を求められたら「Y」を入力してEnter
このコマンドは「自分のユーザーアカウントのみ」に適用される設定変更で、管理者権限は不要だ。会社のPCで「それもできない」という場合はIT部門に相談するか、自宅のPCで試してほしい。
❌ エラー⑥
SSL証明書エラー・インストール中に通信エラーが出る
SSL_ERROR_RX_RECORD_TOO_LONG / certificate verify failed / Unable to connect to storage.googleapis.com
原因：会社・学校のネットワーク（プロキシ・VPN・セキュリティソフト）がHTTPS通信を遮断またはSSL検査している。インストーラーがダウンロードサーバー（storage.googleapis.com）にアクセスできない。
✅ 解決策①：別のネットワークで試す
自宅のWi-Fiまたはスマホのテザリングに切り替えて、インストールコマンドを再度実行する。これが最も手軽な解決策だ。
✅ 解決策②：セキュリティソフトを一時的に無効にする
ウイルス対策ソフト（Windows Defender等）がインストーラーをブロックしている場合がある。インストール中だけ一時的に無効にして試す。インストール完了後は必ず再度有効にすること。
⚠ 問題⑦
「最近、応答が遅い・回答が雑になった」と感じる
原因：①コンテキスト（会話の蓄積）が長くなりすぎてClaudeが混乱している。②thinking budget（思考量の設定）がデフォルトで下方修正されているケース。③Claude Code自体のバージョンが古い。
✅ 解決策①：/clearでコンテキストをリセットする
Claude Code起動中に/clearを入力すると会話の文脈がリセットされる。作成済みファイルは消えない。「なんか噛み合わない」と感じたらまずこれを試す。
✅ 解決策②：バージョンを確認して最新版か確認する
💻 バージョン確認
claude –version
# 公式サイトの最新バージョンと比較する
自動更新が有効なら基本的に最新版が適用されているが、バージョンが古い場合はPowerShellを再起動するか、PCを再起動すると自動更新が走ることがある。
✅ 解決策③：/doctorで状態を確認する
💻 診断コマンド
/doctor
「Currently running: native」と表示されていればネイティブ版で正常に動作している。「npm-global」と表示される場合はnpm版で動いており、ネイティブ版に切り替えると改善することがある。
❌ エラー⑧
「ファイルが文字化けする・日本語が読めない」
??????????????????????
原因：Windowsで作成されたテキストファイルの文字コードがShift_JIS（CP932）で、Claude CodeがUTF-8として読もうとしている。特に古いExcelファイルやメモ帳で作成したファイルで起きやすい。
✅ 解決策：Claude Codeに文字コードを伝える
難しい設定は不要。Claude Codeに「このファイルはShift_JISエンコーディングです。UTF-8に変換してから読んでください」と伝えるだけで対処してくれる。
今後作るファイルは最初からUTF-8で保存する習慣をつけると予防できる。メモ帳で新規ファイルを保存するとき「文字コード：UTF-8」を選択するだけでいい。
それでも解決しないときの最終手段
上記のどれを試しても解決しない場合は、以下の手順で確認・報告する。
-
⬜
エラーメッセージをClaudeに貼り付けて聞く
claude.ai（通常のチャット版）を開いて「Claude Codeでこのエラーが出た。Windowsで使っています。解決策を教えてください」とエラー文全文を貼り付ける
-
⬜
/feedbackコマンドでAnthropicに報告する
Claude Code起動中に/feedbackと入力すると、Anthropicに問題を直接報告するフォームが開く。バグの可能性がある場合に使う
-
⬜
Claude CodeのGitHubで既知の問題を確認する
github.com/anthropics/claude-code のIssuesタブで同じエラーの報告がないか確認する。日本語で検索するより英語でエラーメッセージを検索した方が見つかりやすい
-
⬜
再インストールを試みる
インストール時の問題がひきずっている可能性がある。vol.21のアンインストール手順に従って一度削除し、インストールし直す
よくある疑問に答えます
Q
エラーが出るたびに怖くなる。何かを壊してしまうことはある？
A
Claude Codeは「作業フォルダの中でのみ」動作します。専用フォルダ（C:\claude-work）で使っている限り、システムファイルや他のフォルダに影響を与えることはほぼありません。エラーはPCが壊れたサインではなく「この設定が足りない」という情報です。怖がらずに対処法を一つずつ試してください。
A
会社のPCには独自のセキュリティポリシーがかかっていることが多く、スクリプト実行制限・プロキシ・VPNの影響でインストールや認証がうまくいかないケースがあります。まず自宅の個人PCで試してみることをおすすめします。会社で使いたい場合は情報システム部門に「Anthropic社のClaude Code（コード署名済みのソフトウェア）を使いたい」と相談するのが正規の手順です。
A
エラーの種類は異なります。Macはこの記事で紹介したエラー①（PATHの問題）・④（日本語パス）・⑦（コンテキスト・バージョン）は起きることがありますが、エラー②（Git for Windows）・⑤（PowerShell実行ポリシー）はWindowsに固有の問題です。Mac向けのトラブルシューティングは今後別途まとめる予定です。
Q
エラーがなくなってもClaude Codeの動きがおかしいことがある
A
コンテキスト（会話の蓄積）が長くなると、Claude Codeが過去の会話に引きずられて意図と違う動きをすることがあります。/clearでリセットするのが基本対処です。また、複雑な作業の前に「今からやること」を改めて整理して伝え直すと精度が戻ります。
Q
Claude Codeが「許可を求めてくる」のはなぜ？止める方法は？
A
Claude Codeはファイルの作成・編集・削除など取り消しが難しい操作の前に「y/n」の確認を求めます。これはセキュリティ上の仕様で、誤操作を防ぐためのものです。内容を確認してから「y」を押す習慣がついたら安心して使えます。毎回確認が面倒な場合は「auto-approve」モードも設定できますが、慣れるまでは確認ありのデフォルト設定を推奨します。
まとめ
- エラーが出たらまず/doctorコマンドで自己診断。8割の問題はここでわかる
- エラーメッセージはそのままClaudeに貼り付けて「解決策を教えて」と聞くのが最速
- 最多エラーはPowerShellの再起動で解決（PATHが更新されていないだけ）
- 作業フォルダはC:\claude-work のようなアルファベット・英数字のみのパスに置く
- 会社・学校のネットワークでのSSLエラーは自宅Wi-Fiに切り替えると解決することが多い
- 応答が遅い・雑になったと感じたら/clearでコンテキストをリセットする
- それでも解決しない場合は/feedbackでAnthropicに報告する
✉ 最後にお父さんから
エラーが出ると「自分には向いていないのかも」と思いやすいが、それは違う。
Windows環境でClaude Codeを使っている人は全員、最初に一度はエラーにぶつかっている。
大事なのは「エラーを見て逃げない」ことだけだ。
このページに書いてあることを一つずつ試せば、ほぼ必ず解決できる。
この記事でClaude Codeシリーズは一段落だ。
次のvol.24からは別のテーマに移っていく。
👨
このブログについて
EC・WEB・音楽・医療・フィットネスと幅広い現場を渡り歩いてきた現役ディレクターが、WEB・AIの世界に飛び込もうとしている娘に向けて、本音で解説するブログです。正確な情報を初心者に届けることを最優先にしています。
コメント