ブログ

2026年のコンテキストエンジニアリング:その意味、プロンプトエンジニアリングとの違い、Claude Codeでの活用方法

Markdown

コンテキストエンジニアリングとは何か、プロンプトエンジニアリングとどう異なるのか。Anthropicの基本資料、7つの失敗、Claude Codeの最小構成。

記事の全文を読む

重要なポイント

コンテキストエンジニアリングとは、メッセージを送る前にClaudeのコンテキストウィンドウへ入るすべての要素、すなわちシステムプロンプト、ツール、履歴、メモリファイル、ツールからのデータを設定する技術です。2026年には、重要なスキルとしてプロンプトエンジニアリングに取って代わりました。Anthropicがそう述べています。このガイドでは、一次資料に基づく基本資料、トークンを浪費する7つのよくある間違い、Claude Code向けの実践的な7ステップのセットアップを紹介します。

Ailootの利用方法については、ドキュメントをご覧ください。

コンテキストエンジニアリングとは?一言で言うと

重要なポイント

コンテキストエンジニアリングとは、各ステップでAIエージェントのコンテキストウィンドウに入るすべての情報、すなわちシステムプロンプト、ツール、履歴、メモリファイル、外部ソースからのデータを選び整える技術です。プロンプトエンジニアリングが答えるのは「プロンプトをどう書くか?」という問いです。コンテキストエンジニアリングが答えるのは「プロンプトを書くとき、AIは何を知っているか?」という問いです。

Anthropicは2025年9月29日のエンジニアリングブログ記事で、この用語を定義しました。

コンテキストエンジニアリングとは、プロンプト自体以外に入力されるすべての情報を含め、LLMの推論中に最適なトークン(情報)の集合を選び、維持するための一連の戦略です。
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

同じ記事には、視点を変えるうえで最も重要な一節があります。

言語モデルとの作業は、プロンプトの適切な言葉や表現を探すことから、より広い問い、つまり「望ましいモデルの振る舞いを最も生み出しやすいコンテキスト構成は何か?」に答えることへと移りつつある。
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

要点は、コンテキストは自分が書くメッセージではないということです。コンテキストとは、メッセージの前にAIが目にする情報全体、すなわちシステムプロンプト、ツールの説明、会話履歴、メモリファイル、MCP経由で読み込まれたデータです。プロンプトは最後のステップです。コンテキストエンジニアリングとは、ウィンドウに入れるすべての情報の設計です。

なぜ2026年にプロンプトエンジニアリングは時代遅れになったのか?

重要なポイント

プロンプトエンジニアリングは、モデルが単一のプロンプト、つまり1ターンで1つのタスクを処理していた時代に生まれました。2026年のAIエージェントは、ツール、メモリ、サブエージェント、ツール経由でその場で取得するデータを使い、長時間のセッションを実行します。この構成では、単一のプロンプトの言い回しを工夫することが主要なスキルではなく、エージェントが目にする情報全体を整えることが重要です。

この変化は2025年の夏に起こりました。

2025年9月29日: Anthropicがエンジニアリングブログ記事でこの分野を確立し、4つの原則をまとめました。

プロンプトエンジニアリングが「死んだ」わけではありません。キーボードで文字を打つ方法を知っているのと同じように、基礎的なリテラシーになったのです。その上に、長いタスクでAIエージェントが破綻しないための分野、すなわちコンテキストエンジニアリングが生まれました。

コンテキストエンジニアリングとプロンプトエンジニアリングの違いは?5つの違い

重要なポイント

プロンプトエンジニアリングは単一のプロンプトを最適化します。言い回し、テンプレート、トーンを選ぶ作業です。コンテキストエンジニアリングは、そのプロンプトを送る前の情報環境全体を設計します。システムプロンプト、ツール、セッション履歴、メモリファイル、検索による情報取得が対象です。この違いは、最適化対象、時間軸、主なリスク、中核となるスキル、プロジェクト内の情報源という5つの側面に現れます。

項目プロンプトエンジニアリングコンテキストエンジニアリング
最適化対象単一プロンプトの言い回しトークン全体:システムプロンプト + ツール + 履歴 + 取得データ
時間軸1ターン複数ターンとセッション間の移行
主なリスクモデルがプロンプトを理解しないモデルがノイズに埋もれる(コンテキスト劣化)
中核となるスキルコピーライティングとモデルの理解情報設計と対象を絞った検索
プロジェクト内の情報源プロンプトテンプレートCLAUDE.md、メモリファイル、検索、サブエージェント、コンパクション
たとえ「プロンプトの書き方」「プロンプトを送るとき、AIが何を知っているか」

コンテキストエンジニアリングは「とにかく多く入れる」ことではありません。適量を精密に与えることです。少なすぎれば、AIはコンテキスト不足になり、幻覚を起こします。多すぎれば、ノイズに埋もれ、途中で要点を見失い、コストも増えます。

プロンプトエンジニアリングが扱っていたのは最後のステップです。コンテキストエンジニアリングは、その前にあるすべてを扱います。

100万トークンあっても、なぜ「全部入れる」べきではないのか?

重要なポイント

2026年にはモデルのコンテキストウィンドウが拡大し、Claude Opus 4.7とSonnet 4.6は100万トークンに対応しています。これにより、リポジトリ全体をウィンドウに入れられるという錯覚が生まれます。実際には、ウィンドウが大きくても有用なメモリが増えるとは限らず、モデルの性能は上限に達するかなり前から低下し始めます。

Claudeモデルの現在のコンテキスト上限は次のとおりです。

モデルコンテキストウィンドウ利用可能なプラン
Claude Haiku 4.5200,000トークンすべてのプラン
Claude Sonnet 4.61,000,000トークン使用クレジット付きPro+
Claude Opus 4.71,000,000トークンPro、Max、Team、Enterprise

100万トークンは、テキスト約2,500ページ分です。プロジェクトのドキュメント、やりとり、仕様書をすべて読み込ませて、AIに判断させればよいように思えます。しかしAnthropicはエンジニアリングブログで明言しています。

コンテキストは、限界効用が逓減する有限のリソースとして扱うべきです。
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

つまり、コンテキストは限界効用が逓減する有限のリソースです。トークンを追加しても、効果が比例して増えるわけではありません。ウィンドウが長くなるほど、モデルはその中の情報をうまく扱えなくなります。

2026年の主要なスキルは、すべてを開いたままにしておくことではありません。タスクごとに狭いコンテキストを用意し、素早く切り替えることです。

最大の間違い:コンテキストが多いほど、結果は悪くなるのか?

重要なポイント

コンテキストが長いほど、モデルはその中の情報をうまく扱えなくなります。この現象はコンテキスト劣化と呼ばれます。「Lost in the Middle」効果も影響します。モデルはコンテキストの冒頭と末尾を覚える一方で、途中を読み飛ばします。実践的な結論は、長いメモリファイルは逆効果だということです。

もう1つの効果、「Lost in the Middle」も並行して働きます。

実際には、重要なルールがCLAUDE.mdの途中にあると、モデルが読み飛ばす可能性があります。

AnthropicはCLAUDE.mdのドキュメントで、長さの上限を推奨しています。

CLAUDE.mdは200行未満を目安にしてください。ファイルが長いほどコンテキストを消費し、指示への準拠が低下します。
— Anthropic, https://code.claude.com/docs/en/memory

引用の200行未満は長さの目標で、ルール追従が止まる厳密な境界ではありません。80〜120行は紹介したプロジェクトでの筆者の好みで、別のAnthropic要件ではありません。関連する指示を保ち、重要ルールに従うか実際に試してください。行が増えるほど注意と文脈を使います。この上限に収まるようCLAUDE.mdを設定する方法については、「2026年版CLAUDE.mdの設定方法」をご覧ください。

Anthropicが示すコンテキストエンジニアリングの5原則

重要なポイント

Anthropicは2025年9月29日のエンジニアリングブログで、コンテキストに関する基本戦略を5つ挙げました。有限のリソース、必要なときに取得する情報、構造化されたメモ、コンパクション、サブエージェント構成です。これが、現在このテーマを扱う他の著者が引用する基本資料です。

原則1. コンテキストは有限のリソース

これは基本的な前提であり、これがなければほかの4原則は機能しません。Anthropicは次のように述べています。

システムプロンプト、ツール、例、メッセージ履歴など、コンテキストを構成するすべての要素について、よく考慮し、情報量がありながら密度の高いコンテキストを保つことが一般的な推奨事項です。
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

「密度が高い」とは、「余分なものがなく、情報が詰まっている」という意味です。ウィンドウ内のトークンはすべて、モデルの判断に実質的な影響を与えるべきです。CLAUDE.mdに「きれいなコードを書くように努める」とあれば、削除できます。情報としての価値がないからです。

原則2. 必要なときに情報を取得する

AIエージェントは、すべてをあらかじめウィンドウに読み込むのではなく、ツールを使ってその場でデータを取得します。これはClaude Codeの構成です。ベクトルデータベースやインデックスの代わりに、エージェントは現場のエンジニアが手作業でコードを検索するように、globとgrepを使います。

使う場面:タスクでどの箇所が必要になるか、事前に分からない場合。

原則3. 構造化されたメモを取る

エージェントはメモを外部ストレージに書き、必要に応じて読み込みます。Claude Codeでは、これをメモリツールで実現します。AnthropicはCookbookで次のように説明しています。

メモリとは構造化されたメモです。エージェントは永続的な外部ストレージに書き込み、すべてをアクティブなコンテキストに置き続けることなく、タスクやセッションをまたいで進捗を追跡します。
— Anthropic Cookbook, https://platform.claude.com/cookbook/tool-use-context-engineering-context-engineering-tools

使う場面:長いセッション、セッション間の移行、蓄積されるプロジェクト知識。

原則4. コンパクション

上限が近づいたときに、メッセージ履歴を要約に圧縮します。Claude Codeでは、/compactコマンドのほか、ウィンドウが約80%に達したときの自動コンパクションがあります。Anthropicは次のように述べています。

コンパクションは、ウィンドウが大きくなりすぎたときに、ウィンドウ全体を圧縮します。
— Anthropic Cookbook, https://platform.claude.com/cookbook/tool-use-context-engineering-context-engineering-tools

使う場面:分析的な会話が長くなり、チャット履歴が役に立たない情報となって、支援するどころかウィンドウを埋めている場合。

原則5. サブエージェント構成

専門化したサブエージェントがそれぞれのコンテキストウィンドウで並行して作業し、圧縮した要約をリードエージェントに返します。Anthropicは次のように述べています。

サブエージェントは圧縮に役立ちます。それぞれのコンテキストウィンドウで並行して作業し、1つの質問の異なる側面を同時に調査します。
— Anthropic Engineering, https://www.anthropic.com/engineering/multi-agent-research-system

Anthropic社内テストの数値によると、リードのClaude Opus 4とサブエージェントのClaude Sonnet 4を組み合わせると、調査タスクの品質はClaude Opus 4単独より+90.2%向上します。代償はトークンが約15倍になることです。結論として、成果に価値がある場面では正当化されます。

Claude Codeでサブエージェントを設定する方法については、「Claude Codeのサブエージェント」をご覧ください。

トークンを浪費し、Claude Codeを壊す7つの間違い

重要なポイント

プロジェクトの実例を使って、よくあるアンチパターンを7つ紹介します。どれもメリットなくトークンを浪費するか、コンテキスト劣化による幻覚を引き起こします。それぞれの下に、コンテキストエンジニアリングでの対処法を示します。

#アンチパターン起きること対処法
1README全体とコードファイル5つを1つのプロンプトに貼り付ける1ターンでウィンドウの50%を使い、その後すぐに上限に達する長期的な事実にはメモリツールを使い、必要に応じて情報を取得する。read_file/globを使ってClaude自身にファイルを読ませる
2500行のCLAUDE.md長い指示は、重要ルールが中間に埋もれる場合などに、遵守を弱めることがある80~120行にし、命令形を使い、コマンドとスタイルのセクションを設ける。最重要事項は冒頭と末尾に置く
3長いセッションで/compactを実行しないセッションが180kトークンに達し、Claudeが最初のメッセージを忘れ、手作業でコンテキストを繰り返すことになる/compactを手動で実行するか、トリガーによる自動コンパクションを使う。負荷の兆候はClaudeデスクトップのコンテキスト使用量インジケーター
4何でも1つのClaudeに任せる1つのエージェントが計画、検索、コーディング、レビュー、テストを行い、ウィンドウが指数関数的に膨らむサブエージェントを使う。それぞれが独自のコンテキストを持ち、リードエージェントが要約を集める。Anthropicの調査では、調査タスクの品質が+90.2%向上
5ツールの結果でメモリファイルが膨らむエージェントが同じファイルを5回読み直し、ツール呼び出しの結果がコンテキストの96%を占めるツール結果を整理する。直近の4~6件だけを保持し、残りを消去する。呼び出しがあった事実は保持される
6リポジトリ全体をexamples/フォルダーに貼り付けるAIは200個の例からパターンを探し、迷子になるexamples/にはタスクの種類ごとに3~7個の代表的なパターンを置く
7200行のMarkdownリストを「機能計画」にする長く構造化されていない一覧は追跡を難しくする。50行目という普遍的な失敗点はないHTML成果物か、別ファイルの番号付き計画にする

AnthropicのCookbookは、5番目の間違いに関する具体的な測定結果を示しています。ベースラインのセッションでは、最初の文書(線虫C. elegansに関するもの)は技術的にはコンテキスト内にありましたが、33万5千トークンの下に埋もれていました。存在はしていても、実際にはモデルが思い出せなかったのです。メモリツールを使うと、元のコーパスを再読み込みする代わりに、aging_model_organisms_comparison.mdというメモファイルを約3,000トークンで扱えます。

身近な例で言えば、コンテキストウィンドウは机です。200個の書類が置かれていれば、必要な書類がそこにあっても見つけられません。コンテキストエンジニアリングとは、「今、机の上に必要なものだけを置き、残りを保管し、必要に応じて読み込む」技術です。

ひと晩で実用的なセットアップを組むには?

重要なポイント

Claude Codeで最低限の実用的なコンテキストエンジニアリングを構成する要素は7つです。CLAUDE.md、examples、PRPドキュメント、メモリツール、/compact、サブエージェント、ツールを使った必要に応じた情報取得です。基本の枠組みは30~40分で設定できます。例と検証済みプロンプトを含む完全な設定には、ひと晩かかります。使いながら改善できます。

順番に行う7つのステップは次のとおりです。

  1. 80~120行のCLAUDE.md。 プロジェクトのルートに置きます。説明文ではなく命令形を使います。Anthropicは公式ドキュメントで、Specificityの原則、つまりルールは一般論ではなく具体的で曖昧さのないものにすることを推奨しています。実際には、「きれいなコードを書くように努める」より「テストでインラインモックを使わない」のほうが効果的です。詳しいテンプレートは「CLAUDE.mdの設定方法」をご覧ください。

  2. 検証済みパターンを3~7個含むexamples/フォルダー。 よく使うパターンごとに1つ、たとえばAPI呼び出し、テストの作成、マイグレーション、エラー処理の例を置きます。Claudeはexamples/にパターンを見つけると、正確に再現します。例がなければ、作業しながら推測します。

  3. 主要な機能向けのPRPドキュメント。 PRPはProduct Requirements Promptの略です。機能ごとに1つのファイルを用意し、コンテキスト、計画、検証、例をまとめます。

  4. セッションをまたいだ長期的な事実を保存するメモリツール。 AnthropicのCookbookでは、Claudeのメモリツールを構造化されたメモの保存場所として実装しています。エージェントが新しいセッションでタスクに戻ると、コーパス全体を読み直すのではなく、まずメモを読みます。

  5. /compactと上限の80%での自動コンパクション。 ウィンドウが上限に達するまで待たないでください。設定で自動コンパクションを有効にするか、セッションが堂々巡りになってきたと感じたら自分で/compactを実行します。

  6. 調査、レビュー、計画にサブエージェントを使う。 各サブエージェントは独自のコンテキストと範囲を絞ったプロンプトを持ちます。リードClaudeが受け取るのは素材そのものではなく、要約だけです。詳細は「Claude Codeのサブエージェント」と「Claude CodeのSkills」をご覧ください(Skillsは、Claudeが自動的に適用する限定的な専門知識をパッケージ化する方法です)。

  7. あらかじめ読み込むのではなく、必要なときに情報を取得する。 リポジトリ全体をウィンドウに入れないでください。Claude自身にglobとgrepで検索させます。これはClaude Code自体の構成です。

紹介されているプロジェクトでの実践経験に基づく追加ルールは次のとおりです。

  • 1つのタスクに1つのウィンドウ。 作業を終えたら閉じて、新しいウィンドウを開きます。複数の連続したタスクの履歴を蓄積しないでください。
  • 新しいウィンドウで最初に使うコマンドのテンプレート。 毎回同じテキストを使います。「順番にCLAUDE.md、タスク領域を読んでください。1行で確認してください。タスクは開始せず、次のメッセージを待ってください。」紹介されているワークフローでは、このテンプレートをスニペットエディターに保存し、1つのホットキーで呼び出します。
  • コンテキストウィンドウが60%を超えたら、新しいものに切り替える。 途中段階の方法として、Claudeに「隣のチャットが意味を失わずにタスクを引き継げるよう、プロンプトを書いて」と頼み、そのプロンプトをコピーして新しいウィンドウを開きます。
  • AIの間違いはすべて、ルールを追加する理由になる。 メモリファイルに手作業でルールを書かないでください。間違いが起きたときにClaudeへ「それは間違いです。なぜなら……」と伝えれば、「ルール→理由→方法」の規約に従ってルールをファイルに整えます。

今後:コンテキストエンジニアリングはどう発展するのか?

重要なポイント

2026年、コンテキストエンジニアリングはテキストベースのMarkdownファイルから、より構造化された形式へと移行しています。エージェントが過去のセッションを一晩かけて再検討するDreaming機能も登場しました。次に来るのはHTML成果物、永続メモリ、プロダクトチーム全体にわたるマルチエージェントのオーケストレーションです。

現在、この分野が進んでいる方向の1つを紹介します。

Dreaming—セッションを一晩かけて再検討する。 2026年5月6日のCode w/ Claude SFで、Anthropicはエージェントが過去のセッションを一晩かけて再検討し、自分のメモを更新する機能を披露しました。構造化されたメモリファイルは、あなたが書き込むときだけでなく、エージェントが蓄積された経験から結論を導くときにも成長するようになりました。

1つの傾向は明らかです。コンテキストエンジニアリングは、単なる「CLAUDE.mdの書き方」ではなく、AIエージェント向けに情報を設計する総合的な分野になりつつあります。プロンプトエンジニアリングは、この分野の初期の段階の1つでした。次に来るのがコンテキストエンジニアリングです。

最初の晩に整える価値がある最低限の内容は、CLAUDE.mdを80~120行に設定し(ガイドはこちら)、ビジネス知識の構成を含むフォルダーを作成し、/compactの使い方を覚え、上限の無駄遣いをやめることです。

次に、サブエージェント(ガイド)とSkillsを追加し、専門知識を共有コンテキストから専用のスキルへ移します。

出典

Ailootについて詳しくご覧ください。

詳細を見る

2026年のコンテキストエンジニアリング:その意味、プロンプトエンジニアリングとの違い、Claude Codeでの活用方法:よくある質問

CLAUDE.mdの200行は厳密な上限ですか?

いいえ。引用した案内は文脈を節約し指示に従いやすくするための目安です。80〜120行は筆者の実用上の好みです。行数を保証とせず、実タスクで重要なルールを確認してください。

初期コンテキストから何を外へ移しますか?

詳細な例、長いツール結果、特定タスクの参考資料を別ファイルへ移します。CLAUDE.mdには短いルールと案内を残し、必要なときに関連箇所を取得してください。

すべての記事