OpenCode Guide
OpenCode 如何配置 ZZSwitch API
OpenCode 支持自定义 provider 和 OpenAI 兼容接口。使用 ZZSwitch 时，通常把 baseURL 填成带 `/v1` 的 OpenAI 兼容地址，并用 ZZSwitch 令牌作为 API Key。
OpenAI 兼容 baseURL
https://api.zzswitch.com/v1
API Key 使用 ZZSwitch 令牌页面创建的 Token。模型名以控制台当前可用模型为准。
配置思路
OpenCode 的 provider 配置可以设置 baseURL 和 apiKey。ZZSwitch 作为 OpenAI 兼容入口时，baseURL 使用 https://api.zzswitch.com/v1，apiKey 建议通过环境变量引用，不要直接写进会提交的项目文件。
示例配置
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"zzswitch": {
"name": "ZZSwitch",
"npm": "@ai-sdk/openai-compatible",
"options": {
"baseURL": "https://api.zzswitch.com/v1",
"apiKey": "{env:ZZSWITCH_API_KEY}"
},
"models": {
"your-model-name": {
"name": "your-model-name"
}
}
}
},
"model": "zzswitch/your-model-name"
}模型名怎么填？
不同时间可用模型可能会变化，建议到 ZZSwitch 控制台查看当前模型列表和价格，再把对应模型名填入 OpenCode 配置。
验证方式
配置完成后，先用一个小任务验证能否正常返回。确认模型名、令牌和余额都正常后，再执行读取项目或多轮修改这类更高消耗任务。
成本提醒
OpenCode 这类编程 Agent 可能会连续调用模型。实际扣费取决于模型基础价格、分组/渠道倍率、输入输出 token 和上下文长度。