はじめに
プロンプトエンジニアリングとは、AIから狙った通りの出力を引き出すために、指示（プロンプト）の書き方を工夫する技術のことです。ChatGPTやClaudeなどの生成AIが普及するにつれて、「同じAIでも指示の出し方次第で結果が大きく変わる」という実感を持つ人が増えています。
世の中には生成AI全般を対象にしたプロンプトエンジニアリングの解説記事が数多くありますが、この記事では一歩踏み込んで、Claude Codeを使う開発者が実際の開発現場でどう指示を工夫すれば精度が上がるかを具体例つきで解説します。
この記事で分かること
- プロンプトエンジニアリングの基本原則
- Claude Codeの開発現場で使える具体的なテクニック
- 悪い指示・良い指示の比較例
プロンプトエンジニアリングの基本原則
Anthropic公式のプロンプトエンジニアリングガイドでも強調されている、汎用的に使える原則を整理します。
1. 遠回しにせず、直接的に指示する
Claude 4系のモデルは「察してほしい」という曖昧な指示より、やってほしいことを明示的に伝える方が意図通りの結果を得やすい設計になっています。「いい感じにして」ではなく「〇〇を△△の形式で出力して」と具体的に書くことが基本です。
2. 具体例（Few-shot）を示す
出力してほしい形式のサンプルを2〜5個ほど示すと、精度と一貫性が大きく向上します。特に決まったフォーマットで出力してほしい場合に効果的です。
3. コンテキスト（背景情報）を与える
なぜその作業が必要なのか、どんな制約があるのかという背景情報を伝えると、AIはより適切な判断を下しやすくなります。
Claude Codeで実践する具体的テクニック
ここからは、Claude Codeの開発現場ならではの実践テクニックを紹介します。
1. CLAUDE.mdでプロジェクトの背景を一度だけ伝える
毎回のプロンプトでコーディング規約や言語設定を書くのは非効率です。プロジェクトルートにCLAUDE.mdを置いておけば、Claude Codeが自動的に読み込み、以降の指示すべてに反映されます。
## コミュニケーション
- すべてのやり取りは日本語で行うこと
## コーディング規約
- コードの右側にコメントを書くこと
例: const x = 1; // 初期値を設定これにより、毎回のプロンプトは「何をしてほしいか」だけに集中でき、指示がシンプルになります。
2. 大きなタスクは分解してから指示する
悪い例：「このアプリにログイン機能を追加して」
一度に大きすぎるタスクを投げると、Claude Codeは自分なりの解釈で広範囲を変更してしまい、意図しない箇所まで触ってしまうことがあります。
良い例：「まずログイン画面のUIコンポーネントだけ作成して。バックエンドのAPI連携は次のステップで別途指示します」
タスクを段階的に分解し、1回の指示の範囲を絞ることで、レビューしやすい単位で変更を確認できます。複雑なタスクでは/planコマンドで先に作業計画を立ててから実装させるのも効果的です。
3. 期待する出力形式・制約条件を明示する
悪い例：「このコードをリファクタリングして」
良い例：「この関数を、既存の命名規則（キャメルケース）を維持したまま、早期リターンを使う形にリファクタリングして。テストコードは変更しないで」
「変更してほしくない範囲」を明示することも重要です。指示に含まれていない部分まで気を利かせて変更してしまうケースを防げます。
4. 「なぜ」を伝えると精度が上がる
悪い例：「このAPIのタイムアウトを30秒にして」
良い例：「本番環境で外部APIの応答が遅いことがあるため、このAPIのタイムアウトを30秒に延長して。ただしユーザー体験を考慮して、20秒経過時点でローディング表示を出すようにして」
背景（なぜその変更が必要か）を伝えることで、Claude Codeは指示の意図を汲んだ実装を選びやすくなります。
よくある失敗パターン
| 失敗パターン | 改善策 |
|---|---|
| 1回のプロンプトに複数の要求を詰め込む | タスクを分解し、1つずつ指示する |
| 「良い感じに」「適当に」といった曖昧な表現を使う | 期待する状態を具体的に言語化する |
| 前提知識（プロジェクトの構成等）を毎回説明する | CLAUDE.mdに一度書いておく |
| 変更してほしくない範囲を伝えない | 「〇〇は変更しないで」と明示する |
おすすめの学習法
プロンプトエンジニアリングは実践を重ねながら感覚を掴んでいく部分も大きいですが、体系的に学びたい場合は動画講座も有効です。
プロンプトエンジニアリングを学ぼう！-大規模言語モデル（LLM）の真価を引き出す技術-
我妻幸長氏によるベストセラー講座（評価4.2・レビュー2,051件・受講者12,208人）で、Claudeなど特定ツールに依存しない、LLM全般に効くプロンプト設計の考え方を学べます。
まとめ
プロンプトエンジニアリングは、生成AI全般に共通する基本原則（直接的な指示・具体例・コンテキスト）と、Claude Codeならではの実践テクニック（CLAUDE.md活用・タスク分解・制約の明示）を組み合わせることで、日々の開発効率を大きく変えられます。
Claude Codeの使い方全体を体系的に学びたい方は、こちらの記事もあわせてご覧ください。
コメント