powered by TechFeed
表示モード
主要ニュース

Claude Codeが古いAPIでコードを生成する問題を解決する「Context7」 — バージョン固有のドキュメントをエージェントが自律取得

11月17日、KDNuggetsが「How to Give Claude Code Up-to-Date Documentation With Context7」と題した記事を公開した。AIコーディングエージェントが「古いAPIでコードを生成してしまう」という根本的な問題に対し、MCPサーバー「Context7」をClaude Codeに接続することで、エージェント自身がバージョン固有のドキュメントを実装前に自律取得するアプローチを紹介している。セットアップはワンコマンドで完了し、「何のドキュメントを根拠にコードを生成したか」をエージェントが明示する点が従来のAIコーディング支援と一線を画す。

11月17日、KDNuggetsが「How to Give Claude Code Up-to-Date Documentation With Context7」と題した記事を公開した。AIコーディングエージェントが「古いAPIでコードを生成してしまう」という根本的な問題に対し、MCPサーバー「Context7」をClaude Codeに接続することで、エージェント自身がバージョン固有のドキュメントを実装前に自律取得するアプローチを紹介している。セットアップはワンコマンドで完了し、「何のドキュメントを根拠にコードを生成したか」をエージェントが明示する点が従来のAIコーディング支援と一線を画す。


「古いAPIでエラー」という問題

AIコーディングエージェントを使っていると、こんな場面に遭遇することがある。LangChain 1.xがインストールされているプロジェクトで、Claude Codeに実装を依頼すると、古いチュートリアルを参照した古いAPIでコードを生成してしまう。

from langchain.chains import LLMChain

実行するとインポートエラー。Claude Codeはバージョンの不一致を調査し、新しいAPIを探し、コードを書き直す。場合によっては何度も試行を繰り返すことになる。これは時間だけでなく、トークンのコストも無駄にする。

根本的な原因は単純だ。フレームワークやライブラリは常に変化しているが、モデルの組み込み知識はその変化に追いつけていない。Cursor の Docs 機能や GitHub Copilot Workspace のコンテキスト取得など、ドキュメントをエージェントに渡す手段はいくつか存在するが、いずれも「ユーザーが手動でドキュメントURLを登録・指定する」運用が基本だ。Context7はこのステップをエージェント側に委譲し、プロンプトを受け取った時点でライブラリを特定して自律的にドキュメントを取得する設計を取る。


Context7とは何か

Context7はUpstashが開発したオープンソースのMCP(Model Context Protocol)サーバーだ。AIコーディングエージェントがプロジェクト作業中にバージョン固有のライブラリドキュメントとコード例を取得できるようにする。

MCP(Model Context Protocol) とは、AIエージェントが外部ツールやデータソースと標準化された方法でやり取りするためのプロトコル。Anthropicが主導して策定した。詳細は公式ドキュメントを参照。

Context7が提供するMCPツールは2つ:

  • resolve-library-id :対象ライブラリを特定する
  • query-docs :特定の質問に関連するドキュメントを取得する

ドキュメントの手動検索やコピペが不要になり、エージェントが実装前に必要な情報を自律的に取得する形になる。Cursor のように「ドキュメントURLをあらかじめ登録しておく」必要がなく、エージェントがライブラリ名とバージョンから自動的にドキュメントを引き当てる点が差別化要因だ。


セットアップ:1コマンドで完了

前提条件はClaude CodeとNode.js 22.13以上。バージョン確認は以下で行う。

claude --version
node --version
npm --version

Context7のインストールと設定はワンコマンドで完了する。

npx ctx7 setup --claude

このコマンドが認証、APIキーの生成、統合設定まで一括で行う。統合モードはMCPサーバーとCLI+Skillsの2択だが、記事ではMCPサーバーが推奨されている。セットアップ完了後は以下のような出力が確認できる。

✔ Authenticated with API key
✔ Context7 setup complete
  Claude Code
    + MCP server configured with API Key
    + Rule installed
    + Skill installed

接続確認はClaude Code内で /mcp を実行する。

Context7 MCP Server
Status:       ✔ connected
Auth:         ✔ authenticated
URL:          https://mcp.context7.com/mcp
Capabilities: tools

実際の動作:バージョン固有ドキュメントの取得

セットアップ後、記事では以下のプロンプトでテストが行われている。

Use Context7 to retrieve the Next.js 16 documentation for the proxy convention.
Show me how to protect a dashboard route by checking an authentication cookie
and redirecting unauthenticated users to `/login`.

Claude CodeはContext7を4回呼び出し、使用したドキュメントのバージョンを明示した。

Called context7 4 times
Sources: the Next.js docs on Context7 (/vercel/next.js/v16.2.9), specifically the
proxy file convention, the Proxy getting-started guide, the authentication guide,
the redirecting guide and the v16 upgrade guide.

記事によれば、Context7が取得したドキュメントをもとに、指定バージョン固有の変更点を把握した上でコードが生成されたとされている。なお、記事中で言及されているmiddleware.tsからproxy.tsへの改名やエッジランタイム非対応といった具体的な仕様変更は、Context7が取得したドキュメントの内容として紹介されているものであり、読者自身が対象バージョンの公式ドキュメントで確認することを推奨する。

生成したコードが何のドキュメントを根拠にしているかを明示してくれる点が、Context7を使う実質的なメリットだ。従来のAIコーディング支援では「なぜそのコードを生成したか」の根拠がブラックボックスになりがちだったが、Context7を経由することでドキュメントの出典バージョンが明確になり、レビューや検証のコストが下がる。


CLAUDE.mdで自動化する

Context7のセットアップ時にスキルがインストールされるため、基本的には明示的に「use context7」と書かなくても動作する。ただし、より確実に制御したい場合は**CLAUDE.md** にルールを追記する方法がある。

nano CLAUDE.md
## Library Documentation
Always use Context7 when working with external libraries,
frameworks, or APIs.
Before generating code:
1. Identify the library and its installed version.
2. Retrieve relevant documentation using Context7.
3. Prefer examples matching the project's version.
4. Avoid deprecated APIs when supported alternatives exist.
5. Check the generated code against the documentation.

このルールをすべてのプロジェクトに適用したい場合は ~/.claude/CLAUDE.md に配置すればよい。プロジェクト単位での設定とグローバル設定を使い分けることで、チームのコーディング規約としてドキュメント参照を標準化できる。


バージョン指定ドキュメントの取得

特定バージョンのドキュメントを明示的に要求することも可能だ。たとえばPydantic v1からv2への移行では:

Using Context7, retrieve the documentation for Pydantic v2 and show
how to migrate a BaseModel from Pydantic v1.

Context7は/pydantic/pydantic/v2.14.1のドキュメントを取得し、class Configからmodel_config = ConfigDict(...)への変更、@validatorから@field_validatorへの改名、parse_obj()からmodel_validate()への変更など、主要な破壊的変更を網羅したマイグレーションコードを生成したと記事では紹介されている。

まだ最新バージョンに移行していないプロジェクトで作業する際に、意図せず新しいAPIを混入させてしまうリスクを下げられる。これはメジャーバージョン間で破壊的変更が多いライブラリ——PydanticやLangChain、Next.jsなど——を扱うチームにとって特に有効なアプローチだ。


なぜContext7が有効か

AIコーディングエージェントの「古いAPI問題」に対するアプローチは大きく2つある。ひとつはモデル自体の学習データを最新に保つこと、もうひとつはRAG的に外部知識を都度注入することだ。前者はモデルのリリースサイクルに依存するため限界があり、後者をエージェントのワークフローに組み込んだのがContext7の設計思想といえる。

※編集部の考察:Context7の実質的な価値は「ドキュメント取得の自動化」よりも「根拠の明示化」にあると考える。エージェントがどのバージョンのドキュメントを参照してコードを生成したかが可視化されることで、コードレビュー時の確認コストが下がり、エージェント生成コードへの信頼性が上がる。これはチーム開発での採用障壁を下げる観点から重要な特性だ。


詳細はHow to Give Claude Code Up-to-Date Documentation With Context7を参照していただきたい。