コンテンツにスキップ

Windows (WSL)

OpenCode は Windows 上で直接実行することもできますが、最良の体験を得るためには Windows Subsystem for Linux (WSL) の使用を推奨します。WSL は OpenCode の機能とシームレスに動作する Linux 環境を提供します。


セットアップ

  1. WSL をインストールする

    まだインストールしていない場合は、Microsoft の公式ガイドに従って WSL をインストール します。

  2. WSL 内に OpenCode をインストールする

    WSL のセットアップが完了したら、WSL ターミナルを開き、いずれかの インストール方法 を使用して OpenCode をインストールします。

    curl -fsSL https://opencode.ai/install | bash
  3. WSL から OpenCode を使用する

    プロジェクトディレクトリに移動し (/mnt/c//mnt/d/ などを介して Windows ファイルにアクセスできます)、OpenCode を実行します。

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

デスクトップアプリ + WSL サーバー

OpenCode Desktop アプリの使用を希望しつつ、サーバーを WSL 内で実行したい場合は:

  1. WSL 内で外部接続を許可する --hostname 0.0.0.0 を指定してサーバーを起動 します。

    opencode serve --hostname 0.0.0.0 --port 4096
  2. Desktop アプリhttp://localhost:4096 に接続します。

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

Web クライアント + WSL

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

  1. WSL ターミナルで opencode web を実行 します (PowerShell ではなく)。

    opencode web --hostname 0.0.0.0
  2. 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/ に保存されます