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つ入れます。

  1. 使う言語の言語サーバー(実行ファイル)を自分のパソコンに入れる
  2. 同じ言語のプラグインを、公式のマーケットプレイスから入れる
  3. 動くことを確かめる

つながる仕組みは LSP(Language Server Protocol)という共通の約束です。言語ごとに1つのプラグインがあります。

言語ごとのプラグインと実行ファイル

公式の表から、よく使う言語を抜き出します。

言語プラグイン言語サーバー
TypeScript・JavaScripttypescript-lsptypescript-language-server
Pythonpyright-lsppyright-langserver
Gogopls-lspgopls
Rustrust-analyzer-lsprust-analyzer
Javajdtls-lspjdtls
C・C++clangd-lspclangd

このほか 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つが加わります。

診断の中身を自分で読むときは、会話の中の要約の行で 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」になるからです。標準セットとしてまとめる方法は プラグインの依存関係 の記事が参考になります。

まとめ

  1. プラグインは言語サーバー本体を含まない。実行ファイルとプラグインの2つを入れる
  2. 確かめるには、わざと型エラーを作らせて「Found N new diagnostic issues」の行を見る
  3. 使えるのはターミナルのセッション。クラウドのセッションでは動かない
  4. 推奨ダイアログは無視を5回続けると止まる。戻すときは設定ファイルのキーを消す

出典:Code intelligence plugins(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事