Web 网页版

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

快速开始

启动 Web 界面：

opencode web

这将在 127.0.0.1 上启动一个本地服务器，自动选择端口并在默认浏览器中打开应用。

安全提示： 如果未设置 OPENCODE_SERVER_PASSWORD，服务器将没有任何安全保护。这对于本地使用是可以接受的，但在暴露到网络时必须设置密码。

配置选项

端口

指定自定义端口：

opencode web --port 4096

主机名

绑定到所有网络接口：

opencode web --hostname 0.0.0.0

默认情况下，服务器绑定到 127.0.0.1（仅本地访问）。使用 0.0.0.0 允许网络访问。

mDNS 发现

启用本地网络发现：

opencode web --mdns

这将自动将主机名设置为 0.0.0.0 并在本地网络上以 opencode.local 广播服务器。

CORS

允许额外的域进行跨源请求：

opencode web --cors https://example.com

身份验证

使用密码保护服务器访问：

OPENCODE_SERVER_PASSWORD=secret opencode web

用户名默认为 opencode，可以通过 OPENCODE_SERVER_USERNAME 自定义。

Web 界面功能

• 会话管理：从主页查看和管理活动会话
• 服务器状态：通过"查看服务器"选项访问已连接的服务器

终端附加

将终端 TUI 连接到正在运行的 Web 服务器：

opencode web --port 4096
opencode attach http://localhost:4096

这允许同时从浏览器和终端访问。

配置文件

在 opencode.json 中配置服务器设置：

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

命令行参数会覆盖配置文件设置。