Claude Code プロンプト設計術｜AIに最適な指示を出すテクニック【2026年版】

Claude Codeを使っていて、期待通りのコードが出てこないと感じたことはありませんか？ 同じツールでも、プロンプト（指示文）の書き方ひとつで結果が大きく変わります。

この記事では、Claude Codeで最高の結果を引き出すためのプロンプト設計術を、具体的なテンプレートとアンチパターン付きで解説します。

プロンプト設計の4要素フレームワーク

Claude Codeへの指示は、以下の4要素を意識すると格段に精度が上がります。

CTCO フレームワーク

良いプロンプトの例

claude "【Context】
React 19 + TypeScript + TailwindのSPAで、
認証にはSupabase Authを使っています。

【Task】
ログインフォームコンポーネントを作成してください。
メールアドレスとパスワードのバリデーション付き。

【Constraints】
- Zodでバリデーションスキーマを定義
- React Hook Formと連携
- エラーメッセージは日本語
- any型は使わない
- アクセシビリティ（aria属性）対応

【Output】
1. LoginForm.tsx（コンポーネント）
2. loginSchema.ts（Zodスキーマ）
3. LoginForm.test.tsx（Vitestテスト）"

やってはいけない5つのアンチパターン

❌ アンチパターン1: 曖昧な指示

# NG: 何をしたいのか不明確
claude "ログイン画面を良い感じにして"

# OK: 具体的な改善点を指定
claude "ログインフォームの以下を改善してください:
1. バリデーションエラーをインライン表示に変更
2. パスワード表示/非表示トグルを追加
3. ローディング中はボタンをdisabledに
4. Enter キーでフォーム送信できるように"

❌ アンチパターン2: 一括丸投げ

# NG: 範囲が広すぎて品質が下がる
claude "ECサイトのバックエンドを全部作って"

# OK: 機能単位で分割して依頼
claude "商品一覧APIのエンドポイントを作成してください。
GET /api/products
- ページネーション（limit, offset）
- カテゴリフィルタ
- 価格帯フィルタ
- 並び替え（新着順、価格順、人気順）
Prisma + Express + TypeScript で実装"

❌ アンチパターン3: 前提条件を省略

# NG: どのフレームワーク？ どのバージョン？
claude "テストを書いて"

# OK: 技術スタックと対象を明示
claude "src/services/PaymentService.ts のテストを
Vitest + vi.mock で作成してください。
外部API（Stripe）の呼び出しはモック化し、
正常系3パターン、異常系5パターンを網羅してください。"

❌ アンチパターン4: ネガティブ指示のみ

# NG: 「やるな」だけでは何をすべきか不明
claude "any を使うな。変な命名もするな"

# OK: ポジティブに望む形を伝える
claude "型は以下のルールで定義してください:
- プリミティブ型 or カスタム型定義を使用
- ユニオン型で柔軟性を確保
- 関数の引数・返り値に必ず型注釈
- 命名規則: インターフェースはIプレフィックスなし"

❌ アンチパターン5: 段階的確認なしの長大タスク

# NG: 全部一気にやらせて、途中で方向がズレる
claude "このプロジェクト全体をNext.js 15にマイグレーションして"

# OK: ステップ分割 + 各ステップで確認
claude "Next.js 14→15へのマイグレーション計画を立ててください。
1. 破壊的変更の影響範囲を分析
2. マイグレーション手順を優先度順にリスト化
3. 各ステップのリスクと対処法
まずは分析結果だけ出してください。実行は次のステップで指示します。"

開発現場で使えるプロンプトテンプレート集

テンプレート1: コードレビュー

claude "以下の観点でコードレビューしてください:

【重大度: High】
- セキュリティ脆弱性（XSS, SQLi, IDOR）
- データ漏洩リスク
- 認証・認可の不備

【重大度: Medium】
- パフォーマンス問題（N+1クエリ、不要な再レンダリング）
- エラーハンドリングの不備
- 型安全性の問題

【重大度: Low】
- 命名規則の違反
- コードの重複
- ドキュメント不足

git diff main...HEAD の内容を確認し、
指摘事項を重大度別に整理して報告してください。"

テンプレート2: リファクタリング

claude "src/legacy/OrderProcessor.ts をリファクタリングしてください。

【現状の問題点】
- 1ファイル800行の神クラス
- 責務が混在（注文処理 + 在庫管理 + 通知）
- テストなし

【目標】
- Single Responsibility Principleに従って分割
- 各クラスは200行以内
- インターフェースで依存性逆転
- 既存の動作を変えない（リファクタリングのみ）

【ステップ】
1. まず現在のクラスの責務を分析して報告
2. 分割案を提示（承認後に実行）
3. テストを先に書いてから分割を実行"

テンプレート3: バグ調査

claude "本番環境で以下のバグが報告されています:

【症状】
- ユーザーがカートに商品を追加すると、
  まれに数量が2倍になる
- 再現率: 約10%
- ブラウザ: Chrome, Safari両方で発生

【仮説】
- React StrictModeによるダブルレンダリング？
- useEffectの依存配列の問題？
- Race conditionの可能性？

src/hooks/useCart.ts と
src/components/AddToCartButton.tsx を分析し、
根本原因を特定してください。
修正案はテスト付きで提示してください。"

テンプレート4: 設計相談

claude "新機能の設計について相談です。

【要件】
- リアルタイム通知機能を追加したい
- ユーザーへの通知種類: メール/プッシュ/アプリ内
- 通知ルール: イベントごとに通知先を設定可能
- スケーラビリティ: 将来的に月100万通知に対応

【技術制約】
- バックエンド: Node.js + TypeScript
- インフラ: AWS（ECS, SQS, SES利用可）
- 予算: 月$500以内

以下を提案してください:
1. アーキテクチャ図（Mermaid形式）
2. 技術選定と理由
3. データモデル設計
4. 段階的な実装計画（MVP→本番）"

プロンプト改善の3つのコツ

コツ1: 出力を見てから追加指示する

完璧なプロンプトを一発で書く必要はありません。出力を見てから軌道修正するのが実践的です。

# 最初の指示
claude "ユーザー一覧APIを作成してください"

# 出力を見て追加指示
claude "いい感じです。以下を追加してください:
- ページネーションのレスポンスにtotal, hasNextを含める
- 管理者ロールの場合のみメールアドレスを返す
- レスポンスにキャッシュヘッダーを追加（max-age: 300）"

コツ2: 例を示す（Few-shot）

望む出力形式がある場合、具体例を1つ示すと精度が劇的に上がります。

claude "APIエラーレスポンスの型を統一します。
以下の形式で全エンドポイントを修正してください:

【期待する形式の例】
{
  \"success\": false,
  \"error\": {
    \"code\": \"AUTH_TOKEN_EXPIRED\",
    \"message\": \"認証トークンの有効期限が切れています\",
    \"details\": { \"expiredAt\": \"2026-02-22T10:00:00Z\" }
  }
}

この形式に統一されていないエンドポイントを
洗い出して修正してください。"

コツ3: ロールを与える

Claude Codeに専門家の役割を与えると、より深い分析が得られます。

claude "あなたはセキュリティエンジニアとして、
このプロジェクトのセキュリティ監査を行ってください。
OWASP Top 10の各項目について、
このコードベースでのリスクを評価し、
対策の優先度をつけてください。"

まとめ

Claude Codeのプロンプト設計は、**CTCOフレームワーク（Context → Task → Constraints → Output）**を意識するだけで大幅に改善します。

アンチパターンを避け、テンプレートを活用すれば、開発現場でも一貫した高品質な出力を得られます。最初から完璧を目指す必要はありません。出力を見ながら追加指示で軌道修正するのが、実践的なプロンプト設計の極意です。

次のエピソード: Ep.5 Claude Code vs GitHub Copilot vs Cursor 徹底比較では、主要AIコーディングツール3つをエンジニアの視点で比較します。

よくある質問

Link1 Link2 Link3

ああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああ