
Claude CodeでWebアプリ開発|意図と違う画面を戻す指示メモ
この記事はBrainの紹介リンク(アフィリエイト)を含みます。
画面ができても、そのまま使わない
Claude CodeでWebアプリ開発を頼むときは、最初の出力を完成品ではなく確認用の下書きとして見るのが安全です。
画面がきれいでも、週報の項目名、入力順、集計の単位が元の業務メモと違えば、そのまま渡せる道具にはなりません。
むずかしい話は抜きにして、まずは「何を保存し、誰がどこを見るか」を人が確認できる形にします。
特に事務の定型作業では、要望を短く伝えすぎると、便利そうな機能が増える一方で、必要な入力欄が抜けることがあります。
作ることと正しい内容に戻すことは、別の作業として扱うと迷いにくくなります。
Claude CodeでWebアプリ開発を頼む前の入力メモ
最初にコードの言葉を覚えるより、仕事のメモを小さく整えます。
たとえば週報の提出前に使う「案件確認メモ」なら、次の4点で十分です。
使う人:自分だけ。社内の共有前に内容を見直す
入力するもの:案件名、今週の対応、確認待ち、次の対応
表示したい順番:案件名、今週の対応、確認待ち、次の対応
保存しないもの:顧客名、連絡先、社内限定の数値
これは教材の付属品ではない、説明用の自作メモです。
保存対象に個人情報や社外秘が含まれる場合は、勤務先のルールと利用するサービスの設定を先に確認してください。
Claude Codeの公式案内では、利用に必要なOSやNode.jsなどの環境が示されています。
2026年11月時点の対応環境は、始める直前に公式ページで見直すのが安心です。
Webアプリの出力がずれた説明用の例
ここ、つまずきやすいポイントです。
「案件を入力して一覧にする画面を作って」とだけ頼むと、次のような出力になることがあります。
意図と違う出力の例:案件名、担当者、期限、優先度、完了チェックを入力する多機能な管理画面。
肝心の「確認待ち」がなく、並び順も元メモと違う。
見た目の問題に見えても、照合する相手は最初の入力メモです。
項目を一つずつ並べて確認します。
元メモにある「確認待ち」:画面にないので追加する
元メモにない「担当者・期限・優先度」:今回は追加しない
元メモの表示順:画面の順番を合わせる
保存しない情報:入力欄にも作らない
機能が多いほどよいとは限りません。
業務の提出物や社内の決まりに照らして、必要な項目だけを残します。
修正指示は「残す・直す・触らない」を分ける
修正前と修正後を並べると、次に何を伝えるかが明確になります。
修正前:
「案件を入力して一覧にする画面を作ってください」
修正後:
「現在の一覧表示は残してください。入力欄は案件名、今週の対応、確認待ち、次の対応の4つだけにしてください。この順番で一覧にも表示します。担当者、期限、優先度、完了チェックは追加しないでください。保存はこの段階では実装せず、画面だけを変更してください。」
残す部分、直す部分、今回触らない部分を分けるのがコツです。
Anthropicの公式ドキュメントでも、出力形式や制約を具体的に示すこと、例を使うことが案内されています。
一度に「保存」「公開」「デザイン変更」まで頼むより、画面だけを照合してから次へ進むほうが、どこで違いが出たかを追いやすくなります。
Webアプリテストで人が確かめる場所
画面を直したら、開発用の表示だけで終えず、元メモを見ながら入力します。
説明用の確認項目です。
案件名を「展示会準備」と入れ、一覧の先頭に同じ文字が出るか。
「確認待ち」に「見積書の承認」と入れ、別の欄へ移っていないか。
入力欄に顧客名や社内の数値を求める項目が増えていないか。
空欄のまま登録しようとしたとき、意図しない内容が表示されないか。
変更したファイル名と変更内容を確認し、必要ならGitHubへ反映する前に見直したか。
GitHubでは、手元の変更をコミットしてからリモートへプッシュします。
つまり、公開側の内容と手元の内容は、反映前には一致しないことがあります。
どの版を見て確認したかをメモしておくと、「直したはずの画面」が見つからない混乱を減らせます。
データを保存する段階では、画面づくりとは別に保存先の設定と確認が必要です。
Cloudflare D1ではダッシュボードのコンソールやコマンドなど、SQL文を実行する方法が案内されています。
入力した内容を扱う前に、保存する項目と消し方を整理してから進めてください。
☕
次に確認したい教材と準備
このページでできるのは、画面のずれを入力メモに戻して修正指示へ変えることです。
Claude CodeでのWebアプリ制作を、Git・GitHub・Cloudflareやデータ保存の準備も含めて体系的に確認したい場合は、「Webアプリ制作の教科書」の対象業務や必要な環境を確かめておくと、次の作業を選びやすくなります。
参考: