症状別の頼み方

よくある困りごとと、そのとき Claude に送る依頼文を、症状ごとにまとめています。

依頼文の【 】の部分を書き換えて使います。伝え方の基本は うまくいかないとき にあります。

本番で見つけた不具合を新しい会話で頼むときは、依頼文の最後に次の一文を足します。

直すときは、main から新しいブランチを作り、ビルドが通ることを確認してから、main へのプルリクエストを作成し、PR の URL を教えてください。

画面が真っ白になる、エラーが表示される

画面に出ているメッセージがあれば、そのまま全部を貼り付けます。メッセージが無いときは、スクリーンショットを貼ります。

画面が真っ白、またはエラーが出る
Claudeプロンプト
【アプリ名】で、画面が正しく表示されません。原因を調べて、専門用語を使わずに説明したうえで、直してください。 どこで：【例：プレビューの、忘れ物の一覧画面】 何をしたら：【例：一覧を開いた】 どうなった：【例：画面が真っ白になった】 画面に出たメッセージ： 【そのまま貼り付ける】

表示が崩れる

文字が重なる、ボタンがはみ出す、スマートフォンで見づらい、といった症状です。スクリーンショットを貼ると、正確に伝わります。

表示が崩れる
Claudeプロンプト
【アプリ名】の表示が崩れています。直してください。 どの画面で：【例：忘れ物の一覧画面】 何で見たとき：【例：スマートフォン】 どうなっている：【例：右端の列が画面からはみ出して、見えない】 どうなってほしい：【例：スマートフォンでは、1件ずつ縦に並べて表示してほしい】

計算、並び順、日付がおかしい

エラーは出ないのに、結果が違っている症状です。実際の数字や日付を書きます。

結果がおかしい
Claudeプロンプト
【アプリ名】の結果がおかしいです。原因を調べて、直してください。 どの画面で：【例：月ごとの集計画面】 入力したもの：【例：3月に、忘れ物を5件登録した】 表示されたもの：【例：3月の件数が 4 と表示された】 正しい結果：【例：5 と表示されるはず】

あるはずのデータが表示されない

データが表示されない
Claudeプロンプト
【アプリ名】で、あるはずのデータが表示されません。原因を調べて、直してください。 どこで：【例：本番の、忘れ物の一覧画面】 あるはずのデータ：【例：今日の午前に登録した3件】 実際の表示：【例：一覧に何も表示されない。エラーのメッセージは出ていない】
本番のデータが消えたかもしれないとき

登録したはずのデータが本番から消えた、または書き換わったと思われるときは、Claude に頼む前に管理者に知らせます。

変わった使い方をすると壊れる

何も入力せずに保存する、とても長い文章を入れる、ボタンを続けて2回押す、といった使い方で壊れる症状です。壊れる前に、まとめて点検してもらうこともできます。

変わった使い方への備えを頼む
Claudeプロンプト
【アプリ名】の【画面の名前】を点検して、次の使い方をされても困らないようにしてください。直す前に、見つかった問題を一覧にして説明してください。 1. 何も入力せずに保存する 2. とても長い文章を入力する 3. 保存のボタンを、続けて2回押す 4. データが1件も無い状態で画面を開く

PR のチェックが赤い

PR を作ったときと同じ会話で頼みます。Claude は、失敗の内容を自分で調べられます。

チェックが失敗したとき
Claudeプロンプト
PR のチェックが失敗しています。失敗の内容を調べて、原因を専門用語を使わずに説明したうえで、直してください。直したら、同じ PR に追加してください。
説明に「マイグレーション」という言葉が出てきたら

データベースの構造の変更で失敗しています。Claude に直してもらう前に、PR の URL と Claude の説明を管理者に伝えて、進め方を相談します。

プレビューが開けない

表示どうするか
「プレビュー環境」のコメントが届かない自動チェックが終わるまで待ちます。終わっても届かないときは、Claude に「プレビュー環境のコメントが届きません。原因を調べてください」と送ります
「デプロイ失敗」Claude に「プレビューのデプロイが失敗しています。原因を調べて直してください」と送ります
「URLがまだ応答していません」数分待ってから、もう一度開きます。続くときは、管理者に伝えます
「アクセスが拒否されました」あなたがそのアプリを開けるよう、管理者に依頼します
サインインできないプレビューでもサインインできるよう、管理者に依頼します

本番でエラーが起きている

本番のアプリの記録（ログ）は、App Portal から Claude に渡せます。

  1. App Portal を開き、そのアプリのカードにある「ログ」を押します。
  2. 「エラー」のタブを選びます。
  3. 「Claude Code 用にコピー」を押します。
  4. brain-vibe-coding-platform フォルダを選んだ Claude Code の新しい会話に、そのまま貼り付けて送ります。

コピーされる文章には、Claude への依頼と、調べ方の手がかりが入っています。書き足す必要はありません。

「ログ」が表示されないとき

「ログ」は、見ることを許可された人にだけ表示されます。表示されないときは、いつ、どの画面で、何をしたらエラーになったかを、管理者に伝えます。

マージしたあとで、元に戻したい

マージした変更を、本番から取り消します。取り消しも、PR を作ってマージする流れは同じです。

マージした変更を取り消す
Claudeプロンプト
【PR の URL】の変更を、本番から取り消したいです。この PR の変更を元に戻す PR を作ってください。 取り消したい理由：【例：一覧が表示されなくなった】 データベースの構造を変える変更が含まれている場合は、作業の前に知らせてください。最後に、ビルドが通ることを確認して、main へのプルリクエストを作成し、PR の URL を教えてください。
急ぐとき、データに関わるとき

同僚の仕事が止まっているときや、データが関わるときは、取り消しを頼むのと同時に、管理者にも知らせます。

Claude に「Git の名前とメールアドレスが未設定」と言われる

はじめて変更を記録するときに、Git に名前とメールアドレスが設定されていないと、Claude の作業が止まることがあります。名前やアドレスを聞かれても、自分で答える必要はありません。同じ会話で、次の依頼文を送ります。

Git の名前とメールアドレスを設定してもらう
Claudeプロンプト
Git に、コミットに使う名前とメールアドレスを設定してください。私に尋ねずに、いま GitHub にログインしているアカウントの情報から決めてください。 1. 名前は GitHub のプロフィールの名前、無ければユーザー名にします 2. メールアドレスは、GitHub が用意する非公開用のアドレス（ID+ユーザー名@users.noreply.github.com）にします 3. 設定は、このパソコン全体に効く形で行ってください 4. すでに設定されている項目は変えないでください 設定できたら、止まっていた作業を続けてください。

この設定は、パソコンごとに一度だけ行えば済みます。

Claude に「権限がない」「ログインが必要」と言われる

GitHub へのログインが切れていることがあります。

GitHub へのログインを確かめる
Claudeプロンプト
GitHub へのログインの状態を確認してください。ログインが切れている場合は、もう一度ログインするのを手伝ってください。

ログインし直しても同じことを言われるときは、リポジトリを使う権限があるかを、管理者に確認します。

クイズ

Quiz

本番のアプリで、同僚が「保存を押すとエラーになる」と言っています。App Portal に「ログ」のボタンがあります。最初に何をしますか？