OpenCode

OpenCode 适合喜欢终端工作流或自托管工具链的用户。通常可通过 OpenAI 兼容配置接入。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

一、适用场景

• 想把 OpenCode 的模型请求接到 FreeDom API
• 已经有平台 API Key
• 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备

安装 OpenCode 后，查找 provider 配置文件或环境变量说明。

三、配置接入

常见配置：

export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"

如支持配置文件，可写入：

{
  "baseURL": "https://api.yonghu.shop",
  "apiKey": "你的_API_Key",
  "model": "平台模型名"
}

四、启动验证

启动 OpenCode 后，发起一次小型代码解释或生成任务。

五、推荐模型填写方式

优先使用控制台里真实展示的模型名。常见可尝试：

• Claude：claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
• Gemini：gemini-2.5-pro、gemini-2.5-flash
• OpenAI 兼容工具：按平台模型广场/控制台展示为准

六、常见问题

401 Unauthorized

API Key 错误、没保存成功，或请求头没有带上密钥。

403 Forbidden

通常是余额不足、Key 没有权限、模型未开放，或服务返回拒绝。

404 Model Not Found

模型名写错，或者当前 Key 没有这个模型权限。

429 Too Many Requests

请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。

七、实用建议

OpenCode 适合长期使用，建议单独创建一个名为 opencode-* 的 Key，便于统计消耗。

OpenCode 成熟资料归纳

参考资料中，OpenCode 接入 FreeDom API通常围绕 OpenAI Compatible Provider 展开。常见配置思路是创建或修改 opencode.json，把自定义服务商写进去。

示例模板：

{
  "provider": {
    "freedom-api": {
      "name": "FreeDom API",
      "api": "openai",
      "baseURL": "https://api.yonghu.shop/v1",
      "apiKey": "你的_API_Key",
      "models": {
        "平台模型名": {
          "name": "平台模型名"
        }
      }
    }
  }
}

如果当前 OpenCode 版本不接受 baseURL，请在设置向导里选择自定义 OpenAI 兼容服务商，然后填写：

Base URL: https://api.yonghu.shop/v1
API Key: 你的 FreeDom API Key
Model: 平台模型名

WARNING

部分 OpenCode / Codex 类工具会优先调用 Responses API。若报 responses unsupported 或兼容性错误，先切回 Chat Completions 路线，或选择支持 /v1/chat/completions 的模型/工具模式。

更多依据见：参考资料。