引言

默认配置只能让你「用起来」，而个性化配置才能让你「用得爽」。OpenCode 的配置系统既强大又灵活——从模型选择到快捷键，从权限控制到工具开关，几乎所有行为都可以定制。本文将带你深入理解 opencode.json 的每个核心配置项，掌握配置优先级规则，并分享一套实用的配置方案。

一、opencode.json 核心配置项

OpenCode 的配置文件采用 JSON 格式，通常命名为 opencode.json。一个完整的配置文件结构如下：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5",
  "theme": "opencode",
  "autoupdate": true,
  "default_agent": "build",
  "provider": {},
  "permission": {},
  "keybinds": {},
  "tui": {},
  "tools": {},
  "agent": {},
  "command": {},
  "mcp": {},
  "plugin": [],
  "instructions": [],
  "formatter": {}
}

1.1 模型配置

模型配置是整个系统的核心，决定了 AI 的「大脑」是谁。

{
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

• model：主模型，处理复杂任务（代码生成、重构、架构设计等）
• small_model：轻量模型，处理简单任务（自动补全、快速问答等）

选择 small_model 的好处是节省成本和提升响应速度。比如在日常开发中，大量的简单查询可以交给 Haiku，而复杂的代码审查才动用 Sonnet。

1.2 主题配置

OpenCode 内置了多款主题，也支持自定义主题文件。

{
  "theme": "opencode"
}

内置主题包括：opencode（默认）、dracula、nord、gruvbox、tokyonight 等。你也可以通过 --theme 命令行参数临时切换，或在配置中指定自定义主题文件路径。

1.3 快捷键配置

快捷键配置让你用键盘掌控一切。OpenCode 采用 Leader 键 机制，默认 Leader 键是 ctrl+x。