SpyBara
Go Premium

plugins/code-intelligence.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 47 additions and 69 deletions.

2026
Fri 2 22:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

コード インテリジェンス プラグイン

言語サーバー プラグインをインストールして、Claude が編集後の型エラーを検出し、シンボルでコードをナビゲートできるようにし、LSP プラグイン推奨ダイアログに応答します。

コード インテリジェンス プラグインは、エディターが持つライブ診断と定義へのジャンプを Claude に提供するため、Claude は自身の編集によって導入される型エラーと不足しているインポートをビルドを実行する前にキャッチでき、テキスト検索の代わりにシンボルで定義と参照を見つけることができます。

各プラグインは、Language Server Protocol（LSP）を通じて 1 つの言語の言語サーバーに Claude Code を接続します。プラグインは Anthropic の公式マーケットプレイスからインストールし、言語サーバー バイナリをマシンにインストールします。

[!NOTE]

コード インテリジェンス プラグインはターミナル セッションで動作します。クラウド セッションでは、Claude Code はプラグイン言語サーバーを起動しないため、Claude はそこで診断またはコード ナビゲーションを取得しません。独自の言語サーバー プラグインを作成するか、プラグインがない言語サーバーを接続するには、プラグイン コンポーネントの LSP サーバーを参照してください。

開始するには、コード インテリジェンス プラグインをインストールするの下の表で言語を見つけてください。その表のプラグインは Anthropic の公式プラグイン マーケットプレイスから提供されています。

既に LSP プラグイン推奨ダイアログを見た場合は、推奨ダイアログを受け入れるか却下するを参照して、各選択肢の機能を確認してください。

コード インテリジェンス プラグインをインストールする

コード インテリジェンス プラグインは、言語サーバーを起動するコマンドと、それが処理するファイル拡張子を Claude Code に伝えます。言語サーバーは含まれていません。まず言語サーバー バイナリをインストールし、次にプラグインをインストールし、サーバーが起動することを確認します。

1. 言語サーバー バイナリをインストールする

下の表で言語を見つけ、その行のバイナリをインストールします。言語がリストされていない場合は、公式プラグインのない言語を追加するを参照してください。

言語 プラグイン バイナリ
C/C++ clangd-lsp clangd
C# csharp-lsp csharp-ls
Go gopls-lsp gopls
Java jdtls-lsp jdtls
Kotlin kotlin-lsp kotlin-lsp
Liquid liquid-lsp shopify（Shopify CLI から）
Lua lua-lsp lua-language-server
PHP php-lsp intelephense
Python pyright-lsp pyright-langserver
Ruby ruby-lsp ruby-lsp
Rust rust-analyzer-lsp rust-analyzer
Swift swift-lsp sourcekit-lsp
TypeScript と JavaScript typescript-lsp typescript-language-server

Anthropic は liquid-lsp を除く表内のすべてのプラグインを保守しており、liquid-lsp は Shopify が保守し、公式マーケットプレイスにリストされています。

バイナリをインストールするコマンドを見つけるには、表のプラグインのリンクをたどって README を参照してください。TypeScript の場合、そのコマンドは npm install -g typescript-language-server typescript です。

バイナリをインストールした後、claude を起動するシェルの PATH 上にあることを確認します。例えば which typescript-language-server または PowerShell では Get-Command typescript-language-server を使用します。

2. プラグインをインストールする

VS Code 拡張機能またはデスクトップアプリでは、このステップの代わりにプラグインをインストールするの手順に従ってください。ターミナルでは、claude を実行して Claude Code を起動し、そのプロンプトで次のように入力します。typescript-lsp は、ステップ 1 の表で言語用にリストされているプラグインに置き換えてください。

/plugin install typescript-lsp@claude-plugins-official

確認メッセージは、プラグインが現在アクティブであるか、/reload-plugins が必要かを示します。インストールが Marketplace "claude-plugins-official" not found で失敗した場合は、そのエラーのトラブルシューティング エントリを参照してください。プラグインがインストールされる場所を制御するか、Claude Code 内ではなくシェルからインストールを実行するには、プラグインをインストールするを参照してください。

3. サーバーが起動することを確認する

言語サーバーは、Claude がそのプラグインの拡張子の 1 つを持つファイルを初めてエディットするときに起動します。動作を確認するには、Claude にそのプログラミング言語のファイルに型エラーを導入してから修正するよう依頼します。次に、会話で診断行を確認します。

  • 診断行が表示される: エラーを導入したエディットの下に Found N new diagnostic issues in M files (ctrl+o to expand) が表示されることは、サーバーが起動したことを意味します。
  • 診断行が表示されない: /plugin を実行して Errors タブを開きます。Executable not found in $PATH: "<binary>" と読む行は、インストールするバイナリを示します。タブにそのような行がない場合は、コード インテリジェンスのトラブルシューティングを参照してください。

不足しているバイナリをインストールした後、Claude Code は Claude が一致するファイルをエディットするたびに次回試行します。バイナリを claude を起動したシェルの PATH 上にないディレクトリにインストールした場合は、それが存在するシェルから新しいセッションを開始します。

Claude が得るもの

言語サーバーが実行されている場合、Claude は診断とコード ナビゲーションを取得します。

  • エディット後の診断: Claude がサーバーが処理するファイルをエディットまたは作成するたびに、Claude はサーバーが報告するエラーと警告を取得します。コンパイラを実行せずに、導入した型エラー、不足しているインポート、または構文エラーを見ます。
  • コード ナビゲーション: Claude はテキストを検索する代わりに、サーバーを通じてシンボルを検索する LSP ツールを取得します。ツールは読み取り専用です。Claude がツールで検索できるもの、および権限がツールにどのように適用されるかについては、LSP ツール動作を参照してください。

診断を自分で読む

Claude がサーバーが処理するファイルをエディットした後、会話は Found N new diagnostic issues サマリーのみを表示します。問題自体を読むには、Ctrl+O を押します。

推奨ダイアログを受け入れるか却下する

言語サーバー バイナリが既に PATH 上にあり、それを使用するプラグインがインストールされていない場合、Claude Code は LSP プラグイン推奨というタイトルのダイアログでプラグインをインストールするよう提供します。

推奨ダイアログが表示される場合

LSP プラグイン推奨ダイアログは Claude がファイルをエディットした後に表示される場合があります。これらの条件は、表示されるかどうか、どのプラグインを提供するかを決定します。

  • プラグインがファイルと一致する: 追加したマーケットプレイスの 1 つ、または Claude Code が登録した公式マーケットプレイスが、そのファイルの拡張子のコード インテリジェンス プラグインをリストし、プラグインのバイナリがインストールされています。
  • 公式が最初: 複数のマーケットプレイスが拡張子のプラグインを提供する場合、ダイアログは公式マーケットプレイスのプラグインを提供します。
  • セッションごとに 1 回: ダイアログはセッションで最大 1 回、Claude がエディットする最初の一致するファイルに対して表示されます。
  • クラウド セッションではない: ターミナルが claude --cloudで開始したセッションなどのクラウド セッションに接続されている場合、ダイアログは表示されません。

推奨ダイアログに応答する

LSP プラグイン推奨ダイアログはプラグインに名前を付け、これらの選択肢を提供します。

  • はい、インストール: Claude Code はプラグインをユーザー アカウント用にインストールし、<plugin> installed · restart to apply を出力します。新しいセッションを開始してサーバーを読み込みます。
  • いいえ、後で: ダイアログが閉じ、後のセッションでプラグインを再度提供できます。Esc を押すと同じです。
  • このプラグインは表示しない: ダイアログはそのプラグインに対して表示されなくなり、他のプラグインに対しては表示されます。
  • すべての LSP 推奨を無効にする: ダイアログはすべての言語に対して表示されなくなります。

オプションを選択しない場合、Claude Code は 30 秒後にそれを閉じ、無視されたとカウントします。カウントはセッション全体で保持されます。5 つの無視されたダイアログの後、Claude Code はプラグインの推奨を停止します。これは すべての LSP 推奨を無効にするを選択した場合と同じです。

推奨をオンに戻す

LSP プラグイン推奨ダイアログは、すべての LSP 推奨を無効にするを選択するか、5 回無視した後に表示されなくなります。

  • 無効または 5 回無視: どちらの場合でもオンに戻すには、Claude Code 独自の設定ファイルである ~/.claude.json から lspRecommendationDisabled と lspRecommendationIgnoredCount キーを削除します。
  • このプラグインは表示しない: このプラグインは表示しないを選択し、そのプラグインを再度提供したい場合は、同じファイルの lspRecommendationNeverPlugins リストからその name@marketplace ID を削除します。

コード インテリジェンスのトラブルシューティング

プラグインのトラブルシューティング ページでは、言語サーバーが起動しない、メモリ使用量が多い、または診断が正しくないの下にあるコード インテリジェンス プラグインに固有の症状について説明しています。

  • 言語サーバーが起動しない：/plugin の Errors タブに Executable not found in $PATH が表示されるか、Claude が言語の診断をレポートしません。
  • メモリ使用量が多い：サーバーがプロジェクトをインデックスしている間、メモリ使用量が増加します。
  • モノレポでの誤検知診断：診断が、実際には解決されているインポートを未解決としてレポートします。

公式プラグインのない言語を追加する

言語が公式プラグインの表にない場合でも、言語サーバーを接続できます。

  1. サーバー コマンドとそれが処理するファイル拡張子に名前を付ける .lsp.json ファイルを使用してプラグインを作成します。
  2. 次に、--plugin-dirを使用してプラグインを読み込むか、マーケットプレイスに公開します。

ファイルのフィールドと実装例については、プラグイン コンポーネント内の LSP サーバーを参照してください。

次のステップ