能力

能读、能改、能验证的 Agent

OpenCode 把「理解仓库」和「执行改动」放在同一套循环里。下面这些能力默认就有, 其余的交给你按项目配置。

A 多 Agent 协作

主 Agent 负责对话与决策,子 Agent 在独立上下文里跑探索、审查或特定任务,结果汇总回来。项目里可以定义自己的 Agent,指定模型、提示词与可用工具。

B 权限与信任边界

每个工具调用都可以拦下来问你。配置文件里能按项目、按命令设置允许或拒绝,危险操作不会被静默执行。

C 代码理解

接入语言服务器,拿到真实的类型、跳转与诊断信息;再配合文件搜索,改动前先确认调用方,改完顺手跑检查。

D 会话可分享

会话是一等公民:可以恢复、可以分叉,也可以把链接发出去让别人在你的上下文里继续。服务负责保存,界面随你换。

扩展系统

四条路,把你自己的东西接进来

01 配置

JSON / JSONC,带官方 schema。全局放在 ~/.config/opencode/,项目里放 opencode.json(c) 或 .opencode/。保存即热加载,不用重启。

02 插件

用代码挂到生命周期钩子上:改提示词、加工具、动界面都行。插件包和普通 npm 包一样安装、一样发布。

03 MCP 服务器

标准 MCP 协议,本地进程或远程 URL 都能挂。远程服务默认走 OAuth,浏览器里登录一次即可。

04 命令与技能

命令是带参数的斜杠动作,技能是按需加载的说明书。两者都能随仓库提交,团队共享同一套工作流。

配置示例

一个文件,说清它该怎么干活

下面是一份最小可用的项目配置:指定默认模型、挂一个 MCP 服务器,并把某个命令设成免问。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "provider/model-id",
  "mcp": {
    "servers": {
      "docs": {
        "type": "remote",
        "url": "https://example.com/mcp",
        "enabled": true
      }
    }
  },
  "permissions": {
    "bash": { "git status": "allow" }
  }
}
架构

客户端很薄,服务很稳

后台服务持有会话、配置、插件与工具执行。终端、桌面端、Web 都是客户端;崩溃了重连,上下文还在。

客户端

TUI、桌面应用、浏览器。只管显示与输入,换设备不影响会话。

服务

会话状态、模型调用、工具执行、权限判定。默认自动发现或拉起,必要时可单独重启。

接口

HTTP + OpenAPI。TypeScript 客户端、SDK,甚至把你的产品直接嵌进 Agent 循环。

把它装进你的仓库

安装、连接模型、跑第一次会话,全部在两分钟内完成。

上手 →