コード インテリジェンス プラグインはターミナル セッションで動作します。クラウド セッションでは、Claude Code はプラグイン言語サーバーを起動しないため、Claude はそこで診断またはコード ナビゲーションを取得しません。独自の言語サーバー プラグインを作成するか、プラグインがない言語サーバーを接続するには、プラグイン コンポーネントの LSP サーバーを参照してください。
コード インテリジェンス プラグインをインストールする
コード インテリジェンス プラグインは、言語サーバーを起動するコマンドと、それが処理するファイル拡張子を Claude Code に伝えます。言語サーバーは含まれていません。まず言語サーバー バイナリをインストールし、次にプラグインをインストールし、サーバーが起動することを確認します。1
言語サーバー バイナリをインストールする
下の表で言語を見つけ、その行のバイナリをインストールします。言語がリストされていない場合は、公式プラグインのない言語を追加するを参照してください。
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
プラグインをインストールする
ステップ 1 の表で言語用にリストされているプラグインをインストールするには、Claude Code セッション内で 確認メッセージは、プラグインが現在アクティブであるか、
/plugin install を実行し、typescript-lsp をそのプラグインの名前に置き換えます。/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 を起動したシェルの 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 推奨を無効にする: ダイアログはすべての言語に対して表示されなくなります。
推奨をオンに戻す
LSP プラグイン推奨ダイアログは、すべての LSP 推奨を無効にするを選択するか、5 回無視した後に表示されなくなります。- 無効または 5 回無視: どちらの場合でもオンに戻すには、Claude Code 独自の設定ファイルである
~/.claude.jsonからlspRecommendationDisabledとlspRecommendationIgnoredCountキーを削除します。 - このプラグインは表示しない: このプラグインは表示しないを選択し、そのプラグインを再度提供したい場合は、同じファイルの
lspRecommendationNeverPluginsリストからそのname@marketplaceID を削除します。
コード インテリジェンスのトラブルシューティング
プラグインのトラブルシューティング ページでは、言語サーバーが起動しない、メモリ使用量が多い、または診断が正しくないの下にあるコード インテリジェンス プラグインに固有の症状について説明しています。- 言語サーバーが起動しない：
/pluginの Errors タブにExecutable not found in $PATHが表示されるか、Claude が言語の診断をレポートしません。 - メモリ使用量が多い：サーバーがプロジェクトをインデックスしている間、メモリ使用量が増加します。
- モノレポでの誤検知診断：診断が、実際には解決されているインポートを未解決としてレポートします。
公式プラグインのない言語を追加する
言語が公式プラグインの表にない場合でも、言語サーバーを接続できます。- サーバー コマンドとそれが処理するファイル拡張子に名前を付ける
.lsp.jsonファイルを使用してプラグインを作成します。 - 次に、
--plugin-dirを使用してプラグインを読み込むか、マーケットプレイスに公開します。
次のステップ
- プラグイン コンポーネント内の LSP サーバー: 公式プラグインがない言語サーバーの
.lsp.jsonを作成します。 - プラグインをインストールして管理する: スコープ、更新、アンインストール
- プラグインのトラブルシューティング: このページの言語サーバー以外のロード エラー
- 公式マーケットプレイスでプラグインを見つける: 公式マーケットプレイスの残りを参照する場所