コンテンツにスキップ

Web

Web

ブラウザーで OpenCode を使用します。

OpenCode は Web アプリケーションとしてブラウザーで実行でき、ターミナルを必要とせずに同じ強力な AI コーディング体験を提供します。

OpenCode Web - New Session


Getting Started

Web インターフェースを起動するには以下を実行します:

opencode web

これにより、ランダムな利用可能なポートで 127.0.0.1 にローカルサーバーが起動し、自動的にデフォルトブラウザで OpenCode が開きます。

[!CAUTION] OPENCODE_SERVER_PASSWORD が設定されていない場合、サーバーは保護されません。これはローカル使用には問題ありませんが、ネットワークアクセスには設定する必要があります。

[!NOTE] Windows ユーザー: 最良の体験のために、PowerShell ではなく WSL から opencode web を実行してください。これにより、適切なファイルシステムアクセスとターミナル統合が確保されます。


Configuration

Web サーバーはコマンドラインフラグまたは設定ファイル で設定できます。

Port

デフォルトで、OpenCode は利用可能なポートを選びます。ポートを指定できます:

opencode web --port 4096

Hostname

デフォルトで、サーバーは 127.0.0.1(localhost のみ)にバインドされます。OpenCode をネットワークでアクセス可能にするには:

opencode web --hostname 0.0.0.0

0.0.0.0 を使用すると、OpenCode はローカルとネットワークの両方のアドレスを表示します:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

mDNS Discovery

mDNS を有効にしてサーバーをローカルネットワークで検出可能にします:

opencode web --mdns

これにより、hostname が自動的に 0.0.0.0 に設定され、サーバーが opencode.local としてアドバタイズされます。

同じネットワーク上で複数のインスタンスを実行するために mDNS ドメイン名をカスタマイズできます:

opencode web --mdns --mdns-domain myproject.local

CORS

追加のドメインを CORS 用に許可する(カスタムフロントエンドに便利です):

opencode web --cors https://example.com

Authentication

アクセスを保護するには、OPENCODE_SERVER_PASSWORD 環境変数を使用してパスワードを設定します:

OPENCODE_SERVER_PASSWORD=secret opencode web

ユーザー名はデフォルトで opencodeですが、OPENCODE_SERVER_USERNAME で変更できます。


Using the Web Interface

起動すると、Web インターフェースは OpenCode セッションへのアクセスを提供します。

Sessions

ホームページからセッションを表示して管理します。アクティブなセッションを表示し、新規セッションを開始できます。

OpenCode Web - Active Session

Server Status

「See Servers」をクリックして、接続されたサーバーとその状態を表示します。

OpenCode Web - See Servers


Attaching a Terminal

実行中の Web サーバーにターミナル TUI を接続できます:

# Start the web server
opencode web --port 4096
# In another terminal, attach the TUI
opencode attach http://localhost:4096

これにより、Web インターフェースとターミナルを同時に使用でき、同じセッションと状態を共有できます。


Config File

opencode.json設定ファイルでサーバー設定を設定することもできます:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

コマンドラインフラグは設定ファイル設定より優先します。