手动配置

手动接入 BotCF 所需的地址、分组与鉴权信息。

如果你是第一次使用，推荐使用一键配置(点击)

1. 先拿到 Key

  1. 打开 https://botcf.com 注册或登录。
  2. 进入控制台创建一个新的 API Key。
  3. 记下你准备使用的模型名称。

2. 记住这两个地址

  • OpenAI 兼容 Base URL：https://botcf.com/v1
  • Claude / Anthropic 兼容 Base URL：https://botcf.com

3. 先确认模型分组

当前推荐从这几组模型开始：

  • ⚓codex-plus：gpt-5.6、gpt-5.4
  • 😡Claude-Max：Claude Code 使用，推荐 claude-fable-5
  • 😡Claude-Max-外接：Cherry Studio 等第三方客户端使用

按设备和工具查看

工具 Windows Mac Linux VSCode JetBrains KiloCode / RooCode
Cherry Studio 桌面端接入 桌面端接入 桌面端接入 桌面端接入 桌面端接入 -
Claude Code Windows 教程 Mac 教程 Linux 教程 VSCode 教程 JetBrains 教程 使用教程
Codex Windows 教程 Mac 教程 Linux 教程 VSCode 教程 JetBrains 教程 -

常见问题

  • 401 或 invalid_api_key：通常是 Key 填错、复制时多了空格，或该 Key 已被禁用。
  • model_not_found：模型名称写错，或者该模型当前不在你的账户可用范围内。
  • Claude Code 请求失败但 GPT 正常：检查令牌是否可用 😡Claude-Max。
  • 第三方 Claude 客户端请求失败：检查令牌是否可用 😡Claude-Max-外接，不要误选仅限 Claude Code 的分组。
  • GPT 模型请求失败但 Claude 正常：先检查你的令牌是否真的可用 ⚓codex-plus 分组。
  • 客户端连不上：先确认你填的是正确的 Base URL，不同客户端不一定一样。
  • API Key 是否有效、目标模型是否在你当前账户可用范围内、客户端里填写的 Base URL 是否正确——遇到问题时先回到控制台检查这三件事。