コードインテリジェンスプラグインを入れると、Claude Code はエディタと同じように言語サーバー(LSP)から診断と定義ジャンプを受け取れるようになります。自分の編集で生まれた型エラーや import 漏れにビルド前に気づき、定義や参照をテキスト検索ではなくシンボル単位で探せます。この記事では、公式ドキュメント「Code intelligence plugins」に沿って、導入手順・得られる機能・推奨ダイアログの扱い・うまく動かないときの対処を説明します。
コードインテリジェンスプラグインとは
各プラグインは、1つの言語の言語サーバーを Language Server Protocol(LSP)で Claude Code につなぎます。プラグインが持っているのは「どのコマンドで言語サーバーを起動するか」と「どの拡張子を担当するか」という設定だけで、言語サーバー本体(バイナリ)は含まれていません。プラグインは Anthropic の公式マーケットプレイス(claude-plugins-official)から入れ、バイナリは自分のマシンに別途インストールします。
公式マーケットプレイスにある言語とプラグインは次のとおりです。liquid-lsp だけは Shopify が保守し、それ以外は Anthropic が保守しています。
| 言語 | プラグイン | 必要なバイナリ |
|---|---|---|
| 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 |
なお、コードインテリジェンスプラグインが動くのはターミナルのセッションです。クラウドセッションではプラグインの言語サーバーは起動されないため、診断やコードナビゲーションは得られません。
導入の3ステップ
順番は「バイナリ → プラグイン → 起動確認」です。
1. 言語サーバーのバイナリを入れる
上の表で自分の言語の行にあるバイナリをインストールします。インストール方法は各プラグインの README に書かれており、TypeScript の場合は次のコマンドです。
npm install -g typescript-language-server typescript
入れたら、claude を起動するシェルの PATH に載っているかを確認します(例: which typescript-language-server、PowerShell なら Get-Command typescript-language-server)。
2. プラグインを入れる
ターミナルで claude を起動し、プロンプトに次のように入力します。typescript-lsp の部分は自分の言語のプラグイン名に置き換えます。
/plugin install typescript-lsp@claude-plugins-official
確認メッセージに、すぐ有効になったか /reload-plugins が必要かが表示されます。VS Code 拡張やデスクトップアプリでは、公式の「Install a plugin」の手順で入れます。Marketplace "claude-plugins-official" not found で失敗した場合は、プラグインのトラブルシューティングにある同名の項目を参照してください。
3. 言語サーバーが起動したか確かめる
言語サーバーは、Claude がそのプラグインの担当拡張子のファイルを初めて編集したときに起動します。動作を見るには、その言語のファイルにわざと型エラーを入れて直すよう Claude に頼み、会話を確認します。
- 診断の行が出た: エラーを入れた編集の下に
Found N new diagnostic issues in M files (ctrl+o to expand)が表示されれば起動しています。 - 診断の行が出ない:
/pluginを開いて Errors タブを確認します。Executable not found in $PATH: "<binary>"の行があれば、そこに書かれたバイナリが足りていません。
足りないバイナリを入れると、次に Claude が該当ファイルを編集したときに再度起動を試みます。PATH に入っていないディレクトリへ入れた場合は、PATH が通ったシェルから新しいセッションを始めます。
Claude が得る診断とコードナビゲーション
言語サーバーが動くと、Claude は次の2つを使えるようになります。
- 編集後の診断: サーバーが担当するファイルを編集・作成するたびに、サーバーが報告するエラーと警告を受け取ります。自分が入れた型エラー・import 漏れ・構文エラーに、コンパイラを走らせずに気づけます。
- コードナビゲーション:
LSPツールが使えるようになり、テキスト検索ではなくサーバー経由でシンボルを引けます。
公式の Tools reference によると、LSP ツールで Claude ができるのは次の操作です。
- シンボルの定義へジャンプする
- シンボルの参照をすべて探す
- 指定位置の型情報を得る
- ファイル内のシンボルを一覧する
- ワークスペース全体から名前でシンボルを探す
- インターフェースの実装を探す
- 呼び出し階層をたどる
LSP ツールは読み取り専用で、利用に権限の確認は不要です。また Read・Grep・Glob と同様に Read(~/secrets/**) のようなパス指定の権限ルールの対象になります(権限ルールは設定と権限の記事を参照)。対応するプラグインを入れるまではツールは無効のままで、言語サーバーを起動できないファイルへの呼び出しはエラーを返します。
会話に表示されるのは Found N new diagnostic issues という要約だけです。個々の指摘を自分で読みたいときは Ctrl+O を押して展開します。
LSP プラグイン推奨ダイアログへの対応
言語サーバーのバイナリが PATH にあるのに、それを使うプラグインが入っていない場合、Claude Code は LSP plugin recommendation というダイアログでインストールを提案します。表示される条件は次のとおりです。
- 追加済みのマーケットプレイス(または自動登録された公式マーケットプレイス)に、編集したファイルの拡張子用のプラグインがあり、そのバイナリがインストール済みであること
- 複数のマーケットプレイスが候補を持つ場合は公式マーケットプレイスのものを提案する
- 1セッションに最大1回、最初に該当したファイルの編集時だけ出る
- ターミナルがクラウドセッションにつながっているとき(
claude --cloudなど)は出ない
選択肢ごとの動作は次のとおりです。
| 選択肢 | 動作 |
|---|---|
| Yes, install | ユーザー単位でプラグインを入れ、<plugin> installed · restart to apply と表示。新しいセッションでサーバーが読み込まれる |
| No, not now | 閉じるだけ。後のセッションで再び提案されることがある(Esc も同じ) |
| Never for this plugin | そのプラグインだけ今後提案しない。他のプラグインは提案される |
| Disable all LSP recommendations | 全言語で提案を止める |
何も選ばないと30秒で閉じ、「無視」として数えられます。この回数はセッションをまたいで保持され、5回無視すると「Disable all LSP recommendations」を選んだのと同じく提案が止まります。
提案を再開したい場合は、Claude Code 自身の設定ファイル ~/.claude.json を編集します。全体を止めた(または5回無視した)なら lspRecommendationDisabled と lspRecommendationIgnoredCount のキーを削除し、特定プラグインを「Never」にしたなら lspRecommendationNeverPlugins の一覧からその name@marketplace を外します。
うまく動かない時の対処と公式プラグインがない言語
公式のプラグインのトラブルシューティングページでは、コードインテリジェンス特有の症状として次の3つが挙げられています。
- 言語サーバーが起動しない: プラグインは、別途入れたバイナリをコマンド名で
PATHから起動します。失敗は/pluginの Errors タブにExecutable not found in $PATH: "<binary>"のような理由付きで表示され、claude --debugのログにはLSP server <name> failed to start: <reason>と出ます。バイナリを入れ、claudeを起動するターミナルのPATHにあることを確かめてから新しいセッションを始めます。 - メモリを使いすぎる:
rust-analyzerやpyrightなどはプロジェクト全体をインデックスします。気になる場合はセッション内で/plugin disable <plugin>を実行してプラグインを無効にし、Claude の組み込みの検索ツールに任せます。 - モノレポで誤った診断が出る: ワークスペース向けに設定されていない言語サーバーは、内部パッケージの import を未解決と報告することがあります。Claude Code 側で直すものはなく、この診断があっても Claude のコード編集は止まりません。
また、セッション中にプラグインを有効化すると LSP ツールが追加されるため、/reload-plugins 実行時に This reload adds the LSP tool で始まる警告が出ることがあります。これはプロンプトキャッシュが無効になる変更であることの知らせで、/reload-plugins --force で適用するか、新しいセッションを始めます(キャッシュについてはプロンプトキャッシュの仕組みを参照)。
表にない言語でも、言語サーバーはつなげます。サーバーの起動コマンドと担当拡張子を書いた .lsp.json を持つプラグインを自作し、--plugin-dir で読み込むかマーケットプレイスで公開します。プラグインの作り方はClaude Code のプラグイン作成の記事を参照してください。
本記事は Claude Code 公式ドキュメント「Code intelligence plugins」を元に、同じく公式の Tools reference(LSP tool behavior)と Troubleshoot plugins で LSP ツールの機能と起動失敗時のログ・対処を照合した非公式の日本語解説です(確認日 2026-11-19)。プラグインの一覧やメッセージは更新される可能性があるため、利用前に公式ドキュメントをご確認ください。