Web 界面与远程访问

在项目目录运行 opencode web，会启动本地服务并自动打开默认浏览器。Web 默认绑定 127.0.0.1，端口为随机可用端口。

本地使用

opencode web --port 4096

显式指定端口后，可在另一个终端连接同一服务：

opencode attach http://localhost:4096

Web 与 TUI 因而使用相同会话和状态。首页可查看活动会话、创建新会话，通过 See Servers 检查已连接服务器及状态。

Windows 官方建议从 WSL 运行，以改善文件访问与终端集成，见Windows 与 WSL。

网络访问与认证

--hostname 0.0.0.0 使服务监听网络接口；未设置密码时，服务没有认证保护。网络使用应设置 OPENCODE_SERVER_PASSWORD，Basic Auth 用户名默认 opencode，可用 OPENCODE_SERVER_USERNAME 修改。

先在运行环境设置密码，再启动服务：

opencode web --hostname 0.0.0.0 --port 4096

启动时会显示本地与网络地址。上述命令不会代替设置认证变量，也不自动配置外部网络入口。

服务发现与跨来源访问

--mdns 启用局域网发现，Web 页说明它会使用 0.0.0.0 并广播 opencode.local。同时显式配置 hostname 时，Config 页的规则是仅在未提供 hostname 时使用该默认，具体见运行设置。

多实例可使用 --mdns-domain myproject.local 设置独立名称。自定义前端需要额外浏览器来源时，用 --cors https://example.com，不是只填写域名或将 CORS 当作登录认证。

保存服务配置

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

这是保留本机监听的示例，不是远程访问配置。CLI 参数优先于配置文件。serve 默认端口是 4096，而 Web 默认选择可用端口；完整 HTTP 接口见服务端。