安装与准备
从 OpenCode 官方下载页安装当前版本,运行opencode --version 确认命令可用。
在启动 OpenCode 的终端设置密钥:
添加项目配置
在项目根目录创建opencode.json。已有文件时合并服务商配置,保留其他设置。将两处 YOUR_MODEL_ID 替换成同一个可用模型 ID。
vc/ 是 OpenCode 的服务商前缀,后半部分才是 VC 接口使用的模型 ID。配置不会将密钥写入项目文件。
选择模型
在项目目录运行opencode,输入 /models,选择 VC 下的模型,发送一个简单问题。然后尝试让它读取 README。
已有配置如何处理
VC 密钥使用说明也提供 OpenCode 配置。已有provider / options 格式的配置时,可以继续按其对应版本使用;上面的配置使用当前官方 providers / settings 格式。不要将两种结构混写在同一个服务商条目中。
常见问题
- 无法识别 providers 字段:更新 OpenCode,或使用密钥页面提供的对应版本配置。
- 模型列表没有 VC:检查项目文件名、JSON 格式、模型 ID 和
VC_API_KEY,重启 OpenCode。 - 模型能聊天但无法执行工具:选择支持工具调用的文本模型。