Claude Codeプロンプトの書き方8つのコツ

「Claude Codeに指示したのに、思っていた出力と全然違うのはなぜなの？」
「プロンプトの書き方にコツがあるなら知りたい！」

「なんか意図が伝わっていない気がする」「修正を頼んだら余計に複雑になった」という感覚の多くは、プロンプトの書き方を少し変えるだけで解消できます。

この記事では、実際にClaude Codeを使いながら試行錯誤の末に気づいた8つのコツを解説します。

Claude Codeプロンプトが「なんとなく」では通じない理由

Claude Codeは会話AIと違い、コードを書いてファイルを操作してコマンドを実行する「エージェント」です。そのぶん、指示の曖昧さが直接、出力のブレに繋がります。

「いい感じに直して」は最も危険な指示

「いい感じにリファクタリングして」という指示を出したとき、Claude Codeはどう動くでしょうか。

変数名を変える場合もあれば、関数を分割する場合も、コメントを追加するだけの場合もあります。「いい感じ」の定義が曖昧なまま任せると、意図とまったく異なる方向に進んでしまいます。

Claude Codeに限らず、AIエージェントへの指示で「曖昧さ」は最大のリスクです。

Claude Codeプロンプトが迷子になる3つの原因

実際によく遭遇する、Claude Codeが意図通りに動かない原因は主に3つあります。

これらの原因を意識するだけで、プロンプトの書き方がかなり変わります。
次の章から、これらを解消する具体的なコツを見ていきましょう。

Claude Codeプロンプトのコツ①〜③：土台の整え方

Claude Codeプロンプトの精度を高めるには、まず土台となる3つの要素を押さえることが重要です。ここを丁寧にするだけで、出力の質が一段変わります。

コツ①　タスクは1つに絞る

1つのプロンプトには、1つのタスクだけを書く——これが最も効果的なルールです。

「ログイン機能を作って、あとバリデーションも追加して、エラーメッセージも日本語にして」と一度に頼むと、Claude Codeはそれぞれを処理しながら整合性を保とうとして、かえってミスが増えます。

まずログイン機能だけ作る。確認してから、バリデーションを追加する。この順番を守るだけで、修正の手間が大きく減ります。

コツ②　背景（コンテキスト）を必ず添える

Claude Codeは、あなたのプロジェクトの文脈を自動でわかってくれるわけではありません。関連するファイルや今の状況を都度、一緒に伝える必要があります。

たとえばこんな形で渡すと伝わりやすくなります。

背景を渡すことで、Claude Codeは「このプロジェクトでの正解」を判断できるようになります。

コツ③　出力形式を明示する

「この関数を改善して」という指示に対して、Claude Codeが出力するのはコードのみか、説明付きか、それともテストコードまで含めるかは、あなたが指定しない限り一定しません。

「コードのみ・コメントなし・TypeScript形式で」のように出力形式を先に明示しておくと、余計な部分が混入せず、すぐ使える出力が得られます。

Claude Codeプロンプトのコツ④〜⑧：精度を上げる応用技

土台が整ったら、次はより精度を高める5つの応用技を取り入れていきます。Claude Codeプロンプトの可能性をさらに引き出す工夫です。

ここでは、以下の内容について詳しく解説します。

コツ④　「やってほしくないこと」を先に書く

ポジティブな指示だけでなく、ネガティブな制約を明示することで、出力が格段に安定します。

「既存のテストを壊さないように」「`main` ブランチには直接コミットしないで」「外部ライブラリを追加しないで」——こういった制約を最初に書いておくと、後から「そこは変えないでほしかった」という事態を防げるのです。

やることを増やすより、やらないことを先に定義するほうが、出力の安定感は上がります。

コツ⑤　CLAUDE.mdで繰り返し指示を省く

毎回同じことをプロンプトに書いているなら、それはCLAUDE.mdに書くべき内容です。

プロンプトが「今やるタスク」に集中できるようになるため、指示の精度も自然と上がります。

CLAUDE.mdの具体的な書き方は、「Claude Code CLAUDE.mdの書き方｜動作カスタマイズを自在にするコツ」もあわせてご覧ください。

コツ⑥　段階的に確認を挟む

長い処理を一気にやらせるより、途中で確認ポイントを設けるほうが安全です。

「まず設計だけ提案して。OKなら実装に進んで」という形で指示すると、方向性がずれたまま大量のコードが生成されるリスクを減らせます。

特に新機能の実装や、既存コードの大幅な変更を依頼するときに効果的です。

コツ⑦　役割（ロール）を与えて判断の軸を示す

プロンプトの冒頭で「あなたはセキュリティを重視するシニアエンジニアです」のように役割を与えると、Claude Codeが迷ったときの判断基準がぶれにくくなります。

役割を指定しない場合、Claude Codeは「無難で汎用的な」出力を選びがちです。「パフォーマンスを最優先するインフラエンジニアとして」「初心者にもわかるように教えるメンターとして」のように役割を変えるだけで、同じ質問でも出力の切り口が変わります。

レビュー依頼では「厳格なコードレビュアーとして、妥協せず指摘して」と伝えると、遠慮のない指摘が返ってくるようになり、見落としを減らせます。

コツ⑧　うまくいかなかったプロンプトを育て直す

プロンプトは一発で完成するものではありません。意図した出力にならなかったとき、「なぜ通じなかったか」を分析して次の指示に活かすことで、精度が徐々に上がっていきます。

よくある改善ポイントはこの3つです。

失敗したプロンプトをそのまま捨てず、原因を把握して書き直す習慣をつけると、プロンプトの質は着実に上がります。

用途別に使えるClaude Codeプロンプトのテンプレート集

ここまでの8つのコツを踏まえたうえで、よく使う場面別にそのままコピペできるプロンプトのテンプレートを紹介します。角括弧の部分を自分の状況に合わせて書き換えて使ってください。

ここでは、以下の内容について詳しく解説します。

コード生成のテンプレート

新しい機能を実装してもらうときの基本形です。背景・タスク・制約・出力形式の4要素を順番に埋めるだけで、迷わないプロンプトになります。

【背景】[プロジェクトの概要・使用技術・関連ファイルのパス]
【タスク】[実装してほしい機能を1つだけ具体的に]
【制約】[やってほしくないこと・変更してはいけない範囲]
【出力形式】コードのみ／コメントなし／[使用言語]形式で

複雑なタスクを依頼する場合は、この4要素をXMLタグのように区切って渡すと、Claude Codeがどこまでが背景でどこからが指示かを取り違えにくくなります。

リファクタリング・レビューのテンプレート

「いい感じに直して」を避け、対象範囲と観点を絞り込むテンプレートです。役割を与えることで、指摘の遠慮がなくなります。

あなたは厳格なコードレビュアーです。妥協せず指摘してください。

【対象】[ファイルパスまたは関数名]
【観点】可読性／パフォーマンス／セキュリティのうち[選択]を優先
【出力形式】指摘事項を箇条書きで。修正コードは別途確認してから依頼する

「まず指摘だけ」「OKが出たら修正コードも」と段階を分けると、意図しない大規模な書き換えを防げます。

デバッグ・エラー修正のテンプレート

エラーが発生した場合、エラーメッセージをそのままプロンプトに貼り付けるのが最速の対処です。「なんかエラーが出た」ではなく、スタックトレースごと渡すことで、Claude Codeは原因を正確に特定して修正案を出してくれます。

以下のエラーが発生しました。原因を特定し、修正案を提示してください。

【エラーメッセージ】
[スタックトレースをそのまま貼り付け]

【実行環境】[言語・フレームワークのバージョン]
【直前に行った変更】[わかる範囲で]

エラー対処法をさらに詳しく知りたい方は、「Claude Codeのエラー対処法｜よく出るエラー7選と解決手順」もあわせてご覧ください。

テストコード作成のテンプレート

テストの網羅範囲を指定しないと、当たり前のケースしかカバーされないことがあります。境界値や異常系まで含めるよう明示しましょう。

【対象】[テストしたい関数・コンポーネント名]
【使用ツール】[Jest / pytest など]
【網羅範囲】正常系・境界値・異常系（null/空文字/上限値）をすべて含める
【出力形式】テストコードのみ。既存のテストファイル構成に合わせる

テンプレートはあくまで出発点です。プロジェクトの実情に合わせて言い回しを調整しながら、自分専用の型に育てていくのがおすすめです。

実際に使ってわかった：Claude Codeプロンプト設計で気づいた3つのこと

ここからは、実際にClaude Codeを使ってきた中で気づいた、マニュアルには載っていないポイントを3つ紹介します。

「長いプロンプト」が必ずしも良いわけではない

丁寧に書こうとするあまり、プロンプトが長くなりすぎることがあります。

情報量が多すぎると、Claude Codeがどこに集中すべきかを見失うことがあります。「必要な情報を過不足なく」が基本で、タスク1つに対して5〜10行程度が扱いやすい目安です。

セッション全体で見たときに、どこがコンテキストを食っているかを把握しておくと、削る判断が早くなります。確認方法はClaude Codeのコンテキスト枯渇対策｜劣化を防ぐ削り方にまとめています。

英語と日本語はどちらでも問題ない

プロンプトを英語で書くべきか日本語で書くべきか悩む場合もあるかもしれませんが、どちらでも動作の精度に大きな差はありません。

ただし、コードベースが英語のコメント・変数名で構成されている場合は、英語プロンプトのほうが整合性の取れた出力になることがあります。プロジェクトの主言語に合わせるのが自然です。

プロンプトを書く力は実装速度に直結する

最初の頃は、1つの機能を作ってもらうのに何度もやり取りを重ねていました。曖昧な指示を出しては、意図と違う結果が返ってきて、修正を頼んでは、また違う方向に直される——その繰り返しです。

プロンプトを書く力は、コードを書く力とは別の筋力です。意識して鍛えるほど、Claude Codeとのやり取り全体が速くなります。

Claude Codeプロンプトに関するよくある質問

Claude Codeのプロンプトについて、よく寄せられる質問をまとめました。

Q：プロンプトの長さはどのくらいが適切ですか？

A：タスク1つに対して5〜10行が目安です。背景・タスク内容・出力形式の3要素を含めつつ、余分な情報は省くことを意識してください。長すぎるプロンプトはClaude Codeが焦点を絞りにくくなる場合があります。

Q：日本語と英語どちらで書けばいいですか？

A：どちらでも精度に大きな差はありません。ただしコードベースの言語（コメントや変数名）と揃えると、整合性の取れた出力になりやすいです。迷うならプロジェクトの主言語に合わせてください。

Q：同じプロンプトを効率よく使い回す方法はありますか？

A：繰り返し使うルールはCLAUDE.mdに書いておくのが最も効果的です。また、よく使うプロンプトをテキストファイルとして手元に保存してコピペする方法もシンプルで使いやすいです。

Q：役割（ロール）を指定すると必ず出力がよくなりますか？

A：万能ではありませんが、判断が分かれる場面では有効です。「速度重視かセキュリティ重視か」のように選択肢が複数あるタスクほど、役割を与えることで判断の軸がはっきりし、出力のブレが減ります。

Q：プロンプトにXMLタグのようなものを使う必要はありますか？

A：必須ではありませんが、背景・タスク・制約が長くなる複雑な指示では、区切りを明示すると誤読を防げます。「【背景】」「【タスク】」のような角括弧の見出しでも同様の効果があるため、まずはこの記事のテンプレートのような簡易的な区切りから試すのがおすすめです。

Claude Codeプロンプトのコツをまとめる

Claude Codeのプロンプトで大切なのは、「AIが迷わないように設計する」という意識です。

• タスクは1つに絞り、背景を添えて、出力形式を明示する（土台の3つ）
• 「やってほしくないこと」「CLAUDE.mdの活用」「段階的な確認」「役割の指定」「失敗の育て直し」で精度を上げる（応用の5つ）
• 用途別のテンプレートを自分専用の型に育てていく

プロンプトを書く力は、練習で確実に上がります。うまくいかない経験を積み重ねながら少しずつ磨いていくと、Claude Codeとのやり取りがぐっとスムーズになります。

プロンプトの前にClaude Code全体の流れを確認したい方は、「Claude Codeの使い方まとめ｜初心者向けに詳しく解説」もあわせてご覧ください。

Claude Codeを使いこなす力は、そのまま「AIを業務に組み込める人」の市場価値につながります。独学で埋めきれない部分を講座で補いたい方は、社会人におすすめの生成AI研修スクール｜スクール6校を比較が判断材料になります。