A 多 Agent 协作
主 Agent 负责对话与决策,子 Agent 在独立上下文里跑探索、审查或特定任务,结果汇总回来。项目里可以定义自己的 Agent,指定模型、提示词与可用工具。
OpenCode 把「理解仓库」和「执行改动」放在同一套循环里。下面这些能力默认就有, 其余的交给你按项目配置。
主 Agent 负责对话与决策,子 Agent 在独立上下文里跑探索、审查或特定任务,结果汇总回来。项目里可以定义自己的 Agent,指定模型、提示词与可用工具。
每个工具调用都可以拦下来问你。配置文件里能按项目、按命令设置允许或拒绝,危险操作不会被静默执行。
接入语言服务器,拿到真实的类型、跳转与诊断信息;再配合文件搜索,改动前先确认调用方,改完顺手跑检查。
会话是一等公民:可以恢复、可以分叉,也可以把链接发出去让别人在你的上下文里继续。服务负责保存,界面随你换。
JSON / JSONC,带官方 schema。全局放在 ~/.config/opencode/,项目里放 opencode.json(c) 或 .opencode/。保存即热加载,不用重启。
用代码挂到生命周期钩子上:改提示词、加工具、动界面都行。插件包和普通 npm 包一样安装、一样发布。
标准 MCP 协议,本地进程或远程 URL 都能挂。远程服务默认走 OAuth,浏览器里登录一次即可。
命令是带参数的斜杠动作,技能是按需加载的说明书。两者都能随仓库提交,团队共享同一套工作流。
下面是一份最小可用的项目配置:指定默认模型、挂一个 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 循环。
安装、连接模型、跑第一次会话,全部在两分钟内完成。