文档
中文文档
模式

模式

模式可以为不同的工作流自定义 opencode 的行为。它们允许你为特定用例配置模型选择、温度、提示词和工具访问权限。

内置模式

Build 模式

默认模式，拥有完整的工具访问权限，用于标准开发工作。所有工具都已启用。

Plan 模式

专为规划和分析设计的受限模式。以下工具默认禁用：

  • write
  • edit
  • patch
  • bash

在会话中使用 Tab 键在模式之间切换。

配置选项

选项用途
model覆盖默认 AI 模型
temperature响应随机性（0.0-1.0）
prompt通过文件引用自定义系统指令
tools启用/禁用特定功能

可用工具

  • bash - 执行 shell 命令
  • edit - 编辑现有文件
  • write - 创建新文件
  • read - 读取文件内容
  • grep - 搜索文件内容
  • glob - 按模式查找文件
  • list - 列出目录内容
  • patch - 应用补丁
  • todowrite - 写入待办列表
  • todoread - 读取待办列表
  • webfetch - 获取网页内容

配置方法

JSON 配置

添加到 opencode.json：

{
  "agent": {
    "debug": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-4",
      "temperature": 0.2,
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Markdown 配置

在 .opencode/mode/（项目级）或 ~/.config/opencode/mode/（全局）中创建文件：

---
description: Debug mode for investigation
mode: primary
temperature: 0.2
tools:
  write: false
  edit: false
---
You are in debug mode. Focus on investigating issues without making changes.

常见用例

代码审查模式

{
  "agent": {
    "review": {
      "mode": "primary",
      "description": "Reviews code for quality and security",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      }
    }
  }
}

文档模式

{
  "agent": {
    "docs": {
      "mode": "primary",
      "description": "Writes and updates documentation",
      "model": "anthropic/claude-sonnet-4",
      "temperature": 0.3
    }
  }
}

重构模式

{
  "agent": {
    "refactor": {
      "mode": "primary",
      "description": "Refactors code with careful analysis",
      "temperature": 0.1
    }
  }
}

切换模式

  • 按 Tab 键循环切换主要模式
  • 使用配置的快捷键直接访问
  • 模式在会话中保持不变，直到更改
Agents模型