Windows (WSL)

WSL を使って Windows で OpenCode を使う。

OpenCode は Windows で直接実行できますが、より快適に使うには Windows Subsystem for Linux (WSL) の利用をおすすめします。WSL は OpenCode の機能とスムーズに連携する Linux 環境を提供します。

セットアップ

WSL をインストールする

まだの場合は、Microsoft 公式ガイドを使って WSL をインストールします。
WSL で OpenCode をインストールする

WSL の準備ができたら WSL のterminal を開き、インストール方法のいずれかで OpenCode をインストールします。
Terminal window
```
curl -fsSL https://opencode.ai/install | bash
```
WSL から OpenCode を使う

プロジェクトディレクトリに移動し（Windows ファイルは /mnt/c/ や /mnt/d/ などからアクセス）、OpenCode を実行します。
Terminal window
```
cd /mnt/c/Users/YourName/project
opencode
```

OpenCode Desktop アプリを使いつつ、サーバーは WSL で動かしたい場合は次の手順です。

WSL でサーバーを起動する

外部接続を許可するため、--hostname 0.0.0.0 を付けて起動します。
Terminal window
```
opencode serve --hostname 0.0.0.0 --port 4096
```
Desktop アプリを接続する

http://localhost:4096 に接続します。

環境によって localhost が使えない場合は、WSL 側で hostname -I を実行して IP アドレスを確認し、http://<wsl-ip>:4096 に接続してください。

--hostname 0.0.0.0 を使う場合は、OPENCODE_SERVER_PASSWORD を設定してサーバーを保護してください。

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

Windows で Web 利用を快適にするには:

PowerShell ではなく WSL terminal で opencode web を実行する
Terminal window
```
opencode web --hostname 0.0.0.0
```
Windows のブラウザーからアクセスする

http://localhost:<port> にアクセスします（URL は OpenCode が表示します）。

WSL から opencode web を実行すると、適切なファイルシステムアクセスとterminal 統合を維持したまま、Windows ブラウザーから利用できます。

WSL からは /mnt/ ディレクトリ経由で Windows ファイルにアクセスできます。

例:

cd /mnt/c/Users/YourName/Documents/project
opencode