OpenCode 配置
OpenCode 是终端中的开源编码 Agent，适合在项目目录中阅读代码、修改文件和执行开发任务。完成 OpenCode 的安装和登录后，可以通过 provider 向导接入 yuyuflow。
前置条件
本页不重复列出安装命令；请以 OpenCode 官方文档和当前版本提示为准。
通过 provider 连接
在 OpenCode 的输入框中执行：
text
/connect随后按向导完成：
- 选择或搜索与当前平台对应的 provider。
- 输入 yuyuflow API Key。
- 选择控制台中可用的模型，例如主模型或快速模型。
- 保存配置并返回项目会话。
如果当前版本没有预置 yuyuflow provider，请查看向导是否支持自定义 provider。参考页面没有公开 OpenCode 当前版本的底层配置文件路径、字段名或环境变量名，不建议自行猜测 opencode.json、base_url 或 apiKey 等字段。
模型和地址
OpenCode 的 provider 向导可能会根据版本自动管理请求地址和协议。请以客户端显示的配置项为准：
| 配置项 | 建议填写内容 |
|---|---|
| Provider | yuyuflow 或客户端提供的对应 provider |
| API Key | 控制台创建的专用 API Key |
| Model | 控制台显示的完整模型 ID |
| Base URL / Endpoint | 如果向导要求填写，使用 https://art-api.yuyuflow.com 或控制台提供的兼容地址 |
不要把 Codex 的 Responses API 配置或 Claude Code 的 Claude 兼容地址直接复制到 OpenCode。若客户端明确要求 Chat Completions 或其他协议，应以该客户端当前版本的说明为准。
验证连接
在项目目录启动 OpenCode：
text
opencode发送一个简单请求，例如让 Agent 列出当前项目的根目录文件。确认能够返回内容后，再尝试读取一个源文件或执行低风险的代码检查。
如果客户端提供 provider 或 model 查看命令，确认当前选中的 provider 和模型与预期一致。
常见问题
`/connect` 中找不到平台
先升级 OpenCode 到建议版本，检查当前版本是否支持自定义 provider。不要把其他工具的配置文件直接复制到 OpenCode。
鉴权失败或返回 `401`
确认使用的是当前平台创建的 API Key，密钥没有过期或多余空格，并确认 provider 的 API 地址没有指向旧环境。
模型不可用或返回 `404`
使用控制台中的完整模型 ID，不要使用展示名称或别名；同时确认该模型已加入当前账号的令牌分组。
请求协议错误
检查 OpenCode 当前 provider 需要的协议，再确认地址与协议匹配。Responses、Chat Completions 和 Claude 兼容接口不能互换。
不知道应修改哪个配置文件
DeepSeek 参考页面只给出了 /connect 和 provider 配置流程，没有确认 OpenCode 当前版本的配置文件 schema。优先使用客户端向导和官方文档，不要根据其他客户端经验创建配置文件。
下一步可阅读 Agent 工具总览、LLM 配置、CC-Switch 配置 或 WorkBuddy / CodeBuddy 配置。