Claude Code のコードインテリジェンス(LSP)プラグイン導入

Claude Code エンジニアリング 6分で読めます

コードインテリジェンスプラグインを入れると、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-lspclangd
C#csharp-lspcsharp-ls
Gogopls-lspgopls
Javajdtls-lspjdtls
Kotlinkotlin-lspkotlin-lsp
Liquidliquid-lspshopify(Shopify CLI)
Lualua-lsplua-language-server
PHPphp-lspintelephense
Pythonpyright-lsppyright-langserver
Rubyruby-lspruby-lsp
Rustrust-analyzer-lsprust-analyzer
Swiftswift-lspsourcekit-lsp
TypeScript / JavaScripttypescript-lsptypescript-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 に頼み、会話を確認します。

足りないバイナリを入れると、次に Claude が該当ファイルを編集したときに再度起動を試みます。PATH に入っていないディレクトリへ入れた場合は、PATH が通ったシェルから新しいセッションを始めます。

Claude が得る診断とコードナビゲーション

言語サーバーが動くと、Claude は次の2つを使えるようになります。

公式の Tools reference によると、LSP ツールで Claude ができるのは次の操作です。

LSP ツールは読み取り専用で、利用に権限の確認は不要です。また Read・Grep・Glob と同様に Read(~/secrets/**) のようなパス指定の権限ルールの対象になります(権限ルールは設定と権限の記事を参照)。対応するプラグインを入れるまではツールは無効のままで、言語サーバーを起動できないファイルへの呼び出しはエラーを返します。

会話に表示されるのは Found N new diagnostic issues という要約だけです。個々の指摘を自分で読みたいときは Ctrl+O を押して展開します。

LSP プラグイン推奨ダイアログへの対応

言語サーバーのバイナリが PATH にあるのに、それを使うプラグインが入っていない場合、Claude Code は LSP plugin recommendation というダイアログでインストールを提案します。表示される条件は次のとおりです。

選択肢ごとの動作は次のとおりです。

選択肢動作
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つが挙げられています。

また、セッション中にプラグインを有効化すると 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)。プラグインの一覧やメッセージは更新される可能性があるため、利用前に公式ドキュメントをご確認ください。