Web

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

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

Getting Started

次のコマンドを実行して Web インターフェースを起動します:

opencode web

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

注意: OPENCODE_SERVER_PASSWORD が設定されていない場合、サーバーは保護されません。ローカル利用では問題ありませんが、ネットワークアクセスの場合は設定すべきです。

ヒント: 最高の体験を得るには、opencode web を PowerShell ではなく WSL から実行してください。これにより、適切なファイルシステムアクセスとターミナル連携が確保されます。

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

これにより、ホスト名が自動的に 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

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

Server Status

「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"]
  }
}

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