返回文档首页

OpenCode 接入

OpenCode 使用自己的 Provider 配置,不会自动读取 Codex 的本机配置。你需要在 OpenCode 中单独添加 qimoq Provider。

配置项

项目填写建议
Provider 类型OpenAI Compatible 或 Custom Provider
Base URL/v1
API Keyqimoq API Key
Model从「模型广场」复制模型 ID
名称建议写 qimoq,方便和其它 Provider 区分

如果 OpenCode 同时配置多个 Provider,请确认当前会话选中的是 qimoq。

配置步骤

  1. 打开 OpenCode 设置或 Provider 管理界面。
  2. 新增 OpenAI Compatible Provider。
  3. Base URL 填写 /v1
  4. API Key 填写完整 qimoq Key。
  5. 模型填入「模型广场」复制的模型 ID。
  6. 保存后重新开启一个会话测试。

如果 OpenCode 要求在配置文件中填写 Provider,也可以参考 手动配置模板

模型选择

场景建议
代码生成选择 GPT / Codex 类模型
快速问答选择低延迟模型
长上下文任务选择上下文窗口足够的模型
成本敏感任务先设置 Key 额度限制,再测试模型

OpenCode 的模型列表可能不会自动同步 qimoq。看不到模型时,可以手动填写模型 ID。

排查

现象处理
请求走错 Provider在当前会话里重新选择 qimoq Provider
Base URL 报错检查是否重复拼接 /v1
模型列表为空手动填写模型 ID,不依赖自动拉取
费用不符合预期查看「使用日志」确认实际模型和 Token