Claude Codeで成果を出す5つのプロンプトテクニック【実例付き完全ガイド】

はじめに

Claude Codeの出力品質は、プロンプト（指示文）の書き方ひとつで大きく変わります。同じタスクでも、プロンプトの工夫次第で「使えないコード」が「プロダクション品質のコード」に化けることも珍しくありません。

この記事では、Claude Codeで実際に成果を出すための5つのプロンプトテクニックを、Before/Afterの具体例付きで解説します。Claude Codeをまだ使ったことがない方は、まず入門ガイドをご覧ください。

1. 具体的なコンテキストを提供する

最も効果的なテクニックは、タスクの背景や目的を明確に伝えることです。Claude Codeはプロジェクトのファイルを読み取れますが、あなたの意図までは推測できません。「何をしたいのか」だけでなく「なぜそうしたいのか」を伝えることで、出力の精度が飛躍的に向上します。

Before（悪い例）：

ログイン機能を作って

After（良い例）：

Next.js 14のApp Routerを使ったプロジェクトに、メール/パスワード認証のログイン機能を追加して。
既存の src/app/api/ にAPIルートがあり、Prisma + PostgreSQLでユーザーテーブルは定義済み。
認証ライブラリはNextAuth.js v5を使いたい。

Before（悪い例）：

バグを直して

After（良い例）：

src/components/UserList.tsx の useEffect で、ユーザー一覧取得時に
コンポーネントのアンマウント後にsetStateが呼ばれて警告が出るバグを修正して。
AbortControllerを使ったクリーンアップ処理を追加する方針でお願いします。

2. 段階的に指示する（タスクの分割）

大きなタスクを一度に丸投げすると、Claude Codeは全体像を見失いやすくなります。複雑な作業は意図的にステップに分割し、段階的に進めましょう。各ステップの完了を確認してから次に進むのがポイントです。

Before（悪い例）：

ECサイトの商品管理機能をフルで作って。一覧、詳細、作成、編集、削除、画像アップロード、
カテゴリ管理、在庫管理、検索フィルタリング全部お願い。

After（良い例）：

商品管理機能を段階的に作ります。まずStep 1として、
商品のCRUD APIを作成してください。

- POST /api/products（作成）
- GET /api/products（一覧、ページネーション付き）
- GET /api/products/:id（詳細）
- PUT /api/products/:id（更新）
- DELETE /api/products/:id（削除）

バリデーションにはzodを使い、既存のsrc/lib/db.tsのPrismaクライアントを利用してください。

Before（悪い例）：

テストを全部書いて

After（良い例）：

src/utils/calculatePrice.ts の単体テストを書いて。
まず正常系のテストケースから始めて、以下を網羅してください：
- 基本価格の計算
- 割引率の適用（10%, 20%, 50%）
- 税込み計算（税率10%）
テストフレームワークはVitestで、既存の tests/ ディレクトリのパターンに合わせて。

3. 期待する出力形式を明示する

プログラミング言語、フレームワーク、コーディングスタイルなど、具体的な出力形式を指定することで、手戻りを大幅に減らせます。特にTypeScriptの型定義やエラーハンドリングのスタイルは明示的に伝えましょう。

Before（悪い例）：

APIクライアントを作って

After（良い例）：

src/lib/api-client.ts に、外部決済API用のクライアントクラスを作成して。

要件：
- TypeScriptでstrict modeに対応した型定義
- fetchベース（axiosは使わない）
- エラーハンドリングはカスタムエラークラス（PaymentApiError）
- リトライロジック（最大3回、exponential backoff）
- レスポンス型はジェネリクスで定義
- JSDocコメントを各publicメソッドに付ける

Before（悪い例）：

Reactコンポーネント作って

After（良い例）：

src/components/DataTable.tsx に再利用可能なテーブルコンポーネントを作成して。

- React Server Componentではなくクライアントコンポーネント（"use client"）
- propsの型はジェネリクスで列定義を受け取る設計
- ソート、ページネーション対応
- スタイリングはTailwind CSSで、既存のsrc/components/Button.tsxのデザイントークンに合わせる
- アクセシビリティ：WAI-ARIA table roleを適切に設定

4. 既存のコードベースを参照させる

Claude Codeの強みは、プロジェクト全体のコードを理解できることです。この能力を最大限に活用するために、「既存のコードに合わせて」と明示的に指示しましょう。具体的なファイルパスを示すとさらに効果的です。

Before（悪い例）：

新しいAPIエンドポイントを追加して

After（良い例）：

src/app/api/users/route.ts と同じパターンで、
src/app/api/orders/route.ts に注文管理のAPIエンドポイントを作成して。

既存のusers APIと同じように：
- zodスキーマによるバリデーション
- try-catchのエラーハンドリングパターン
- NextResponseの返し方
- Prismaクエリの書き方
を踏襲してください。

Before（悪い例）：

設定ページを作って

After（良い例）：

src/app/dashboard/profile/page.tsx を参考にして、
src/app/dashboard/settings/page.tsx を新規作成して。

profileページと同じレイアウト構造（DashboardLayoutコンポーネント、Breadcrumb、
PageHeaderの使い方）を維持しつつ、通知設定とセキュリティ設定のフォームを配置して。
フォーム管理はprofileページと同じくreact-hook-formとzodの組み合わせで。

5. フィードバックループで対話的に改善する

一発で完璧なコードを期待するのではなく、Claude Codeとの対話を通じて段階的に品質を高めましょう。最初の出力を土台にして、具体的なフィードバックで修正を重ねるのが最も効率的です。

Before（悪い例）：

なんか違う、やり直して

After（良い例）：

ありがとう。2点修正をお願いします：
1. handleSubmit関数内のエラーハンドリングで、ネットワークエラーとバリデーションエラーを
   区別してユーザーに表示するようにして
2. ローディング状態のUIを、現在の単純なspinnerから、
   既存のsrc/components/Skeleton.tsxを使ったスケルトンUIに変更して

Before（悪い例）：

もっと良くして

After（良い例）：

パフォーマンスの観点で改善してほしい。具体的には：
1. 商品一覧のレンダリングでReact.memoを適用して不要な再レンダリングを防ぐ
2. 検索入力にdebounce（300ms）を追加する
3. 画像のlazyLoadingを実装する
変更後にLighthouseスコアへの影響を確認できるよう、
変更箇所にコメントを残してください。

まとめ

5つのテクニックを振り返ります：

1. 具体的なコンテキストを提供して、Claude Codeが正確に意図を理解できるようにする
2. タスクを段階的に分割して、一度に処理する範囲を絞る
3. 出力形式を明示して、手戻りを最小限にする
4. 既存コードを参照させて、プロジェクトの一貫性を保つ
5. 対話的にフィードバックして、品質を段階的に高める

これらのテクニックは単独でも効果的ですが、組み合わせることで真価を発揮します。CLAUDE.mdファイルにプロジェクトのルールを記述しておくと、毎回の指示に含める情報量を減らせるのでさらに効率が上がります。

より高度な活用方法については、Claude Codeの生産性を最大化するTips集も参考にしてください。

プロンプトエンジニアリングの基本的な考え方については、Anthropic公式のプロンプトエンジニアリングガイドも合わせてお読みください。