RAGなしでも高精度に動くAgent Harnessの秘密 — コンテキストサイズと「100ファイル」の目安

Fri, 17 Apr 2026 00:00:00 +0000

Claude CodeやCodexのようなAgent Harnessは、RAG（Retrieval-Augmented Generation）をほとんど使わないにもかかわらず、高精度なコード生成や理解を実現している。一方、RAGに依存しすぎたAgentはハルシネーションを起こしやすいという逆説がある。なぜこのような違いが生まれるのか？Software Engineer兼Database ResearcherのTaro L. Saito（@taroleo）氏のポストが、その本質を簡潔に説明している。

コンテキストウィンドウの拡大がRAGの必要性を変えた

現行のAIモデルのコンテキストサイズは20k〜1Mトークンに達している。これは、目安としておよそ100ファイル以下のコードベースであれば、RAGを介さずそのままコンテキストに収めて処理できることを意味する。

モデル	コンテキストサイズ
GPT-4o	128k tokens
Claude Sonnet 4.x	200k tokens
Gemini 1.5 Pro	1M tokens

Claude CodeやCodexなどのAgent Harnessは、この大きなコンテキストウィンドウを活かして、必要なファイルを直接読み込みながらタスクを実行する。ベクトル検索による「関連しそうな断片」の取得ではなく、「実際に必要なコード全体」を参照できる。

RAGの弱点：断片的な情報がハルシネーションを生む

RAGは「大量の文書から関連部分を検索して取得する」ことで、LLMに外部知識を与える仕組みだ。ドキュメント検索や広範な知識ベースへのアクセスには有効だが、コードベースのような相互依存が強い構造的情報に対しては課題がある。

RAG特有の問題点：

断片的なコンテキスト: ベクトル類似度で取得したチャンクは、実際の依存関係を無視している場合がある
欠落した情報: 関連するが類似度スコアが低いコードが検索から漏れる
矛盾した断片: 異なるバージョンや関連する別モジュールの断片が混在する

こうした不完全な情報でコードを生成させると、存在しない関数を呼び出したり、実際のインターフェースと合わない実装を生成したりするハルシネーションが発生しやすい。

Agent Harnessが「100ファイル以下」で高精度な理由

Claude CodeのようなAgent Harnessが高精度に動く理由は、コンテキストウィンドウの有効活用にある。

プロジェクト構造の把握（ls、find など）
関連ファイルの直接読み込み（cat、read）
完全なコンテキストを持った上でコード生成・編集

RAGのように「類似チャンク」を取得するのではなく、ツールを使って必要なファイルを選択的に読み込むというアプローチだ。ファイル数が100程度であれば、現行のコンテキストサイズに収まるため、コードベース全体を「見た上で」タスクを実行できる。

これにより：

実際に存在する関数・型・インターフェースのみを参照する
インポート関係や依存構造を正確に把握する
プロジェクト固有の命名規則や設計パターンに従う

ベクトル検索が有効なケースと直接読み込みが有効なケース

NTT DATAのエンジニアリングブログ「ベクトル検索は不要なのか？」では、生成AI時代にRAGやベクトル検索をどう捉えるべきかを整理している。Taro氏のポストはこの記事を引用しており、「100ファイル以下という目安」はコンテキストサイズとトークン換算から導き出せる経験則だ。

ベクトル検索が有効なケース：

100ファイルを超える大規模コードベース（モノレポ、大企業の内部リポジトリ）
広範なドキュメント検索（社内ナレッジベース、技術文書）
リアルタイム情報の取得（外部ドキュメント、最新の仕様）

コンテキストに収まる場合に直接読み込みが有効なケース：

中小規模のプロジェクト（スタートアップのコードベース、個人プロジェクト）
特定モジュールへの集中作業
正確な依存関係の把握が必要な場合

RAG自体を強化する方向: GraphRAG という選択肢

「RAGを捨てて直接読み込み」ではなく、「RAGの断片性を補う」方向の研究もある。代表的なのがMicrosoft Researchが2024年に発表した GraphRAG だ。