Web

在浏览器中使用 OpenCode。

OpenCode 可以作为 Web 应用在你的浏览器中运行，无需终端即可提供同样强大的 AI 编码体验。

快速开始

通过运行以下命令启动 Web 界面：

opencode web

这会在 127.0.0.1 上启动一个本地服务器，使用一个随机的可用端口，并自动在你的默认浏览器中打开 OpenCode。

警告： 如果未设置 OPENCODE_SERVER_PASSWORD，服务器将不受保护。这对于本地使用没有问题，但在进行网络访问时应当设置。

提示： 为获得最佳体验，请从 WSL 运行 opencode web，而不是 PowerShell。这能确保正确的文件系统访问和终端集成。

配置

你可以使用命令行标志或在你的 配置文件 中配置 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 会话的访问。

会话

在主页上查看和管理你的会话。你可以看到活动会话并开启新会话。

服务器状态

点击 "See Servers" 查看已连接的服务器及其状态。

接入终端

你可以将终端 TUI 接入到正在运行的 Web 服务器：

# 启动 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"]
  }
}

命令行标志的优先级高于配置文件中的设置。