OpenCode - Hostlinku Docs

OpenCode 采用了 AI SDK，因此任何与 OpenAI 兼容的提供商均可通过 opencode.json 进行添加。凭据由 /connect 命令单独存储。

配置选项

环境变量中的API密钥（不含/connect）：

{
  "provider": {
    "hostlinku": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hostlinku",
      "options": {
        "baseURL": "https://api.hostlinku.com/v1",
        "apiKey": "{env:HOSTLINKU_API_KEY}"
      }
    }
  }
}

通过 Responses API - 将 npm 替换为 @ai-sdk/openai；OpenCode 将使用 /v1/responses。适用于需要 推理摘要 的 GPT-5.x 模型。对于大多数用户而言，@ai-sdk/openai-compatible (Chat Completions) 已经足够。

故障排除

服务提供商未出现在 /models 中 - /connect 和 opencode.json 中的 ID 不一致，或者 JSON 格式无效。请检查 opencode auth list。
401 - 该 ID 的密钥尚未保存；请重试 /connect。
404 model_not_found - models的密钥必须与GET /v1/models的密钥完全一致。