※Claude Codeを使用して記事を作成しています。
シリーズ:Claude Codeを使ったAndroidアプリ開発 失敗談
- #1:指示が曖昧だと、全然違うものができあがりがちな話
- #2:一度に大きすぎる指示を出すと、収拾がつかなくなりがちな話
- #3:「いい感じにして」が、うまく伝わらなくなりがちな話 ← 今回
※この記事の事例は、Claude Codeを使った開発で起こりがちなケースをもとにした想定例です。
Claude Codeの出力やエラーの内容は、環境や指示の内容によって異なります。
はじめに
#1・#2で「指示は具体的に、小さく分けて」と学んでも、具体的に書きにくい場面があります。
それがデザインです。
「このアプリをいい感じにしてほしい」
この一言が、地雷になりやすい理由を整理します。
起こりがちなケース
機能の実装が一通り終わり、デザインを整えようとして、次のように指示したとします。
アプリ全体のデザインをいい感じにしてください。
Claude Codeは、いくつかの変更を加えてくれるはずです。
ただし、動かしてみると、次のようなことが起こりえます。
- フォントが小さくなり、読みにくい
- ボタンの色が、アプリのイメージと違う
- 余白がなくなり、詰まって見える
- すでに整えた画面のデザインまで、変わってしまう
「いい感じ」の解釈が、頭の中のイメージと違う、というケースです。
「いい感じ」が失敗しやすい理由
「いい感じ」という言葉は、人によって意味が違います。
Claude Codeは、「いい感じ」に対して、自分なりの判断で動きます。
その判断が、自分の好みと一致する保証はありません。
さらに「全体のデザインを」という指示は、#2の「大きすぎる指示」とも重なっています。
変更範囲が広すぎて、意図しない部分まで変わりやすくなります。
何が足りないのか
「いい感じ」を言語化すると、何になるのかを整理します。
| 漠然とした言葉 | 具体的に伝えるべきこと |
|---|---|
| いい感じ | どんなアプリのイメージか(シンプル・ポップ・高級感など) |
| おしゃれ | 何色をメインにするか、フォントの雰囲気 |
| 見やすく | 文字サイズ・コントラスト・余白の量 |
| 統一感を出して | どの画面を基準にするか |
対策:変える場所・変え方・変えない場所を明確にする
「いい感じ」をやめて、変える場所・変え方・変えない場所を書きます。
メイン画面のデザインだけ変更してください。
ログイン画面と設定画面は今回触らないでください。
変更してほしい内容:
・背景色を白から薄いグレー(#F5F5F5)に変える
・メモ一覧の各アイテムを白いカード(角丸8dp・影あり)で囲む
・「+」ボタンの色を青(#1976D2)にする
・文字サイズは今のまま変えないでください
こうすると、意図した範囲だけを、変更してもらいやすくなります。
デザイン指示で使えるフレーズ集
「いい感じ」の代わりに使えるフレーズをまとめます。
色の伝え方:
・テーマカラーを青系(#1565C0)にしてください
・落ち着いたトーンで、白・グレー・ネイビーの3色でまとめてください
・今の配色は維持してください
レイアウトの伝え方:
・各要素の間に16dpの余白を入れてください
・カード形式(角丸・薄い影あり)で囲んでください
・リストの行の高さを今より少し広めにしてください
変更範囲の限定:
・〇〇画面だけ変えてください。他の画面は触らないでください
・ボタンのデザインだけ変えて、テキストや色は維持してください
「参考にしてほしいアプリ」を伝えるのも有効
具体的な言葉が浮かばないときは、参考アプリのイメージを伝える方法もあります。
Googleの公式アプリ(GmailやGoogle Keepなど)のような
シンプルでフラットなデザインにしてください。
過度な装飾は不要です。
メモ帳アプリらしい、落ち着いた和風テイストにしてください。
ベージュ・ブラウン系でまとめてほしいです。
まとめ
「いい感じ」「おしゃれに」「きれいに」という言葉は、Claude Codeに対して、ほとんど何も伝えていないに等しいです。
デザインに関しては特に、具体的な色・サイズ・変更範囲を明示する必要があります。
また、「変えない場所」を明示するのも、同じくらい重要です。
頭の中のイメージを言語化するのは、最初は難しいですが、「なぜそのデザインがよいのか」を言葉にしていくと、指示もうまくなっていきます。
次回:【Claude Code 失敗談 #4】前の会話の文脈が消えて、同じ失敗を繰り返しがちな話


