日本語
ドキュメント
Web

Web

ブラウザで OpenCode を使用する。

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

はじめに

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

opencode web

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

⚠️

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

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


設定

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

ポート

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

opencode web --port 4096

ホスト名

デフォルトでは、サーバーは 127.0.0.1(ローカルホストのみ)にバインドされます。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 セッションにアクセスできます。

セッション

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

サーバーステータス

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


ターミナルのアタッチ

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

# Web サーバーを起動
opencode web --port 4096
 
# 別のターミナルで TUI をアタッチ
opencode attach http://localhost:4096

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


設定ファイル

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

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

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