Windows (WSL)
WSLを使用してWindowsでOpenCodeを最適な環境で実行できます。
OpenCodeはWindows上で直接実行することもできますが、最適な体験のためにWindows Subsystem for Linux (WSL) (opens in a new tab)の使用をお勧めします。WSLはOpenCodeの機能とシームレスに連携するLinux環境を提供します。
なぜWSLなのか?
WSLは、より優れたファイルシステムパフォーマンス、完全なターミナルサポート、そしてOpenCodeが依存する開発ツールとの互換性を提供します。
セットアップ
-
WSLのインストール
まだインストールしていない場合は、Microsoftの公式ガイドを参照してWSLをインストール (opens in a new tab)してください。
-
WSLにOpenCodeをインストール
WSLのセットアップが完了したら、WSLターミナルを開き、インストール方法のいずれかを使用してOpenCodeをインストールします。
curl -fsSL https://opencode.ai/install | bash -
WSLからOpenCodeを使用
プロジェクトディレクトリに移動し(Windowsファイルには
/mnt/c/、/mnt/d/などからアクセス可能)、OpenCodeを実行します。cd /mnt/c/Users/YourName/project opencode
デスクトップアプリ + WSLサーバー
OpenCode Desktopアプリを使用しながら、サーバーをWSLで実行したい場合:
-
WSLでサーバーを起動します。外部接続を許可するために
--hostname 0.0.0.0を指定します:opencode serve --hostname 0.0.0.0 --port 4096 -
Desktopアプリを接続して
http://localhost:4096にアクセスします
お使いの環境でlocalhostが機能しない場合は、代わりにWSLのIPアドレスを使用して接続してください(WSLから:hostname -I)。http://<wsl-ip>:4096を使用します。
--hostname 0.0.0.0を使用する場合は、サーバーを保護するためにOPENCODE_SERVER_PASSWORDを設定してください。
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0Webクライアント + WSL
WindowsでのWeb体験を最適化するには:
-
PowerShellではなくWSLターミナルで
opencode webを実行します:opencode web --hostname 0.0.0.0 -
Windowsブラウザからアクセスします。
http://localhost:<port>(OpenCodeがURLを表示します)
WSLからopencode webを実行することで、Windowsブラウザからアクセス可能でありながら、適切なファイルシステムアクセスとターミナル統合が確保されます。
Windowsファイルへのアクセス
WSLは/mnt/ディレクトリを通じてすべてのWindowsファイルにアクセスできます:
C:ドライブ →/mnt/c/D:ドライブ →/mnt/d/- その他も同様…
例:
cd /mnt/c/Users/YourName/Documents/project
opencode最もスムーズな体験のために、リポジトリをWSLファイルシステム内(例えば~/code/配下)にクローン/コピーし、そこでOpenCodeを実行することを検討してください。
ヒント
- Windowsドライブに保存されているプロジェクトでは、WSLでOpenCodeを実行し続けてください - ファイルアクセスはシームレスです
- 統合された開発ワークフローのために、VS CodeのWSL拡張機能 (opens in a new tab)をOpenCodeと併用してください
- OpenCodeの設定とセッションは、WSL環境内の
~/.local/share/opencode/に保存されます