付録 — FAQ / A-2

まず、ここを見る。

作業中に出てきた「あれ、動かない」「思っていたのと違う」を、よくある順にまとめました。講座でも一度は出会った場面ばかりのはずです。困ったら、まずここ。それでも解決しなければ、遠慮なくご相談ください。

この章の使いかた

  • 困ったら、まずここ。近い症状を上から探してみてください
  • 多くのつまずきは エラー文をそのまま Claude に貼って聞く だけで解決します
  • それでも解決しなければ、遠慮なくご相談を

Q. 「command not found」と出る

打ったコマンドが「見つからない」という意味です。多くは、必要なソフト(Node.js など)がまだ入っていないか、入れた直後でターミナルが古い情報のまま、のどちらか。まずはターミナルを一度完全に閉じて、開き直すと直ることがほとんどです。それでもダメなら、入れ直しを確認しましょう。

詳しくは 環境構築 へ。

Q. claude を起動しても反応しない・ログインできない

初回起動ではブラウザが開き、Anthropic のアカウントでログインを求められます。ブラウザが自動で開かないときは、ターミナルに表示された URL を自分でコピーしてブラウザに貼ると進めます。反応がないときは、いったん Ctrl + C で止めて、もう一度 claude と打ち直してみてください。

詳しくは 環境構築 へ。

Q. 変更したのに、ブラウザに反映されない

変更そのものは保存できていて、ブラウザが古い表示を覚えている(キャッシュ)だけ、というケースがほとんどです。まずはページの再読み込み(リロード)。それでも変わらなければ、Mac は ⌘ + Shift + R、Windows は Ctrl + Shift + R で「キャッシュを無視した強制リロード」を試してください。

詳しくは はじめてのページづくり へ。

Q. Claude が意図と違うものを作る

たいていは、指示が「ふんわり」しているのが原因です。具体的に・できれば例を見せて頼むと、ぐっと精度が上がります。「いい感じに」ではなく「見出しは中央ぞろえ、文字は少し大きく、色はこの画像のように」と伝える。違ったら「ここをこう直して」と少しずつ寄せていくのがコツです。

Claude Code へのプロンプト
さっきの見出しを、もう少し大きく・中央ぞろえにしてください。イメージは添付の参考サイトのトップ部分に近い雰囲気です。色は今のオレンジのままでお願いします。

詳しくは AIへの「伝え方」=指示の技術 へ。

Q. エラーが出たけど、どうすればいい?

あわてなくて大丈夫です。いちばん速いのは、エラー文をそのままコピーして Claude に貼り、「どういう意味? どう直す?」と聞くこと。原因と直しかたを日本語で説明してくれます。講座でも何度も練習した、いちばん頼れる対処法です。

Claude Code へのプロンプト
次のエラーが出ました。これはどういう意味ですか? どう直せばいいか、初心者にもわかるように手順で教えてください。

(ここにエラー文をそのまま貼る)

詳しくは AIへの「伝え方」=指示の技術 へ。

Q. git push で認証エラーになる

GitHub への「本人確認」がうまくいっていない状態です。パスワードではなくトークン(合言葉のようなもの)やブラウザでのログイン認証が必要になっているケースが多いです。エラー文をそのまま Claude に貼って、自分の環境に合った手順を案内してもらうのが確実です。

詳しくは 変更を記録する(Git) へ。

Q. スマホで表示が崩れる

パソコンの広い画面に合わせて作ると、スマホの細い画面ではみ出したり重なったりすることがあります。「スマホでも崩れないように整えて」と具体的に頼みましょう。実際にスマホで開いて確認する、ブラウザの開発者ツールで幅を狭めて見る、のも有効です。

Claude Code へのプロンプト
このページをスマホ(幅375pxくらい)で見たときに、文字や画像がはみ出さず、きれいに縦に並ぶように整えてください。崩れている箇所があれば直してください。

詳しくは デザインを整える/スマホ対応 へ。

Q. Supabase にデータが保存されない

よくあるのは、接続のための鍵(URL と API キー)が正しく設定されていない、またはテーブルの書き込み権限(ポリシー)が許可されていないのどちらかです。画面に出ているエラーや、Supabase の管理画面のログを Claude に見せて、設定を一緒に確認していくのが近道です。

詳しくは 問い合わせフォーム&データベース(Supabase) へ。

Q. 公開したのにサイトが見られない・ドメインがつながらない

公開した直後は、反映までに少し時間がかかることがあります(独自ドメインの場合はとくに)。まずは数分〜数十分待ってから、強制リロードで再確認を。それでも見られないときは、公開設定(デプロイ)が成功しているか、ドメインの設定が正しいかを、エラーや画面を見せながら一つずつ確認しましょう。

詳しくは 公開する(デプロイ) へ。

Q. 前の状態に戻したい

こまめに記録(コミット)していれば、直前の状態に戻すことができます。自分でコマンドを打つこともできますが、不安なときはClaude に「さっきの変更を取り消して、ひとつ前の状態に戻して」と頼むのがいちばん安全です。どこまで戻すかを伝えると、より正確に対応してくれます。

Claude Code へのプロンプト
さっきの変更がうまくいかなかったので、ひとつ前のコミットの状態に戻したいです。どうすればいいか教えて、必要な操作をしてください。

詳しくは 変更を記録する(Git) へ。

独学だと、ここで止まる

それでも解決しないとき

ここまで試しても直らないときは、無理に一人で抱え込まないでください。①出ているエラー文 ②そのとき何をしていたか ③画面のスクリーンショット——この3つを添えて、対面でご相談いただくのがいちばんの近道です。文字だけでは伝わりにくいことも、画面を一緒に見れば数分で解決することがほとんどです。講座中の方は、次回いっしょに確認しましょう。

この章のまとめ

  • 困ったら、まず近い症状をこのページから探す
  • エラーは そのまま Claude に貼って「どう直す?」と聞くのが最短
  • 解決しなければ、エラー文・状況・スクショを添えて遠慮なく相談を

Support

一人で抱え込まないで。

ここに載っていないつまずきも、画面を一緒に見れば、たいてい数分で解けます。エラー文と状況を添えて、いつでもご相談ください。

電話で相談 080-6946-4006