OpenCode

当前状态：待复验。本页给出 OpenCode 自定义 Provider 的准备性模板，不把配置文件格式或一次成功启动描述为生产集成结论。

前置条件

确认当前 OpenCode 版本仍支持自定义 Provider与 @ai-sdk/openai-compatible。
创建可撤销 API Key，优先通过本机安全环境变量或工具凭据机制保存。
从模型目录复制模型 ID；首次接入在隔离项目完成，避免编码代理直接读写生产仓库。

入口与计费方式

项目	本页范围
协议与入口	OpenAI 兼容通用余额：`https://tokenfactory.cn/api/v1`
鉴权	控制台 API Key，由受保护环境变量或工具凭据机制读取
权益	通用余额
不包含	Coding Plan、自动回退和多 Provider 路由

准确配置

按当前文档找到项目级或用户级 opencode.json，新增自定义 Provider。
使用 OpenAI 兼容客户端包，填写上表 Base URL，安全引用 API Key，并在 models 填入原始模型 ID。
启动后显式选择该 Provider 和模型；配置字段与环境变量语法以当前 OpenCode 文档为准。

json

{
  "provider": {
    "tokenfactory": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://tokenfactory.cn/api/v1",
        "apiKey": "{env:TOKENFACTORY_API_KEY}"
      },
      "models": { "<model-id>": { "name": "<model-id>" } }
    }
  }
}

验证

在不含敏感源码的读取或解释任务中确认 Provider 和模型选择实际生效，且没有回退到默认提供方。

故障排查

认证失败：检查环境变量是否对当前 OpenCode 进程可见，Key 是否被引号、换行或配置同步污染。
模型不可用：核对模型 ID 与通用余额入口，不猜测别名映射。
余额、限额、套餐或上游错误：按错误处理人工排查。

安全提示

编码代理可能读取大量工作区内容并多次请求模型。限制项目范围、审查权限并脱敏日志；流式或长任务中断后不应无条件重放。

更新信息

本页保持待复验。未来真实复验后仅在本页补充测试版本、验证日期、适用入口和已知限制。

OpenCode ​

前置条件 ​

入口与计费方式 ​

准确配置 ​

验证 ​

故障排查 ​

安全提示 ​

更新信息 ​