Context7 CLI インストールと使い方

Context7 は、常に最新のライブラリドキュメントをAIコーディングアシスタントのコンテキストに直接注入するプラットフォームです。これにより、アシスタントが古いトレーニングデータに基づいてコードを生成するのを防ぎます。CLI (ctx7) は npx ctx7 で実行でき (インストール不要)、ctx7 setup コマンド1つで Claude Code、Cursor、または OpenCode に接続できます。

Context7とは何か、なぜ重要なのか？

AIコーディングツールを使用するすべての開発者が経験する問題があります。それは、よく知っているライブラリを使ってコードを書くようアシスタントに頼むと、一見正しいように見えるコードが生成されるものの、実際には存在しないAPIを使用していたり、関数シグネチャが間違っていたり、インポートパスが2つ前のメジャーバージョンで変更されていたりすることです。ドキュメントのバージョン12では動く例が、あなたの環境ではバージョン15であるために動かない、といった具合です。

これは、LLMが特定のカットオフ日までのデータでトレーニングされているために起こります。彼らは先月何が変わったのかを知りません。Next.js 15でレイアウトの仕組みが変更されたことや、依存しているライブラリがトレーニングスナップショット以降にAPIサーフェスの半分を非推奨にしたことも知りません。

Context7はこれを解決します。これは、Upstash が構築したプラットフォームで、9,000以上のライブラリのドキュメントをインデックス化し、AIアシスタントにリアルタイムで提供します。コーディングエージェントに質問すると、Context7は現在のバージョン固有のドキュメントを取得し、モデルが応答を生成する前にコンテキストウィンドウに入れます。

その結果、AIコーディングツールはAPIの幻覚を見るのをやめ、ライブラリが今日実際に提供する機能に合致するコードを生成するようになります。

ctx7 CLIはContext7のコマンドラインインターフェースです。主に3つの機能を提供します。

ターミナルで直接ライブラリドキュメントを取得する
AIコーディングスキルを管理する（エージェントを強化する再利用可能なプロンプトファイル）
Claude Code、Cursor、または OpenCode 用のContext7 MCPサーバーを設定する

💡

開発作業と並行してAPI連携を構築している場合、Apidog はAPIテストの側面を処理します。これは、APIリクエストの送信、整理、自動化を無料で行うクライアントです。Context7はAIアシスタントの知識を最新に保ち、Apidogは実際のAPI呼び出しが検証されていることを保証します。

button

ctx7のインストール

唯一の要件は Node.js 18以降です。node --version でバージョンを確認してください。

インストールせずに実行する

ctx7を試す最も速い方法は npx を使うことです。

npx ctx7 --help
npx ctx7 library react

これにより、実行するたびに最新バージョンが取得されます。たまに使う場合はこれで十分です。

グローバルにインストールする

定期的に使用する場合は、グローバルにインストールします。

npm install -g ctx7
ctx7 --version

その後、すべての ctx7 コマンドは npx のオーバーヘッドなしでローカルで実行されます。

AIコーディングエージェント向けContext7のセットアップ

ctx7 setup コマンドは Context7 をAIコーディング環境に接続します。OAuth経由で認証し、APIキーを生成し、適切な場所に設定を書き込みます。

対話型セットアップ

ctx7 setup

これは、エージェントと希望のモード（CLI + スキル vs MCP）を選択するよう促します。プロンプトをスキップしたい場合は、次のようにします。

ctx7 setup --yes

特定のエージェントを対象にする

ctx7 setup --claude     # Claude Code (~/.claude/skills または MCP 設定)
ctx7 setup --cursor     # Cursor (~/.cursor/skills または MCP 設定)
ctx7 setup --opencode   # OpenCode

既存のAPIキーを使用する

context7.com/dashboard からContext7のAPIキーをすでに持っている場合：

ctx7 setup --api-key YOUR_API_KEY

プロジェクトレベル vs グローバルセットアップ

デフォルトでは、ctx7 setup はグローバルにインストールされます。現在のプロジェクトのみに設定するには、次のようにします。

ctx7 setup --project

2つのモード：CLI + スキル vs MCP

CLI + スキルモードは SKILL.md ファイルをインストールし、AIエージェントに ctx7 CLIコマンドを実行してドキュメントを取得するように指示します。エージェントはスキルの指示を読み、ライブラリドキュメントが必要なときに自律的に ctx7 library および ctx7 docs を実行します。MCPサーバーは不要です。

ctx7 setup --cli --claude    # スキルを ~/.claude/skills にインストール
ctx7 setup --cli --cursor    # スキルを ~/.cursor/skills にインストール
ctx7 setup --cli --universal # ~/.config/agents/skills にインストール

MCPサーバーモードは、Context7をモデルコンテキストプロトコルサーバーとして登録します。エージェントはCLIコマンドを実行することなく、resolve-library-id および query-docs ツールをネイティブに呼び出します。ドキュメントの取得は透過的に行われます。

MCPモードの場合、設定は次のようになります（エディタのMCP設定に追加してください）。

{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "CONTEXT7_API_KEY": "YOUR_API_KEY"
  }
}

または、CLI経由でClaude Codeに追加します。

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

認証

ctx7 login    # OAuth ブラウザログイン
ctx7 whoami   # ログインしているユーザーを確認
ctx7 logout   # 保存された認証情報を削除

APIキーを環境変数として設定することもできます。

export CONTEXT7_API_KEY=your_key_here

ログインはスキル生成および特定のセットアップフローでのみ必要です。基本的なドキュメント検索はログインなしで機能します。

テレメトリー

Context7はデフォルトで匿名利用データを収集します。無効にするには：

export CTX7_TELEMETRY_DISABLED=1

ターミナルからライブラリドキュメントを取得する

AIエージェントを使用しない場合でも、ctx7 はスタンドアロンのドキュメント検索ツールとして役立ちます。主に2つのコマンドが機能します。

ライブラリ名を解決する

ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json   # JSON出力

これはContext7インデックスを検索し、ライブラリの正規IDと、スニペット数、ソース評価、ベンチマークスコア、バージョン識別子などのメタデータを返します。

ctx7 library nextjs の出力例：

Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0

ドキュメントを取得する

ライブラリIDが分かったら、そのIDとトピッククエリを ctx7 docs に渡します。

ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
ctx7 docs /facebook/react "hooks" --json

出力は、現在のライブラリバージョンから取得された、クエリに関連するドキュメントスニペットです。この出力はファイルにパイプしたり、別のツールに渡したりできます。

ライブラリIDをすでに知っている場合は、ctx7 library をスキップして直接 ctx7 docs に進むことができます。

AIコーディングスキルの管理

スキルは SKILL.md ファイルであり、AIエージェントに専門的な知識や振る舞いを与えます。特定の種類のタスクに取り組む前にエージェントが読む、小さな取扱説明書のようなものだと考えてください。

Context7は、コミュニティが提供するスキルのレジストリをホストしています。これを検索し、エージェント環境にスキルをインストールし、カスタムスキルを生成し、不要なものを削除できます。

スキルを検索する

ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"

スキルをインストールする

ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor   # Cursor専用にインストール
ctx7 skills install /anthropics/skills pdf --claude   # Claude Code専用にインストール

グローバルにインストールする場合 (--global)、スキルはすべてのプロジェクトで利用可能になります。

ctx7 skills install /anthropics/skills pdf --global

プロジェクトに基づいて提案を得る

ctx7 skills suggest はプロジェクトディレクトリをスキャンし、使用しているライブラリとフレームワークを検出し、関連するスキルを推奨します。

ctx7 skills suggest

これは、新しいプロジェクトを開始し、関連する知識を事前にエージェントに注入したい場合に非常に有効です。

インストールされているスキルを一覧表示する

ctx7 skills list              # すべてのインストール済みスキル
ctx7 skills list --claude     # Claude Code用にインストールされたスキルのみ
ctx7 skills list --cursor     # Cursorスキルのみ

スキルを削除する

ctx7 skills remove pdf

AIでカスタムスキルを生成する

これは最も強力な機能です。有料アカウントでは、Context7インデックス内の任意のライブラリからカスタムスキルを生成できます。

ctx7 login
ctx7 skills generate

CLIは対話型のプロンプトに従って操作します。ライブラリを選択し、エージェントに教えたいスキルについて説明すると、Context7はそのライブラリの現在のドキュメントに合わせて SKILL.md ファイルを生成します。

生成されたスキルはポータブルです。SKILL.md 形式は Agent Skills 標準に準拠しているため、Claude Code用に生成したスキルは、Cursor、VS Code Copilot、OpenCode、およびその他のAgent Skills互換ツールで変更なく動作します。

無料アカウントでは週に6回、Proアカウントでは週に10回スキルを生成できます。

より高速なタイピングのための短縮エイリアス：

フルコマンド	エイリアス
`ctx7 skills install`	`ctx7 si`
`ctx7 skills search`	`ctx7 ss`
`ctx7 skills generate`	`ctx7 skills gen` または `ctx7 skills g`

AIプロンプトでのContext7の使用

Context7が設定されると、日々のコーディングワークフローでそれを使用する方法がいくつかあります。

「use context7」パターン

MCPモードでは、現在のドキュメントが必要なすべてのプロンプトに「use context7」を追加します。

Create a Next.js middleware that checks for a valid JWT in cookies and redirects
unauthenticated users to /login. use context7

Set up a Prisma schema with user and post models and a one-to-many relation. use context7

How do I configure the App Router layout in Next.js 15? use context7

エージェントはContext7の resolve-library-id と query-docs ツールを自動的に呼び出し、現在のドキュメントを取得し、それらを使って応答を根拠とします。

特定のライブラリを参照する

プロンプトが複数のライブラリを伴い、Context7に1つに焦点を当てさせたい場合：

Implement Supabase authentication in a Next.js app.
use library /supabase/supabase for Supabase and /vercel/next.js for Next.js routing.

これにより、ライブラリマッチングのステップがスキップされ、直接ドキュメントにアクセスします。

「use context7」と入力せずに自動呼び出し

ライブラリコードに触れるたびに自動的にドキュメントを取得するようにAIエージェントにルールを追加します。Claude Codeでは、CLAUDE.md に次を追加します。

Always use Context7 MCP tools when generating code that uses third-party libraries.
Resolve the library ID and fetch current docs before writing any implementation.
Do this without waiting for me to ask.

Cursorでは、「設定 > AIのルール」に次を追加します。

When writing code that uses external libraries or frameworks, always invoke
Context7 to fetch current documentation before generating the implementation.

Apidogと組み合わせてAPIの完全な信頼性を確保する

Context7はAIアシスタントのライブラリ知識を最新に保ちます。しかし、正確なドキュメントは全体像の半分に過ぎません。API統合を構築する際には、実際のHTTP呼び出しが期待どおりに機能するかどうかも検証する必要があります。

Apidog がそれをカバーします。これは無料のAPIクライアントで、リクエストの送信、レスポンスの検査、環境のセットアップ、テストスイートの自動化が可能です。アドホックなエンドポイント探索から反復可能な統合テストまで、あらゆる処理に対応します。

実際のワークフローでこれらがどのように補完し合うかを以下に示します。

サードパーティAPIを呼び出すNext.jsアプリケーションを構築している場合。 Context7はAIエージェントに最新のNext.jsドキュメントを提供するため、コードの提案は正確です。Apidogを使用すると、サードパーティAPIを直接テストし、レスポンス構造を検証し、コードが送信するペイロードがAPIが期待するものと一致することを確認できます。

独自のHTTP APIを持つ新しいライブラリを統合している場合。 Context7はエージェントにライブラリの現在のSDKドキュメントを提供します。Apidogを使用すると、アプリケーションコードを記述する前に、生のAPIエンドポイントをテストしてHTTPレベルでの動作を理解できます。

統合のデバッグを行っている場合。 コードがApidogで構成する正確なリクエストを送信し、生のレスポンスを検査し、問題がリクエストロジックにあるのかAPIの動作にあるのかを特定できます。

ApidogでAPIキーを変数として保存した環境をセットアップし、ワンクリックで開発環境と本番環境を切り替え、すべてのレスポンスに対してテストアサーションを実行します。Context7 + Apidogは、最新のドキュメントと検証済みのAPI動作の両方を提供します。

料金とレート制限

ctx7 CLIは無料で利用できます。レート制限と機能アクセスは、Context7のプランによって異なります。

プラン	価格	API呼び出し/月	レート制限	プライベートリポジトリ
無料	$0	1,000	60リクエスト/時	なし
Pro	$7/シート/月	5,000/シート	60/時/シート	あり (解析1Mトークンあたり$15)
Enterprise	カスタム	5,000/シート	カスタム	あり (解析1Mトークンあたり$25)

無料枠の注意点：

月間制限に達すると、月末がリセットされるまで1日あたり20回の追加API呼び出しが付与されます。
プライベートリポジトリへのアクセスにはPro以上が必要です。
スキル生成：無料プランでは週6回、Proプランでは週10回。
Proプランは最大20人のメンバーをサポートします。

重要な制限事項： Context7はすべてのクエリをUpstashのサーバー経由でルーティングします。オフラインモードはありません。インターネット接続のない環境では、このツールは機能しません。また、ドキュメントの応答は大きくなる可能性があり、LLMのコンテキストウィンドウを消費します。多くのライブラリクエリを伴う複雑なプロジェクトでは、これが蓄積されます。

context7.com/dashboard で無料のAPIキーを取得してください。APIキーを使用すると、認証なしのリクエストよりも高いレート制限が適用されます。

button

FAQ

Context7は私のコードをサーバーに送信しますか？

いいえ。Context7のサーバーにはライブラリ名とクエリテキストのみが送信され、あなたのコード、会話履歴、または機密データは送信されません。あなたのコードベースはLLMプロバイダーのもとに留まります。

Context7はどのライブラリをサポートしていますか？

インデックスには9,000以上の公開ライブラリとフレームワークが含まれています。context7.com でインデックスを検索して、特定のライブラリが利用可能かどうかを確認できます。新しいライブラリはContext7インターフェースの /add-library から提出できます。

ドキュメントはどのくらい最新ですか？

ライブラリは定期的に再インデックスされます。非常に最近のリリース（過去数日以内）はまだ利用できない場合があります。安定したライブラリについては、ドキュメントは通常、最新リリースに対応しています。

APIキーなしでも動作しますか？

基本的な使用はAPIキーなしでも動作しますが、レート制限が低くなります。定期的に使用する場合は、context7.comで登録し、CONTEXT7_API_KEY を設定してスループットを向上させてください。

どのエディタとエージェントをサポートしていますか？

Context7は、Claude Code、Cursor、OpenCode、VS Code Copilot、Windsurf、Claude Desktop、およびMCPまたはAgent Skills標準をサポートするその他のクライアントで動作します。

CLI + スキルモードとMCPモードの違いは何ですか？

CLI + スキルモードでは、スキルファイルがエージェントにドキュメントが必要なときに明示的に ctx7 コマンドを実行するよう指示します。MCPモードでは、エージェントはMCPプロトコルを介してContext7のツールをネイティブに呼び出します。MCPモードはユーザーにとってより透過的であり、設定が完了すれば明示的に「use context7」をプロンプトする必要はありません。

AIコーディングエージェントなしでctx7を使用できますか？

はい。ctx7 library と ctx7 docs はスタンドアロンのターミナルコマンドとして機能します。AIエージェントを介さずに、直接ライブラリドキュメントを検索できます。