Agents

Agent 是为特定任务和工作流程配置的专门 AI 助手。它们支持自定义提示、模型和工具访问的聚焦工具。

Agent 类型

主要 Agent

直接交互的主要助手。通过 Tab 键切换。

• Build：默认 Agent，启用所有工具
• Plan：受限 Agent，用于规划和分析

子 Agent

由主要 Agent 调用或通过 @ 提及调用的专门助手。

• General：通用多步骤任务
• Explore：快速代码库探索

配置方法

JSON 配置

{
  "agent": {
    "review": {
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Markdown 配置

放置在 ~/.config/opencode/agent/ 或 .opencode/agent/：

---
description: 代码质量审查
mode: subagent
temperature: 0.1
tools:
  write: false
  edit: false
---
你处于代码审查模式。专注于质量和安全。

配置选项

创建 Agent

opencode agent create

常见用例

• Build agent：完整开发
• Plan agent：不做更改的分析
• Review agent：代码审查（只读）
• Debug agent：问题调查
• Docs agent：文档编写