モデル別ガイド

Claude のプロンプティング:実践ガイド

Claude へのプロンプトの書き方。XML タグ、長いドキュメントの置き場所、例、拡張思考、明示的な指示、Claude 特有の間違いを解説します。

英語の原文からの翻訳です。コード、プロンプト、モデルの出力は英語のまま掲載しています。

Anthropic のモデルファミリーである Claude も、他のどのモデルとも同じ基本に反応します。明確なタスク、関連する文脈、示された形式です。このガイドでは、Anthropic が公開しているプロンプティングのガイダンスに基づき、特に Claude で重要になる習慣を扱います。

モデル名や制限は変わるので、ここでのアドバイスは安定した挙動に関するものです。現在のモデルについては Anthropic のドキュメントを確認してください。

明確に、直接的に、具体的に

Anthropic の最初の推奨は、Claude を、あなたのプロジェクトについての文脈を持たない有能な新しい同僚として扱うことです。出力が何のためのものか、誰が読むのか、良い結果とはどういうものかを伝えましょう。

最近の Claude のモデルは、指示に正確に従います。そこから計画しておくべき 2 つの影響があります。

  • 望むことを頼む。 文字どおりの依頼を超えて Claude に動いてほしいとき、たとえば変更を提案するだけでなく実装してほしいときは、そう伝えます。
  • 強調をやめる。 大文字や「CRITICAL」は不要で、ルールが広く適用されすぎる原因になりえます。素直な 1 文で十分です。

理由を説明する

Claude は、理由から上手に一般化します。比べてみてください。

  • Never use ellipses.
  • Your response will be read aloud by a text-to-speech engine, so never use ellipses, because the engine cannot pronounce them.

後者なら、列挙していない関連ケースも Claude が扱えます。

XML タグでプロンプトを構造化する

Claude は、プロンプトの各部分を区切る XML 風のタグと特によく相性が合います。特別なタグ名はありません。内容を表す名前を選び、一貫して使いましょう。

Review the contract in <contract> tags against the checklist in
<checklist> tags. Put your findings in <findings> tags.

<contract>
{{contract_text}}
</contract>

<checklist>
{{checklist}}
</checklist>

タグには 3 つの利点があります。Claude が指示とデータを混同しない、名前でセクションを参照できる、コードが簡単に抽出できるタグで出力を頼める、です。

長いドキュメントは先頭に置く

長い入力では、ドキュメントをプロンプトの冒頭近くに、質問や指示を末尾に置きます。Anthropic は、長いドキュメントの後に置いたクエリが、応答の品質を目に見えて改善しうると報告しています。

複数のドキュメントでは、それぞれを出典メタデータ付きの専用タグで囲みます。

<documents>
  <document index="1">
    <source>q3-report.pdf</source>
    <document_content>{{report}}</document_content>
  </document>
</documents>

Using the documents above, list the three largest risks.

長い資料に対するタスクでは、まず Claude に関連する箇所を引用させ、その引用に基づいて答えさせます。RAG のプロンプティングを参照してください。

例を使う

例は、形式、トーン、構造を導く最も確実な方法のひとつです。Claude が例示として扱えるよう <example> タグで囲み、バリエーションを持たせましょう。Claude は例に細かく注意を払い、すべての例に共通するパターンを、意図しないものも含めて再現します。

システムプロンプトで Claude に役割を与える

役割と常設のルールはシステムプロンプトに、タスクはユーザーのターンに置きます。役割を 1 文書くだけでも、トーンと深さが定まります。システムプロンプトとロールプロンプティングを参照してください。

拡張思考

Claude のモデルは、答える前に推論できます。この機能を拡張思考(extended thinking)と呼びます。オンのときは次のようにします。

  • 各ステップを細かく指定せず、高レベルの指針(「エッジケースを慎重に考えて」)を与える。Claude 自身のやり方は、台本どおりのやり方より優れていることが多いです。
  • 見せてほしいとき以外は、回答でのステップごとの推論まで頼まない。
  • ミスのコストが大きいタスクでは、終える前に作業を検証するよう Claude に頼む。

思考がオフのときは、<thinking> タグの中で推論してから <answer> タグで答えるよう Claude に頼むと、似た効果があります。思考の連鎖プロンプティングを参照してください。

形式を制御する

  • 避けることではなく、すべきことを言う。 「Markdown を使わないで」より、「流れるような段落で書いて」のほうがうまくいきます。
  • スタイルを合わせる。 プロンプトの書式は、応答の書式に影響します。素直な文章のプロンプトには、文章で返ってきやすくなります。
  • パースする部分にはタグを頼む。
  • 厳密な JSON には、入力スキーマ付きのツール使用か、構造化出力機能を使い、結果を検証します。構造化出力のプロンプトを参照してください。

ツールとエージェント

Claude は、Anthropic が発表したModel Context Protocol を含め、エージェントの場面で広く使われています。

  • 各ツールを詳しく説明する。何をするか、いつ使うか、何を返すか。
  • Claude が行動すべきか、提案だけにとどめるべきかを明示する。この指示には忠実に従います。
  • 長いタスクでは、コンテキストがリセットされても進捗が残るよう、Claude にファイルへメモを取らせる。
  • 独立したツール呼び出しは並列で実行できます。速度がほしければ、そう伝えます。

AI エージェント向けのプロンプトを参照してください。PromptFlowEngine の MCP サーバーは Claude Desktop や Claude Code に追加でき、Claude がツールとしてプロンプトを分析、再構成、無害化できるようになります。

トークン数とキャッシュ

Anthropic は現行モデル向けのオフライン用トークナイザーを公開していないため、オフラインの数値は近似です。PromptFlowEngine が Claude の数値を「近似」と表示するのはそのためです。正確な値が必要なら、Anthropic のトークン数カウント用エンドポイントを使ってください。

プロンプトキャッシュはオプトインです。プロンプトの固定部分の終わりに印を付けると、繰り返しのリクエストは割引料金でそれを読み取ります。変わらない内容を先に置いてください。トークン最適化を参照してください。

Claude でよくある間違い

間違い 起こること 対策
ルールを大文字で強調する 過剰適用される 理由を添えた素直な記述
長いドキュメントの前に質問を置く ドキュメントの活用が弱まる ドキュメントが先、質問は最後
貼り付けた内容に印がない 指示とデータが混ざる XML タグで囲む
均一な例だけを使う 意図しないパターンがコピーされる 例にバリエーションを持たせる
主体性を期待して曖昧に頼む 文字どおりの最小限の答え 追加の作業を明示的に頼む
否定形の書式ルール 書式が一定しない 望む書式を述べる

Claude 向けプロンプトの最適化

  1. タスクとその目的を述べる。
  2. 各入力を、内容が分かるタグで囲む。
  3. 長いドキュメントを先頭へ、質問を末尾へ移す。
  4. 形式やトーンが重要なら、バリエーションのある例を 2〜3 個加える。
  5. 繰り返しと強調を取り除く。

PromptFlowEngine のプロンプトオプティマイザーは構造化モードで、テンプレート変数をタグで囲み、繰り返された指示を取り除いたうえで、何も失われていないことを検証します。Chrome 拡張機能は、claude.ai 内で同じことを行います。

ChatGPT と OpenAI のプロンプティングガイドと Gemini のプロンプティングガイドとも比較してみてください。

実践してみる

プロンプトオプティマイザーで試す

すべての要件が残っていることを証明しながら、トークンを削り、構造を加えます。 無料・決定論的で、アカウントは不要です。

関連する PromptFlowEngine ツール