ウェブ

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

はじめる

以下を実行して Web インターフェースを開始します。

opencode web

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

設定

コマンドラインフラグを使用するか、設定ファイルで Web サーバーを設定できます。

ポート

デフォルトでは、OpenCode は使用可能なポートを選択します。ポートを指定できます。

opencode web --port 4096

ホスト名

デフォルトでは、サーバーは 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 検出

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

認証

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

OPENCODE_SERVER_PASSWORD=secret opencode web

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

Web インターフェースの使用

開始すると、Web インターフェイスから OpenCode セッションにアクセスできるようになります。

セッション

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

サーバーステータス

「サーバーを表示」をクリックすると、接続されているサーバーとそのステータスが表示されます。

ターミナルの接続

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

# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096

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

設定ファイル

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

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

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