Files
tf_code/packages/web/src/content/docs/ja/web.mdx
2026-02-09 11:34:35 -06:00

143 lines
4.5 KiB
Plaintext

---
title: ウェブ
description: ブラウザで OpenCode を使用する。
---
OpenCode はブラウザーで Web アプリケーションとして実行でき、ターミナルを必要とせずに同じ強力な AI コーディング エクスペリエンスを提供します。
![OpenCode Web - 新しいセッション](../../../assets/web/web-homepage-new-session.png)
## はじめる
以下を実行して Web インターフェースを開始します。
```bash
opencode web
```
これにより、利用可能なランダムなポートを使用して `127.0.0.1` でローカル サーバーが起動され、デフォルトのブラウザで OpenCode が自動的に開きます。
:::注意
`OPENCODE_SERVER_PASSWORD` が設定されていない場合、サーバーは保護されません。これはローカルで使用する場合には問題ありませんが、ネットワーク アクセス用に設定する必要があります。
:::
:::tip[Windows ユーザー]
最高のエクスペリエンスを得るには、PowerShell ではなく [WSL](/docs/windows-wsl) から `opencode web` を実行します。これにより、ファイル システムへの適切なアクセスと端末の統合が保証されます。
:::
---
## 構成
コマンド ライン フラグを使用するか、[config file](/docs/config).config ファイル] で Web サーバーを設定できます。
### ポート
デフォルトでは、OpenCode は使用可能なポートを選択します。ポートを指定できます。
```bash
opencode web --port 4096
```
### ホスト名
デフォルトでは、サーバーは `127.0.0.1` (localhost のみ) にバインドされます。ネットワーク上で OpenCode にアクセスできるようにするには:
```bash
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 を有効にして、ローカル ネットワーク上でサーバーを検出できるようにします。
```bash
opencode web --mdns
```
これにより、ホスト名が自動的に `0.0.0.0` に設定され、サーバーが `opencode.local` としてアドバタイズされます。
mDNS ドメイン名をカスタマイズして、同じネットワーク上で複数のインスタンスを実行できます。
```bash
opencode web --mdns --mdns-domain myproject.local
```
### コルス
CORS の追加ドメインを許可するには (カスタム フロントエンドに便利):
```bash
opencode web --cors https://example.com
```
### 認証
アクセスを保護するには、`OPENCODE_SERVER_PASSWORD` 環境変数を使用してパスワードを設定します。
```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```
ユーザー名のデフォルトは `opencode` ですが、`OPENCODE_SERVER_USERNAME` で変更できます。
---
## Web インターフェースの使用
開始すると、Web インターフェイスから OpenCode セッションにアクセスできるようになります。
### セッション
ホームページからセッションを表示および管理します。アクティブなセッションを確認したり、新しいセッションを開始したりできます。
![OpenCode Web - アクティブなセッション](../../../assets/web/web-homepage-active-session.png)
### サーバーステータス
「サーバーを表示」をクリックすると、接続されているサーバーとそのステータスが表示されます。
![OpenCode Web - Servers](../../../assets/web/web-homepage-see-servers.png) を参照
---
## 端子の取り付け
実行中の Web サーバーにターミナル TUI を接続できます。
```bash
# Start the web server
opencode web --port 4096
# In another terminal, attach the TUI
opencode attach http://localhost:4096
```
これにより、Web インターフェイスとターミナルの両方を同時に使用し、同じセッションと状態を共有できるようになります。
---
## 設定ファイル
`opencode.json` 構成ファイルでサーバー設定を構成することもできます。
```json
{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"cors": ["https://example.com"]
}
}
```
コマンド ライン フラグは、構成ファイルの設定よりも優先されます。