※ChatGPTを使用して記事を作成しています。
これまでの記事で、Claude Codeの基本的な使い方は理解できたと思います。
ただ、実際に使ってみるとこう感じるはずです。
- 思ったより精度が出ない
- なんとなくズレた回答が返ってくる
- 結局、自分で直している
これは珍しいことではありません。
そして原因の多くはシンプルです。
AIの問題ではなく、指示の出し方の問題
です。
この記事では、Claude Codeの回答精度を上げるためのプロンプト設計の考え方を解説します。
なぜプロンプトが重要なのか？
Claude Codeは「賢いツール」ですが、状況を勝手に正確に理解してくれるわけではありません。
つまり、
- 前提が足りない
- 文脈が曖昧
- 意図が不明確
この状態だと、どれだけ優秀でも正しい答えは出せません。
逆に言えば、
適切に情報を渡せば、精度は一気に上がる
ということです。
プロンプト設計の基本構造
まずは基本形です。
以下の4つを意識するだけで、大きく改善します。
① 目的（何をしたいのか）
最初にゴールを明確にします。
例：
- ログイン機能を実装したい
- コードの可読性を改善したい
- このエラーの原因を特定したい
② 前提（環境・制約）
次に重要なのが前提です。
- 言語（Kotlinなど）
- フレームワーク（Composeなど）
- アーキテクチャ
- 使用ライブラリ
ここが抜けると、実務に合わない回答になりがちです。
③ 現状（何が起きているか）
特にデバッグでは必須です。
- 現在のコード
- エラーメッセージ
- 実際の挙動
④ 期待する結果
最後に「どうなってほしいか」を伝えます。
- 正常に動作するコードが欲しい
- 設計の改善案が欲しい
- 複数パターンで提案してほしい
悪いプロンプトの特徴
よくある失敗パターンを整理しておきます。
抽象的すぎる
うまくいきません。どうすればいいですか？
これでは判断材料が不足しています。
前提がない
リスト表示のコードを書いてください
RecyclerViewなのか、Composeなのかで全く変わります。
丸投げしている
いい感じにリファクタリングしてください
「いい感じ」は人によって違います。
良いプロンプトの例
同じ内容でも、ここまで変わります。
Kotlin + Jetpack Composeでリスト画面を実装しています。現状：
- LazyColumnで表示
- ViewModelからStateFlowでデータを取得課題：
- Composableの責務が肥大化している
- 可読性が低い目的：
- 責務を分割して読みやすくしたいこの前提でリファクタリング案を教えてください。
このレベルまで情報が揃うと、かなり精度が上がります。
精度をさらに上げるテクニック
ここからが一歩進んだ使い方です。
「役割」を与える
あなたはAndroidアプリ開発の専門家です。
この一文だけでも、回答の方向性が安定します。
「観点」を指定する
パフォーマンスと可読性の観点でレビューしてください。
何を重視するかを明確にします。
「出力形式」を指定する
箇条書きで改善点を提示してください。
これにより、読みやすさが向上します。
「段階的に考えさせる」
いきなりコードを書かせるのではなく、
- 設計を出す
- 問題点を洗い出す
- 実装する
といった流れにすると、質が安定します。
やってはいけない使い方
最後に、避けた方が良い使い方です。
AIに責任を委ねる
Claude Codeは補助ツールです。
最終的な判断は開発者が行う必要があります。
検証せずに採用する
出てきたコードは必ず確認・テストする必要があります。
思考を放棄する
便利だからこそ、
「なぜこの実装なのか？」を考えること
が重要です。
まとめ
Claude Codeを使いこなすためのポイントはシンプルです。
- 目的・前提・現状・期待を明確にする
- 抽象的な指示を避ける
- 対話を前提に使う
そして最も重要なのは、
「良い回答は、良い質問から生まれる」
ということです。
