Claude Desktop

Claude Desktop 可通过配置文件或代理方式接入兼容 API。不同版本配置方式会变动，本页采用通用思路：把客户端请求导向 FreeDom API。

统一接入信息

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

一、适用场景

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

二、安装 / 准备

1. 安装 Claude Desktop。
2. 确认当前版本是否支持自定义 API 端点，或通过代理/环境变量转发。
3. 先确保平台 Key 可在其他工具中正常调用。

三、配置接入

如果版本支持环境变量，可尝试：

export ANTHROPIC_AUTH_TOKEN="你的_API_Key"
export ANTHROPIC_BASE_URL="https://api.yonghu.shop"

如果使用第三方代理层，请在代理层填写：

• Anthropic Base URL：https://api.yonghu.shop
• API Key：你的 FreeDom API Key

四、启动验证

重启 Claude Desktop 后发送一句测试问题，例如：

请回复 ok

能正常返回即代表链路打通。

五、推荐模型填写方式

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

• 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

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

七、实用建议

Claude Desktop 官方版本对自定义端点支持会随版本变化。若直接配置无效，建议用支持自定义 Provider 的工具（Claude Code、Cursor、RooCode）优先接入。

配置前检查

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

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 控制台查看日志，确认请求确实打到了平台。

Claude Desktop 成功判据

Claude Desktop 主要看它是否能通过你配置的代理或兼容端点正常发起请求。成功判据：

• 客户端不再提示鉴权失败。
• FreeDom API 控制台日志出现对应模型请求。
• 返回内容不是空白或网络错误。

如果 Desktop 本身不支持直接填 Base URL，需要通过支持 Claude / OpenAI 兼容协议的本地代理或插件转接。