OpenCode LSP サーバー設定

OpenCode は言語サーバープロトコル（LSP、Language Server Protocol）と深く統合されており、LSP サーバーを介して LLM にコード診断やエラー通知などのリアルタイムフィードバックを提供し、AI がコードベースをより正確に理解・操作できるようにします。

簡単に言うと、LSP サーバーは OpenCode に「コードを読み取る」能力を持たせるコンポーネントであり、VS Code でコード補完やエラー通知を提供するプラグインに似ています。ファイルに構文エラーや型の不一致があると、LSP サーバーはこれらの診断情報を LLM にフィードバックし、より正確な修正を行えるようにします。

動作原理

OpenCode の LSP 統合は全自動で、手動による操作は不要です。OpenCode がファイルを開くと、以下のフローが順に実行されます：

打开文件
  │
  ▼
读取文件扩展名（如 .ts、.py、.go）
  │
  ▼
与所有已启用的 LSP 服务器进行匹配
  │
  ├── 匹配成功且服务器已运行 → 直接使用
  │
  └── 匹配成功但服务器未运行 → 自动启动对应 LSP 服务器

プロセス全体はバックグラウンドで静かに完了し、LSP サーバーが起動すると、現在のセッションに対して診断情報を継続的に提供します。

組み込み LSP サーバー

OpenCode には主要言語の LSP サーバーサポートが組み込まれており、対応するファイル拡張子が検出され、対応する要件を満たすと、LSP サーバーが自動的に有効になります。ほとんどの場合、設定は一切不要です。

OpenCode に LSP サーバーを自動ダウンロードさせたくない場合は、環境変数OPENCODE_DISABLE_LSP_DOWNLOADをtrueに設定すると自動ダウンロードを無効化できます。詳細は文末の説明を参照してください。

LSP サーバーの設定

LSP 関連の設定はopencode.jsonのlspフィールドに記述します。ほとんどの場合、設定は不要で LSP は自動的に有効になりますが、動作をカスタマイズする必要がある場合、各 LSP サーバーは以下の設定項目をサポートしています：

1、環境変数の設定（env）

を使用してenvプロパティで LSP サーバー起動時に環境変数を注入します。デバッグログの有効化や、実行時に必要なパスの指定によく使用されます：

2、初期化オプションの設定（initialization）

initializationLSP サーバーにサーバー固有の設定を渡すために使用します。これらのオプションは LSP ハンドシェイク（initializeリクエスト）フェーズで一度に送信され、その後のサーバーのすべての動作に影響します：

初期化オプションは LSP サーバーによって異なります。たとえばtypescriptのオプションはgoplsとは完全に異なります。使用前に該当する LSP サーバーの公式ドキュメントを確認し、無効な設定を渡さないようにしてください。

LSP サーバーの無効化

1、すべての LSP サーバーを無効化する

LSP 機能がまったく不要な場合は、lsp全体をfalseに設定すると、すべての LSP サーバーを一度に無効化できます：

2、特定の LSP サーバーを無効化する

特定の LSP サーバーだけを無効化して他は残したい場合は、そのサーバーに対して個別にdisabled: true：

カスタム LSP サーバーの追加

使用している言語が組み込みサポートリストにない場合は、commandとextensionsを指定して任意の LSP サーバーを手動で追加できます。そのサーバーが標準の LSP プロトコルに従い、--stdioモード（標準入出力での通信）をサポートしていれば問題ありません：

また、カスタム LSP サーバーに環境変数と初期化オプションを同時に設定することもできます。組み込みサーバーとまったく同じ書き方です：

補足説明

PHP Intelephense ライセンス

PHP Intelephense は無料版と有料のプレミアム版を提供しています。プレミアム版はライセンスキーでロックを解除し、インポート整理、コード折りたたみ、呼び出し階層の表示などの拡張機能が含まれます。ライセンスを購入した場合は、キーを以下のパスのテキストファイルに単独で書き込むだけで自動的にアクティベートされ、追加の設定は一切不要です。

ライセンスファイルにはライセンスキーそのものだけを含めてください。余分なスペースや改行など、他の内容を追加しないでください。追加するとアクティベーションに失敗する可能性があります。

自動ダウンロードの無効化

OpenCode は、対応するファイル拡張子を検出すると、デフォルトで必要な LSP サーバーをネットワークから自動的にダウンロードします。ネットワークが制限された環境にいる場合や、LSP ツールを完全に手動で管理したい場合は、以下の環境変数を設定することで自動ダウンロードを無効にできます。

# Linux / macOS：临时禁用（仅当前终端会话有效）
export OPENCODE_DISABLE_LSP_DOWNLOAD=true

# Linux / macOS：永久禁用（写入 shell 配置文件）
echo 'export OPENCODE_DISABLE_LSP_DOWNLOAD=true' >> ~/.bashrc
source ~/.bashrc

# Windows（PowerShell：仅当前会话）
$env:OPENCODE_DISABLE_LSP_DOWNLOAD = "true"

無効にすると、OpenCode は LSP サーバーを自動的にダウンロードしなくなりますが、システムにプリインストールされている LSP ツールは引き続き正常に検出して使用できます。