summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/ja/web.mdx
blob: 030186d07cc2c156f8cd19c471742261a0f2a188 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
---
title: ウェブ
description: ブラウザで OpenCode を使用する。
---

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

![OpenCode Web - 新しいセッション](../../../assets/web/web-homepage-new-session.png)

## はじめる

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

```bash
opencode web
```

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

:::caution
`OPENCODE_SERVER_PASSWORD` が設定されていない場合、サーバーは保護されません。これはローカルで使用する場合には問題ありませんが、ネットワーク アクセス用に設定する必要があります。
:::tip[Windows ユーザー]
最高のエクスペリエンスを得るには、PowerShell ではなく [WSL](/docs/windows-wsl) から `opencode web` を実行します。これにより、ファイル システムへの適切なアクセスとterminal の統合が保証されます。
:::

---

## 構成

コマンド ライン フラグを使用するか、[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) を参照

---

## terminal の接続

実行中の Web サーバーにterminal TUI を接続できます。

```bash
# Start the web server
opencode web --port 4096

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

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

---

## 設定ファイル

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

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

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