Windows (WSL)
OpenCode は Windows 上で直接実行することもできますが、最良の体験を得るためには Windows Subsystem for Linux (WSL) の使用を推奨します。WSL は OpenCode の機能とシームレスに動作する Linux 環境を提供します。
セットアップ
-
WSL をインストールする
まだインストールしていない場合は、Microsoft の公式ガイドに従って WSL をインストール します。
-
WSL 内に OpenCode をインストールする
WSL のセットアップが完了したら、WSL ターミナルを開き、いずれかの インストール方法 を使用して OpenCode をインストールします。
curl -fsSL https://opencode.ai/install | bash -
WSL から OpenCode を使用する
プロジェクトディレクトリに移動し (
/mnt/c/、/mnt/d/などを介して Windows ファイルにアクセスできます)、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に接続します。
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
Web クライアント + WSL
Windows で最良の Web 体験を得るには:
-
WSL ターミナルで
opencode webを実行 します (PowerShell ではなく)。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
ヒント
- Windows ドライブ上にあるプロジェクトの OpenCode は WSL 内で実行してください。ファイルアクセスがシームレスになります
- 統合された開発ワークフローのために、VS Code の WSL 拡張機能 を OpenCode と併用してください
- OpenCode の設定とセッションは WSL 環境内の
~/.local/share/opencode/に保存されます