模式

{
  "$schema": "https://opencode.ai/config.json",
  "mode": {
    "build": {
      "model": "anthropic/claude-sonnet-4-20250514",
      "prompt": "{file:./prompts/build.txt}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      }
    }
  }
}

Markdown 設定

您還可以使用 Markdown 檔案定義模式。將檔案放置在以下位置：

全域：~/.config/opencode/modes/
專案：.opencode/modes/

---
model: anthropic/claude-sonnet-4-20250514
temperature: 0.1
tools:
  write: false
  edit: false
  bash: false
---

You are in code review mode. Focus on:

- Code quality and best practices
- Potential bugs and edge cases
- Performance implications
- Security considerations

Provide constructive feedback without making direct changes.

Markdown 檔案名稱即為模式名稱（例如，review.md 建立一個名為 review 的模式）。

下面讓我們詳細了解這些設定選項。

模型

使用 model 設定可以覆寫該模式的預設模型。這對於針對不同任務使用不同模型非常有用。例如，規劃時使用更快的模型，實作時使用更強大的模型。

{
  "mode": {
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514"
    }
  }
}

溫度

使用 temperature 設定控制 AI 回應的隨機性和創造性。較低的值使回應更加集中和確定性，較高的值則增加創造性和多樣性。

{
  "mode": {
    "plan": {
      "temperature": 0.1
    },
    "creative": {
      "temperature": 0.8
    }
  }
}

溫度值的範圍通常為 0.0 到 1.0：

0.0-0.2：非常集中且確定性高的回應，適合程式碼分析和規劃
0.3-0.5：兼顧穩定性與創造力的平衡型回應，適合一般開發任務
0.6-1.0：更具創造性和多樣性的回應，適合腦力激盪和探索性工作

{
  "mode": {
    "analyze": {
      "temperature": 0.1,
      "prompt": "{file:./prompts/analysis.txt}"
    },
    "build": {
      "temperature": 0.3
    },
    "brainstorm": {
      "temperature": 0.7,
      "prompt": "{file:./prompts/creative.txt}"
    }
  }
}

如果未指定溫度，opencode 將使用模型特定的預設值（大多數模型通常為 0，Qwen 模型為 0.55）。

提示詞

使用 prompt 設定為模式指定自訂系統提示詞檔案。提示詞檔案應包含針對該模式用途的具體指令。

{
  "mode": {
    "review": {
      "prompt": "{file:./prompts/code-review.txt}"
    }
  }
}

此路徑相對於設定檔所在位置。因此，全域 opencode 設定和專案特定設定均可使用。

工具

使用 tools 設定控制該模式下可用的工具。您可以將特定工具設定為 true 或 false 來啟用或停用它們。

{
  "mode": {
    "readonly": {
      "tools": {
        "write": false,
        "edit": false,
        "bash": false,
        "read": true,
        "grep": true,
        "glob": true
      }
    }
  }
}

如果未指定任何工具，則預設啟用所有工具。

可用工具

以下是所有可透過模式設定控制的工具。

工具	描述
`bash`	執行 shell 指令
`edit`	修改現有檔案
`write`	建立新檔案
`read`	讀取檔案內容
`grep`	搜尋檔案內容
`glob`	按模式尋找檔案
`list`	列出目錄內容
`patch`	對檔案套用補丁
`todowrite`	管理待辦事項清單
`todoread`	讀取待辦事項清單
`webfetch`	擷取網頁內容

自訂模式

您可以透過在設定中新增自訂模式來建立自己的模式。以下是兩種方式的範例：

使用 JSON 設定

{
  "$schema": "https://opencode.ai/config.json",
  "mode": {
    "docs": {
      "prompt": "{file:./prompts/documentation.txt}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": false,
        "read": true,
        "grep": true,
        "glob": true
      }
    }
  }
}

使用 Markdown 檔案

在 .opencode/modes/ 中建立專案特定的模式檔案，或在 ~/.config/opencode/modes/ 中建立全域模式檔案：

---
temperature: 0.1
tools:
  bash: true
  read: true
  grep: true
  write: false
  edit: false
---

You are in debug mode. Your primary goal is to help investigate and diagnose issues.

Focus on:

- Understanding the problem through careful analysis
- Using bash commands to inspect system state
- Reading relevant files and logs
- Searching for patterns and anomalies
- Providing clear explanations of findings

Do not make any changes to files. Only investigate and report.

---
model: anthropic/claude-sonnet-4-20250514
temperature: 0.2
tools:
  edit: true
  read: true
  grep: true
  glob: true
---

You are in refactoring mode. Focus on improving code quality without changing functionality.

Priorities:

- Improve code readability and maintainability
- Apply consistent naming conventions
- Reduce code duplication
- Optimize performance where appropriate
- Ensure all tests continue to pass

使用情境

以下是不同模式的一些常見使用情境。

Build 模式：啟用所有工具的完整開發工作
Plan 模式：分析和規劃，不做任何更改
Review 模式：使用唯讀存取權限加文件工具進行程式碼審查
Debug 模式：啟用 bash 和讀取工具，專注於問題排查
Docs 模式：支援檔案操作但不支援系統指令的文件編寫

您可能還會發現不同的模型適用於不同的使用情境。