OpenCodeをVS Codeで使う方法：導入・作業・トラブル対応の7項目

拡張機能はOpenCode CLIの代わりではありません。統合ターミナルでopencode --versionを実行し、見つからなければPATHを直します。実際のリポジトリを開き、Git状態と除外ファイルを確認してください。通常のOpenCodeセッションでProviderとモデルも試すと、認証・ネットワーク・IDEの問題を分離できます。

リポジトリを開き、新しい統合ターミナルでopencodeを実行します。公式IDE文書では、この操作で拡張機能が自動導入されます。起動後にCtrl+EscまたはCmd+Escを試してください。Marketplaceから手動導入してもCLIやProviderの正常性までは証明できません。別セッションはCtrl+Shift+EscまたはCmd+Shift+Escで開始し、同じファイルの同時編集は避けます。

問題を説明する最小のコードだけを選びます。大きなファイル全体より、関数やエラー分岐の選択が明確です。Windows/LinuxのAlt+Ctrl+K、macOSのCmd+Option+Kで@File#L37-42のような参照を挿入できます。大幅な編集後は行番号を確認し直してください。コンテキスト共有は権限設定を上書きしません。

最初にgit statusを確認し、期待する結果と変更禁止のファイルを伝えます。ターミナルを表示したまま作業ディレクトリとコマンドを見て、編集後はSource Controlの差分を確認します。まず最小のテストを実行し、必要に応じて検証範囲を広げます。古い指示が混ざったら新しいセッションへ切り替えます。

統合ターミナルがローカル、WSL、SSH、コンテナのどこを指すか確認します。秘密鍵、顧客データ、本番設定は選択しないでください。CLIと拡張機能は開発環境で動きますが、モデルへの要求はProviderへ送信される場合があります。デプロイ、データベース、決済、認証の操作は人が承認します。

自動導入に失敗したら、統合ターミナル内でopencodeを試し、PATH変更後はVS Codeを再起動します。code --versionも確認します。Cursor、Windsurf、VSCodiumではcursor、windsurf、codiumを使います。ショートカットだけ動かない場合はキー競合を確認し、セッションは開くのにモデルが失敗する場合はProvider、プロキシ、利用制限を調べます。

opencode、code、Providerが正常でIDEコマンドだけ欠ける場合に再導入します。拡張機能を削除し、全ウィンドウを閉じ、リポジトリを開き直して新しい統合ターミナルでopencodeを実行します。ターミナル対応IDEなら拡張なしでもCLIは使えます。EDITOR="code --wait"は/editorや/export用であり、拡張機能の代替ではありません。