一、什么是 Agent？

Agent（代理）是 OpenCode 中的专门化 AI 助手。不同类型的 Agent 可以配置不同的提示词、模型和工具权限，以完成特定的开发任务。

Agent 类型

OpenCode 有两种 Agent 类型：

1. 主 Agent（Primary）：直接与你交互的助手，可通过 Tab 键切换
2. 子 Agent（Subagent）：主 Agent 调用的专门化助手，可通过 @ 提及

内置 Agent

• Build（默认主 Agent）：拥有所有工具权限，适合日常开发
• Plan（主 Agent）：只读模式，适合分析和规划
• General（子 Agent）：通用目的，可执行多步骤任务
• Explore（子 Agent）：快速只读搜索，适合探索代码库
• Scout（子 Agent）：外部文档和依赖研究

配置自定义 Agent

在 opencode.json 中配置：

jsonc { "agent": { "code-reviewer": { "description": "审查代码质量和最佳实践", "mode": "subagent", "model": "anthropic/claude-sonnet-4-5", "prompt": "你是一个代码审查专家..." } } }

使用 Markdown 定义 Agent

也可以在 ~/.config/opencode/agents/ 中创建 .md 文件：

`markdown

description: 文档编写助手
mode: subagent
permission:
edit: allow
bash: deny

你是一个技术文档写手，专注于编写清晰易懂的文档。
`

文件名即为 Agent 名称，例如 docs.md 创建 docs Agent。