日本語
ドキュメント
Windows (WSL)

Windows (WSL)

WSLを使用してWindowsでOpenCodeを最適な環境で実行できます。

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

💡

なぜWSLなのか?

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


セットアップ

  1. WSLのインストール

    まだインストールしていない場合は、Microsoftの公式ガイドを参照してWSLをインストール (opens in a new tab)してください。

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

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

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

    プロジェクトディレクトリに移動し(Windowsファイルには/mnt/c//mnt/d/などからアクセス可能)、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にアクセスします

お使いの環境で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クライアント + WSL

WindowsでのWeb体験を最適化するには:

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

    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
💡

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


ヒント

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