Windows (WSL)

最高の体験を得るために WSL を使って Windows 上で OpenCode を実行します。

OpenCode は Windows 上で直接実行できますが、最高の体験を得るには Windows Subsystem for Linux (WSL) (opens in a new tab) の使用をおすすめします。WSL は OpenCode の機能とシームレスに連携する Linux 環境を提供します。

ヒント: WSL はより優れたファイルシステムのパフォーマンス、完全なターミナルサポート、そして OpenCode が依存する開発ツールとの互換性を提供します。

Setup

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
```

Desktop App + WSL Server

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.0

Web Client + WSL

Windows 上で最高の Web 体験を得るには:

opencode web を PowerShell ではなく WSL ターミナルで実行する:
```
opencode web --hostname 0.0.0.0
```
Windows のブラウザからアクセスする 先は http://localhost:<port> です（OpenCode が URL を出力します）

WSL から opencode web を実行すると、適切なファイルシステムアクセスとターミナル連携が確保され、Windows のブラウザからもアクセスできます。

Accessing Windows Files

WSL は /mnt/ ディレクトリを通じてすべての Windows ファイルにアクセスできます:

C: ドライブ → /mnt/c/
D: ドライブ → /mnt/d/
以下同様...

例:

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

ヒント: 最もスムーズな体験を得るには、リポジトリを WSL のファイルシステム内（例えば ~/code/ の下）にクローン/コピーして、そこで OpenCode を実行することを検討してください。

Tips

Windows のドライブに保存されたプロジェクトでは OpenCode を WSL で実行し続けてください - ファイルアクセスがシームレスになります
統合された開発ワークフローのために、OpenCode と並行して VS Code の WSL 拡張機能 (opens in a new tab)を使用してください
OpenCode の設定とセッションは WSL 環境内の ~/.local/share/opencode/ に保存されます

トラブルシューティング TUI