FreeDom API 文档

Appearance

参考资料 ​

本页整理维护文档时参考过的公开资料与可复用结论。外部资料只作为参考，最终以 FreeDom API 控制台和当前客户端版本为准。

一、Claude Code / Claude 兼容网关 ​

参考来源类型 ​

  • Claude Code 官方 LLM Gateway 文档
  • CSDN 多篇 Claude Code 自定义 API / 第三方 Base URL 配置教程
  • vLLM Claude Code 集成说明

归纳结论 ​

  1. Claude Code 可通过 LLM Gateway / 第三方网关接入。
  2. Claude 兼容网关需要支持 Anthropic Messages 格式：/v1/messages。
  3. ANTHROPIC_BASE_URL 通常填写基础域名，不一定带 /v1。
  4. 鉴权常见变量：ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY。
  5. 新版 Claude Code 支持网关模型发现：CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1。
  6. Windows 用户常见问题是环境变量没有刷新，需要重开终端。

FreeDom API 推荐：

bash
export ANTHROPIC_BASE_URL="https://api.yonghu.shop"
export ANTHROPIC_AUTH_TOKEN="你的_API_Key"
export ANTHROPIC_API_KEY="你的_API_Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

二、Cursor 自定义 API ​

参考来源类型 ​

  • CSDN Cursor 自定义 API / Base URL 教程
  • Cursor 中文文档/社区教程
  • Cursor 相关博客与论坛反馈

归纳结论 ​

  1. 常见路径：Settings → Models。
  2. 需要添加/启用自定义模型名。
  3. OpenAI API Key 填平台 Key。
  4. Override OpenAI Base URL 填API 地址。
  5. 公开资料多次提到：Override Base URL 可能影响同 Provider 下所有模型。
  6. Cursor 的 Tab Completion 等部分专用功能可能不走自定义 API Key。

FreeDom API 推荐：

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

如果不通，再尝试：

text
Override OpenAI Base URL: https://api.yonghu.shop/v1

三、RooCode ​

参考来源类型 ​

  • RooCode 官方 OpenAI Compatible Provider 文档
  • CSDN RooCode API Key 图文教程
  • SegmentFault / 掘金 / 中文镜像文档

归纳结论 ​

  1. RooCode 支持 OpenAI Compatible Provider。
  2. 关键字段：API Provider、Base URL、API Key、Model ID。
  3. 对自定义 API 平台，不要选固定厂商 Provider，优先选 OpenAI Compatible。
  4. RooCode 使用原生 OpenAI tool calling，模型要支持工具调用，否则普通聊天能通但 Agent 工具可能失败。
  5. 常见错误：Invalid API Key、Model not found、Base URL 错误。

FreeDom API 推荐：

text
API Provider: OpenAI Compatible
Base URL: https://api.yonghu.shop
API Key: 你的 FreeDom API Key
Model ID: 平台模型名

四、OpenCode ​

参考来源类型 ​

  • 博客园 OpenCode API 配置教程
  • Linux.do OpenCode 自定义服务商接入讨论
  • OpenCode 自定义 API 接入文章

归纳结论 ​

  1. OpenCode 常用配置文件为 opencode.json 或命令行 Provider 配置。
  2. 自定义 API 一般按 OpenAI Compatible 配置。
  3. 有些 OpenCode 版本或模型路线会调用 /v1/chat/completions，有些新工具会偏向 /v1/responses。
  4. 如果客户端的 Responses 接口不可用，建议优先使用 Chat Completions。

推荐先使用 OpenAI Compatible + Chat Completions 能力验证。

五、Qwen Code ​

参考来源类型 ​

  • Qwen Code 官方 API 配置指南
  • QwenLM/qwen-code GitHub 讨论
  • OpenAI-compatible API 说明

归纳结论 ​

  1. Qwen Code 可通过 API Key 与模型参数配置。
  2. 有公开讨论提到 OPENAI_BASE_URL 可用于 OpenAI 兼容服务。
  3. 模型名要以服务端实际支持为准，不要照搬官方固定模型名。

推荐：

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

六、OpenAI 兼容接口 ​

参考来源类型 ​

  • OpenAI 兼容接口相关说明
  • 自定义 API 接入教程
  • OpenAI 兼容客户端通用教程

归纳结论 ​

  1. OpenAI 兼容客户端通常需要：Base URL、API Key、Model。
  2. 常见路径：/v1/models、/v1/chat/completions、/v1/responses。
  3. Claude 兼容客户端通常走 /v1/messages。
  4. 如果根地址不通，尝试带 /v1；如果带 /v1 重复导致路径异常，则改回根地址。
  5. 模型名、Key 权限、余额是最常见的失败原因。

七、维护原则 ​

  • 不直接复制外部教程原文，只提炼可验证结论。
  • 对不确定的客户端版本差异，写成“尝试顺序”和“失败判据”。
  • 所有用户可执行命令不得包含真实 API Key。
  • 以 https://api.yonghu.shop/api/status 和控制台日志作为最终确认。

八、CC Switch ​

参考来源类型 ​

  • CC Switch 官方站 / GitHub 项目说明
  • CSDN、腾讯云、菜鸟教程、知乎、ofox、123AI 等第三方教程
  • Claude Code 官方 LLM Gateway 文档

归纳结论 ​

  1. 相关文档已经提供 CC Switch 应用页，支持从令牌管理页一键填入 CC Switch。
  2. 控制台支持配置 CC Switch 入口后，可在令牌下拉菜单中一键导入。
  3. CC Switch 用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具的 Provider 配置。
  4. 核心字段仍是 Base URL、API Key、模型名、协议类型。
  5. Claude Code / Anthropic 兼容通常填根地址 https://api.yonghu.shop。
  6. OpenAI Compatible 工具通常先试 https://api.yonghu.shop/v1。
  7. 启用 Provider 后要重开终端，避免旧环境变量残留。
  8. 健康检查成功后，还应到 FreeDom API 控制台确认日志。

FreeDom API 推荐把 CC Switch 放在第一入口，因为它比手动改环境变量更适合新用户。

FreeDom API - 稳定、灵活、高性价比的 AI API 中转平台

Copyright © 2026 FreeDom API