建立 2026-09-15 更新 2026-09-15

設定檔

opencode.json（或 opencode.jsonc，可寫註解）控制 server／runtime：模型、權限、MCP、agent。TUI 主題與快捷鍵請寫在 tui.json。

Schema 在 opencode.ai/config.json。

放哪裡、誰蓋過誰

由早到晚合併，後面蓋前面：

1. 組織遠端設定（.well-known/opencode）
2. 全域：~/.config/opencode/opencode.json
3. OPENCODE_CONFIG 指定的檔案
4. 專案根目錄的 opencode.json
5. .opencode/（agents、commands、plugins、skills）
6. OPENCODE_CONFIG_CONTENT 內嵌 JSON
7. 系統管理員／MDM 管理的設定（優先權最高，使用者改不掉）

個人習慣（預設模型、權限）放全域；這個 repo 才需要的 MCP、agent 放專案檔並提交 Git。

.opencode/ 與 ~/.config/opencode/ 底下用複數目錄名：agents/、commands/、skills/、plugins/、themes/。單數舊名仍能用。

最小例子

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5",
  "permission": {
    "edit": "ask",
    "bash": {
      "*": "ask",
      "git status*": "allow"
    }
  }
}

model 格式是 provider/model-id。用 Zen 時前綴為 opencode/，例如 opencode/claude-sonnet-4-5。可用 opencode models 查正確名稱。

權限值：

• allow：直接執行
• ask：先問你
• deny：停用該工具

edit、bash、skill 等可對 glob 細分。Build 預設較開放，Plan 較保守；可依 agent 覆寫，見 Agents。

還能設什麼

完整說明見 官方 Config。