付録 — 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 が意図と違うものを作る
たいていは、指示が「ふんわり」しているのが原因です。具体的に・できれば例を見せて頼むと、ぐっと精度が上がります。「いい感じに」ではなく「見出しは中央ぞろえ、文字は少し大きく、色はこの画像のように」と伝える。違ったら「ここをこう直して」と少しずつ寄せていくのがコツです。
さっきの見出しを、もう少し大きく・中央ぞろえにしてください。イメージは添付の参考サイトのトップ部分に近い雰囲気です。色は今のオレンジのままでお願いします。
詳しくは AIへの「伝え方」=指示の技術 へ。
Q. エラーが出たけど、どうすればいい?
あわてなくて大丈夫です。いちばん速いのは、エラー文をそのままコピーして Claude に貼り、「どういう意味? どう直す?」と聞くこと。原因と直しかたを日本語で説明してくれます。講座でも何度も練習した、いちばん頼れる対処法です。
次のエラーが出ました。これはどういう意味ですか? どう直せばいいか、初心者にもわかるように手順で教えてください。
(ここにエラー文をそのまま貼る)
詳しくは AIへの「伝え方」=指示の技術 へ。
Q. git push で認証エラーになる
GitHub への「本人確認」がうまくいっていない状態です。パスワードではなくトークン(合言葉のようなもの)やブラウザでのログイン認証が必要になっているケースが多いです。エラー文をそのまま Claude に貼って、自分の環境に合った手順を案内してもらうのが確実です。
詳しくは 変更を記録する(Git) へ。
Q. スマホで表示が崩れる
パソコンの広い画面に合わせて作ると、スマホの細い画面ではみ出したり重なったりすることがあります。「スマホでも崩れないように整えて」と具体的に頼みましょう。実際にスマホで開いて確認する、ブラウザの開発者ツールで幅を狭めて見る、のも有効です。
このページをスマホ(幅375pxくらい)で見たときに、文字や画像がはみ出さず、きれいに縦に並ぶように整えてください。崩れている箇所があれば直してください。
詳しくは デザインを整える/スマホ対応 へ。
Q. Supabase にデータが保存されない
よくあるのは、接続のための鍵(URL と API キー)が正しく設定されていない、またはテーブルの書き込み権限(ポリシー)が許可されていないのどちらかです。画面に出ているエラーや、Supabase の管理画面のログを Claude に見せて、設定を一緒に確認していくのが近道です。
詳しくは 問い合わせフォーム&データベース(Supabase) へ。
Q. 公開したのにサイトが見られない・ドメインがつながらない
公開した直後は、反映までに少し時間がかかることがあります(独自ドメインの場合はとくに)。まずは数分〜数十分待ってから、強制リロードで再確認を。それでも見られないときは、公開設定(デプロイ)が成功しているか、ドメインの設定が正しいかを、エラーや画面を見せながら一つずつ確認しましょう。
詳しくは 公開する(デプロイ) へ。
Q. 前の状態に戻したい
こまめに記録(コミット)していれば、直前の状態に戻すことができます。自分でコマンドを打つこともできますが、不安なときはClaude に「さっきの変更を取り消して、ひとつ前の状態に戻して」と頼むのがいちばん安全です。どこまで戻すかを伝えると、より正確に対応してくれます。
さっきの変更がうまくいかなかったので、ひとつ前のコミットの状態に戻したいです。どうすればいいか教えて、必要な操作をしてください。
詳しくは 変更を記録する(Git) へ。
独学だと、ここで止まる
それでも解決しないとき
ここまで試しても直らないときは、無理に一人で抱え込まないでください。①出ているエラー文 ②そのとき何をしていたか ③画面のスクリーンショット——この3つを添えて、対面でご相談いただくのがいちばんの近道です。文字だけでは伝わりにくいことも、画面を一緒に見れば数分で解決することがほとんどです。講座中の方は、次回いっしょに確認しましょう。
この章のまとめ
- 困ったら、まず近い症状をこのページから探す
- エラーは そのまま Claude に貼って「どう直す?」と聞くのが最短
- 解決しなければ、エラー文・状況・スクショを添えて遠慮なく相談を
Support
一人で抱え込まないで。
ここに載っていないつまずきも、画面を一緒に見れば、たいてい数分で解けます。エラー文と状況を添えて、いつでもご相談ください。
電話で相談 080-6946-4006