Claude CodeのLSPプラグイン|型エラーを自分で見つける設定

この記事の要点
- コードインテリジェンスのプラグインを入れると、Claude が編集のたびに型エラーや足りない読み込みを自分で見つけられる
- 入れるのは、言語ごとの言語サーバー本体とプラグインの2つ。入れたあとは、わざと間違いを作らせて動作を確かめる
- 推奨ダイアログは4つの選択肢があり、無視を5回続けると案内が止まる。戻すときは設定ファイルのキーを消す
活用例:AI が書き換えたプログラムの間違いを、動かす前に見つけて直させる
- 部署
- 開発・情報システム
- 使うもの
- Claude Code のコードインテリジェンスのプラグイン(LSP)
- AIに任せる
- 編集のたびの間違い探しと、定義や参照の検索
- 人が決める
- どの言語のプラグインを標準にするか・仕上げの確認
AI にプログラムを書き換えてもらうと、「型が合っていない」「読み込みが足りない」といった小さな間違いが混ざることがあります。ふだんは、動かしてみて初めて気づきます。
Claude Code には、エディタが持っている「間違いの警告」と「定義への移動」を Claude 自身に使わせるプラグインがあります。この記事では、公式ドキュメント「Code intelligence plugins」(2026年11月16日確認)にもとづいて、入れ方と確かめ方をまとめます。
結論:言語サーバーとプラグインの2つを入れる
コードインテリジェンスのプラグインは、言語サーバーそのものを含んでいません。 「どのコマンドで言語サーバーを起こすか」「どの拡張子を担当するか」を Claude Code に教えるだけです。そのため、次の順で2つ入れます。
- 使う言語の言語サーバー(実行ファイル)を自分のパソコンに入れる
- 同じ言語のプラグインを、公式のマーケットプレイスから入れる
- 動くことを確かめる
つながる仕組みは LSP(Language Server Protocol)という共通の約束です。言語ごとに1つのプラグインがあります。
言語ごとのプラグインと実行ファイル
公式の表から、よく使う言語を抜き出します。
| 言語 | プラグイン | 言語サーバー |
|---|---|---|
| TypeScript・JavaScript | typescript-lsp | typescript-language-server |
| Python | pyright-lsp | pyright-langserver |
| Go | gopls-lsp | gopls |
| Rust | rust-analyzer-lsp | rust-analyzer |
| Java | jdtls-lsp | jdtls |
| C・C++ | clangd-lsp | clangd |
このほか C#・Kotlin・Lua・PHP・Ruby・Swift などもあります。Liquid だけは Shopify が管理していて、ほかは Anthropic が管理しています。表にない言語は、自分でプラグインを作る方法が別にあります。
入れ方:3つの手順
手順1:言語サーバーを入れる。 たとえば TypeScript なら、公式は次のコマンドを示しています。入れたあと、which typescript-language-server のようなコマンドで、起動するシェルの PATH から見えることを確かめます。
npm install -g typescript-language-server typescript
手順2:プラグインを入れる。 ターミナルで claude を起動し、プロンプトに次を入力します。VS Code の拡張機能やデスクトップアプリでは、プラグインの通常の入れ方に従います。
/plugin install typescript-lsp@claude-plugins-official
確認のメッセージに「すぐ有効」か「/reload-plugins が必要」かが出ます。プラグインの入れ物(マーケットプレイス)の仕組みは Claude Codeのプラグイン で説明しています。
手順3:動くことを確かめる。 言語サーバーは、その言語のファイルを Claude が初めて編集したときに起動します。確かめるには、Claude にわざと型エラーを入れさせて、そのあと直させます。編集の下に「Found N new diagnostic issues」という行が出れば成功です。
出ないときは、/plugin を開いて Errors タブを見ます。「Executable not found in $PATH」という行があれば、その実行ファイルが入っていません。入れ直したあと、PATH が通ったシェルから claude を起動し直します。
Claude に増える2つの力
言語サーバーが動くと、Claude に次の2つが加わります。
- 編集後の診断:ファイルを書き換えるたびに、サーバーが出したエラーと警告を Claude が受け取ります。コンパイルを動かさなくても、自分が入れた型エラーや読み込み忘れに気づけます
- コードの移動:テキスト検索ではなく、記号(関数や変数)単位で定義や参照を探す読み取り専用の道具が使えます
診断の中身を自分で読むときは、会話の中の要約の行で Ctrl+O を押します。
注意:この仕組みはターミナルで使う場合が対象です。 クラウド上のセッションでは、プラグインの言語サーバーは起動せず、診断も移動も使えません。
推奨ダイアログの4つの選択肢
言語サーバーが入っているのにプラグインが未導入のとき、Claude がファイルを編集したあとに「LSP plugin recommendation」という案内が出ることがあります。1回のセッションで最大1回です。
| 選択肢 | 起きること |
|---|---|
| Yes, install | 自分のアカウントにプラグインを入れる。新しいセッションで有効になる |
| No, not now | 閉じるだけ。あとのセッションでまた出る |
| Never for this plugin | そのプラグインだけ二度と出ない |
| Disable all LSP recommendations | すべての言語で案内を止める |
30秒何も選ばないと「無視」として数えられ、5回続くと、全部を止めた場合と同じ状態になります。 案内を戻したいときは、Claude Code の設定ファイル(ホームフォルダの .claude.json)から、lspRecommendationDisabled と lspRecommendationIgnoredCount のキーを消します。特定のプラグインだけ戻すときは、lspRecommendationNeverPlugins の一覧からその名前を消します。
会社で使うときの考え方
プラグインを部署の標準にするなら、言語サーバー本体の配布も一緒に決めておく必要があります。プラグインだけ配っても、実行ファイルが無ければ「Executable not found」になるからです。標準セットとしてまとめる方法は プラグインの依存関係 の記事が参考になります。
まとめ
- プラグインは言語サーバー本体を含まない。実行ファイルとプラグインの2つを入れる
- 確かめるには、わざと型エラーを作らせて「Found N new diagnostic issues」の行を見る
- 使えるのはターミナルのセッション。クラウドのセッションでは動かない
- 推奨ダイアログは無視を5回続けると止まる。戻すときは設定ファイルのキーを消す
出典:Code intelligence plugins(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


