HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

Claude 5世代モデルのためのコンテキストエンジニアリングの新ルール

The new rules of context engineering for Claude 5 generation models (claude.com)

415 pointsby mellosouls313 コメント

要約

AnthropicはClaude 5世代モデル向けに、コンテキストエンジニアリングの手法を刷新しました。システムプロンプトの80%以上を削減し、モデルに判断を委ねる方向へシフトしたことで、より高度な応答が可能になったと報告しています。この記事では、この経験から得られた教訓を、Claude Codeや自作エージェントでのコンテキストエンジニアリングに応用する方法を解説しています。

全文翻訳

Claude 5世代モデルのためのコンテキストエンジニアリングの新ルール

以前、私は最新世代のClaude 5モデルをプロンプトする方法や、それを反復的に使用して構築したいものを発見する方法について書きました。

しかし、Claudeにメッセージを送信する際、プロンプトはそのモデルが受け取るコンテキストのごく一部にすぎません。コンテキストの多くは、システムプロンプト、スキル、CLAUDE.mdファイル、メモリ、その他のソースから組み立てられます。私たちはこれをコンテキストエンジニアリングと呼び、Claude Codeを使用したり、独自のAIエージェントを構築したりする際に生成される結果に大きな影響を与えます。

プロンプトとは異なり、コンテキストは多くのリクエスト全体で一般的に使用されるため、それほど具体的にすることはできません。ユーザーのプロンプトが何になるかわからない場合、これらの一般的なプロンプトやガイダンスをClaudeのためにどのように構築すればよいのでしょうか?

Claude自身の能力が進化するにつれて、これは驚くほど困難になる可能性があります。最近、最新世代のClaudeモデルのプロンプト方法に大きな飛躍が見られました。Claude Opus 5やClaude Fable 5のようなモデルでは、コーディング評価において測定可能な損失なしに、Claude Codeのシステムプロンプトの80%以上を削除しました。

この新しいクラスのモデルをプロンプトする方法について学んだこと、そしてそれをコンテキストエンジニアリングの更新にどのように活用できるかを以下に示します。これらのベストプラクティスはclaude doctorに組み込まれています。Claude Codeで/doctorコマンドを使用して、スキルやCLAUDE.mdファイルを適切なサイズに調整してください。

CLAUDEの制約を解く

全体として、システムプロンプト、CLAUDE.mdファイル、スキルを通じて、Claude Codeに過剰な制約を与えていたことがわかりました。

例えば、Claude Codeの自身の内部使用のトランスクリプトを読むと、システムプロンプトで「ドキュメントは適切に残す」や「コメントは絶対に追加しない」といった矛盾するメッセージが1つのリクエストに含まれていることがわかります。システムプロンプト、スキル、ユーザーリクエストが互いに衝突しているのです。

[画像: システムプロンプトの行「leave documentation as appropriate」、スキルの行「do not add comments」、ユーザーリクエスト「just make it work like the old one」を含む、組み立てられたコンテキスト。]

一般的に、Claudeはユーザーの意図を解釈して正しい答えにたどり着くことができますが、これらの重複し、矛盾するメッセージについて、決定を下す前にClaudeはより慎重に考える必要があります。

そして、これらの制約はかつて最悪のシナリオを回避するために必要でしたが、現在ではそれらの多くを削除し、モデルが周囲のコンテキストと判断力を使用できるようにできることがわかりました。

さらに、Claude Codeは現在、はるかに多くのツールを持っています。以前は、Claudeはメモリ、情報、ガイダンスのソースとしてCLAUDE.mdに依存していました。今では、メモリ、アーティファクト、スキルがあり、Claudeはセッション間でコンテキストをロードおよび共有する新しい方法を作成するためにこれらを使用できます。

過去と現在

コンテキストエンジニアリングの以前のベストプラクティスのいくつかは、神話になっていました。それらには以下が含まれます。

[画像: 6つの古いルールが取り消し線で引かれ、それぞれがその置き換えを示しています:Claudeにルールを与える → Claudeに判断力を与える;Claudeに例を与える → インターフェースを設計する;すべてを upfront に置く → プログレッシブ開示を使用する;繰り返し言う → シンプルなツール説明;CLAUDE.mdファイルでのメモリ → 自動メモリ;シンプルな仕様 → リッチな参照。]

過去:Claudeにルールを与える
現在:Claudeに判断力を使わせる

Claude Codeを最初に展開したとき、Claudeがファイルを削除するなどの最悪のシナリオを回避することを確実にする必要がありました。これは、常に真実とは限らない強力なガイダンスを与えることを意味していました。例えば、システムプロンプトでは次のように述べていました。

コード内:コメントなしで記述することをデフォルトとする。複数行のドキュメンストリングや複数行のコメントブロックは絶対に作成しない — 最大で短い1行のみ。ユーザーが依頼しない限り、計画、決定、分析ドキュメントを作成しない — 中間ファイルではなく、会話コンテキストから作業する。

しかし、特定のプロンプトのサブセットでは、このガイダンスは間違っていました。ドキュメントの場合、ユーザーは独自の好みを持っている可能性があり、非常に複雑なコードの特定のセクションでは複数行のコメントブロックが必要になる場合があります。

それでも、古いモデルではこれらのガードレールなしでは、Claudeが書いたコメントは多くの場合不正確であり、このトレードオフを受け入れる必要がありました。しかし、新しいモデルはより優れた判断力を持ち、明示的なルールなしでこれらの決定をうまく処理できます。

新しいシステムプロンプトでは、次のように述べています。周囲のコードのように読めるコードを書く:コメントの密度、命名規則、イディオムを一致させる。

過去:Claudeに例を与える
現在:インターフェースを設計する

ツールの使用に関する最優先ルールは、Claudeにそれらの使用方法の例を与えることでした。最新のモデルでは、例を与えることが実際にはそれらを特定の探索空間に制約してしまうことがわかりました。

[画像: 以前:9,100文字程度のTodoWriteツールの説明、使用時期リストと実行例。以後:短い説明「現在のセッションのタスクリストを作成および更新する」、pending、in_progress、completed のステータス列挙型、および1つのルール「一度にin_progressのタスクは1つのみ」。]

例を使用する代わりに、ツール、スクリプト、ファイルの設計について考えてみてください。Claudeにはどのようなパラメータがあり、それらをより表現力豊かにするにはどうすればよいでしょうか?

例えば、Todoツールの例では、ステータスをpending、in_progress、completed の列挙型としてリストするだけで、Claudeにその使用方法を示唆します。in_progress のアイテムを1つだけ維持するという指示は、要求された動作を定義するのに役立ちます。

過去:すべて upfront に置く
現在:プログレッシブ開示を使用する

Claude Codeはコーディングに焦点を当てていたため、システムプロンプトにはコードレビューと検証の方法に関する詳細情報が含まれていました。これらは常に必要だったわけではありませんが、必要だった場合には重要な情報でした。

それ以来、Claude Codeはプログレッシブ開示(適切なタイミングで適切なコンテキストをロードする)を非常にうまく使用できるようになりました。例えば、検証とコードレビューをClaude Codeが選択的に呼び出すことができる独自のスキルに移動しました。

しかし、プログレッシブ開示はスキルだけでなく、ツールにも使用されます。一部のツールは「遅延ロード」されており、エージェントはそれらを使用する前にToolSearchを使用して完全な定義を検索する必要があります。これにより、コンテキストを必要になるまで消費しないタスクツールのような、より多くのツールを持つことができます。

これは、独自のCLAUDE.mdおよびSkill.mdファイルにも適用できます。一般的な神話は、遭遇する可能性のあるすべての既知のプラクティスのセントラルリポジトリにしたいというものです。なぜなら、そうでなければClaudeが見つけられないからです。代わりに、適切なタイミングでロードできるファイルのツリーを検討してください。

過去:繰り返し言う
現在:シンプルなツール説明

以前のClaudeモデルは、指示を繰り返す必要があったり、コンテキストウィンドウの最後にある指示を最初にある指示よりも聞きやすい場合がありました。これは、システムプロンプトに、メインシステムプロンプト内のツールへの参照と、ツール説明内の指示の両方が含まれる場合があることを意味していました。

これらの繰り返し例を削除し、ツール使用方法の指示をシステムプロンプトではなくツール説明に配置できることがわかりました。

過去:CLAUDE.mdファイルでのメモリ
現在:自動メモリ

以前は、ユーザーに#ホットキーを使用してCLAUDE.mdに自動的に書き込むことで、Claudeのメモリに何かを保存することを推奨していました。代わりに、Claudeは現在、作業とあなたに関連するメモリを自動的に保存します。

過去:シンプルな仕様
現在:リッチな参照

プランモードでは、Claude Codeはプランを含むMarkdownファイルに大きく依存していました。これらのファイルをプランとして保存することで、Claudeが必要に応じて参照できるようになりました。同様のベストプラクティスとして、Claudeが長期プロジェクトで作業する際に参照できるように、コードベースに仕様を保存することがありました。

しかし、Claudeはますます複雑な参照を処理できることがわかりました。シンプルなMarkdownファイルではなく、新しいアーティファクト機能によって作成されたHTMLアーティファクトを参照できます。

Claudeにコードの形式で参照を与えることもできます。仕様は詳細なテストスイートである場合もあれば、Claudeがポートする可能性のある別のコードベースの関数である場合もあります。

ルーブリックも参照の一形態です。ルーブリックは、Claudeが特定の分野でのあなたの好みを試して検証できるようにします(例:優れたAPIデザインとはどのようなものか)。動的ワークフローを使用し、それらのルーブリックを持つ検証エージェントを起動します。

コンテキストへの適用

これらすべてをまとめると、コンテキストを組み立てるとき、それはどのようになりますか?

[画像: コンテキストウィンドウがスタックとして描画されています:一番上にあなたのプロンプト、次にファイル(@-メンションされたファイル、仕様、モックアップ、コードベース、アーティファクト)などの参照、次にシステムプロンプト、CLAUDE.mdファイル、スキル、メモリ。]

システムプロンプト

システムプロンプトは製品コンテキストに強く結びついています。Claudeがどの製品で動作し、何をしているかを伝えます。Claude Codeの場合、これを変更することはほとんどないでしょうが、独自のAIエージェントハーネスを構築している場合は、ここに多くの時間を費やすべきです。

CLAUDE.md

CLAUDE.mdを軽量に保ち、リポジトリが何であるかを簡潔に説明してください。ただし、トークンの大部分はコードベース内の注意点に費やしてください。例えば、型を1つのモノリシックファイルにのみ配置するようにコードを整理することができます。ファイルシステムやリポジトリを見たときにClaudeが知るべき「明白な」ことを述べるのは避けてください。

プログレッシブ開示を多用してください。例えば、作業を検証するためのいくつかのユニークな指示がある場合は、検証スキルを作成し、CLAUDE.mdから参照してください。

スキル

スキルは、Claudeが必要な情報を見つけられるようにするための軽量なガイドと考えてください。非常に重要な領域を除いて、過度に制約しないようにしてください。

長いスキルについては、可能な限りプログレッシブ開示を使用してください。多くのファイルに分割し、それらを分離してください。

スキルがあなた、あなたのチーム、または製品固有の特定の意見、知識、またはベストプラクティスをエンコードしている場合に最適です。

参照

ファイルを@メンションして、参照として含めることができます。参照により、Claudeは現在のプランに関する詳細情報にアクセスできます。

これは仕様ファイル、モックアップ、あるいはコードベース全体である可能性があります。一般的には、コード内のファイルの方が、Claudeが非常に得意とする言語で明確で高忠実度の指示を提供するため、好ましいです。例えば、デザインのHTMLモックアップは、デザインの説明やスクリーンショットよりも一般的に優れた結果をもたらします。

シンプル化を試す

システムプロンプト、スキル、CLAUDE.mdファイル全体で、私たちが行ったようにシンプル化する必要があるかもしれません。私たちはclaude doctorという新しいコマンドをリリースしました。これは、これを自動的に行うのに役立ちます。より高度なモデルに特化したプロンプトの詳細については、Fableフィールドガイドをご覧ください。

この記事は、AnthropicのテクニカルスタッフメンバーであるThariq Shihiparによって書かれました。