一、配置文件基础

OpenCode 使用 JSON/JSONC 格式的配置文件 opencode.json。配置分为两层：全局配置和项目配置。

配置优先级

配置按以下顺序加载（后加载的覆盖前一个）：

1. 远程配置（企业组织默认）
2. 全局配置 ~/.config/opencode/opencode.json
3. 环境变量 OPENCODE_CONFIG
4. 项目配置 opencode.json
5. 内联配置 OPENCODE_CONFIG_CONTENT
6. 托管配置（管理员控制）

基本配置示例

jsonc { "schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4-5", "autoupdate": true, "server": { "port": 4096 } }

核心配置项

国内用户配置建议

对于国内用户，推荐使用 OpenCode Zen 或配置兼容的 API：

jsonc { "provider": { "opencode": { "options": { "apiKey": "{env:OPENCODE_API_KEY}" } } } }

配置文件的完整 schema 请参考 opencode.ai/config.json。