跳转到内容

OpenCode:手动配置

OpenCode 可通过自定义 OpenAI 兼容 Provider 接入 HCAI。示例中的 gpt-5.5 仅作为模型名称占位,请替换为当前密钥分组可用的模型。

接入信息

项目内容
OpenAI 兼容接入地址https://ai.hctopup.com/v1
Provider IDhcai
示例模型gpt-5.5
API Key使用 HCAI 平台创建的 Key

保存凭证

推荐在终端运行:

sh
opencode auth login

选择自定义或 Other Provider,Provider ID 填写:

txt
hcai

然后粘贴您的 HCAI Key。

如果需要手动写入,可创建 ~/.local/share/opencode/auth.json

json
{
  "hcai": {
    "type": "api",
    "key": "替换为您的 HCAI Key"
  }
}

配置 Provider

可以在项目根目录创建 opencode.json,也可以创建全局配置 ~/.config/opencode/opencode.json

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "hcai/gpt-5.5",
  "provider": {
    "hcai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "HCAI",
      "options": {
        "baseURL": "https://ai.hctopup.com/v1"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5"
        }
      }
    }
  }
}

启动 OpenCode

sh
cd /path/to/your/project
opencode

进入 TUI 后可以运行:

txt
/models

确认列表中出现 HCAI Provider 和配置的模型。

下一步