CodeBuddy

CodeBuddy 通常作为 IDE 插件使用，配置重点是 API 地址、Key、模型名。

统一接入信息

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

一、适用场景

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

二、安装 / 准备

安装插件后重启 IDE，打开插件设置。

三、配置接入

配置字段可能叫法不同：

• API Host / Endpoint / Base URL：https://api.yonghu.shop
• Token / API Key：你的平台 Key
• Model：平台模型名

如果插件区分 Chat Model 与 Completion Model，建议先填同一个稳定模型。

四、启动验证

在 IDE 中选择一段代码，让 CodeBuddy 解释或重构。

五、推荐模型填写方式

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

• 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

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

七、实用建议

如果补全慢，先换轻量模型；如果回答质量不足，再切高性能模型。

配置前检查

配置客户端前，先确认平台在线：

curl https://api.yonghu.shop/api/status

看到 success: true 或 HTTP 200，说明平台主入口正常。

如果客户端配置失败，优先按这个顺序排查：

1. API Key 是否复制完整，没有多余空格。
2. Base URL 是否该带 /v1。
3. 模型名是否与平台模型广场完全一致。
4. 当前 API Key 是否有该模型权限。
5. 余额是否充足。

成功后建议到 FreeDom API 控制台查看日志，确认请求确实打到了平台。

CodeBuddy 成功判据

CodeBuddy 接入时重点看是否支持自定义 OpenAI endpoint。

推荐：

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

若请求路径报错，改用 https://api.yonghu.shop/v1。如果工具固定只支持原厂账号登录，则无法直接填写自定义 API，需要使用支持自定义接口的插件或代理转接。