详解公益站API接入Cherry Studio、CLIProxyAPI及CCS配置指南

背景

随着生成式 AI 技术的普及，大语言模型（LLM）的调用成本成为许多个人开发者和爱好者关注的重点。为了降低使用门槛，社区中涌现出大量“公益站”（即提供免费或低成本 API 服务的平台）。然而，对于普通用户而言，如何将这些公益站的 API 接入到主流 AI 客户端或开发工具中，往往存在信息差和操作壁垒。

本文源自 LINUX DO 社区，旨在解决这一痛点。文章详细拆解了公益站的核心配置参数（Base URL 和 API Key），并针对三种典型的使用场景——桌面端客户端（Cherry Studio）、自建代理平台（CLIProxyAPI）以及特定工具组合（CCS + Codex），提供了具体的配置指南和避坑建议。

核心内容

1. 公益站的核心配置逻辑

无论使用何种软件，接入公益站的基础均依赖于两个关键参数：

• Base URL：公益站的域名根路径，通常需拼接 /v1 后缀（例如：https://XXXXXX.xyz/v1）。
• API Key：API 访问密钥。用户需在公益站侧边栏通过“创建令牌”获取。
  • 注意：部分公益站在创建令牌时需选择“分组”。用户需前往“模型广场 - 可用令牌分组”查看该分组下对应的可用模型，确保令牌权限与所需模型匹配。

2. 场景一：桌面端客户端使用（以 Cherry Studio 为例）

Cherry Studio 是一款支持多模型、支持图像生成的桌面客户端，适合新手试用。

• 聊天模型接入：
  1. 进入 设置 -> 模型服务 -> 添加。
  2. 填写名称（任意），类型选择 OpenAI。
  3. 点击确定后填写配置：输入上述 Base URL 和 API Key。
  4. 点击“获取模型列表”以验证连接。
• 图像生成接入：
  1. 进入 设置 -> 模型服务 -> 添加。
  2. 填写名称（任意），类型选择 New API。
  3. 获取模型列表后，找到类似 gpt-image-2 的模型，点击其后的设置。
  4. 将端点类型设置为 图像生成 (OpenAI)。
  5. 配置 Base URL 和 API Key。

3. 场景二：自建代理平台（CLIProxyAPI）

对于需要管理大量账号或避免频繁重启 Codex 的用户，建议搭建私有代理层。CLIProxyAPI 是一个 GitHub 开源项目，旨在将 Gemini CLI、Antigravity、ChatGPT Codex、Claude Code、Grok 等封装为 OpenAI/Gemini/Claude/Codex 兼容的 API 服务。

• 部署优势：允许用户在一个平台内管理大量账号和公益站资源，避免直接调用公益站导致的限制或需频繁重启的问题。
• 配置路径：在部署后的界面中，进入 AI提供商 -> OpenAI 兼容提供商 -> 添加供应商。
• 填写配置：
  • 提供商名称：任意填写。
  • 优先级：数值越大优先级越高（可选）。
  • Base URL：公益站的 Base URL。
  • API Key：公益站的 API Key。
  • 配置完成后，点击“获取模型”即可同步公益站支持的模型列表。

4. 场景三：CCS 与 Codex 组合使用

通过 CCS（CC Switch，GitHub 项目 farion1231/cc-switch）作为中间件，可以更灵活地调用 Codex 等工具。

• 配置步骤：
  1. 启动 CCS，点击 OpenAI 图标 -> + -> 添加新供应商 -> 选择 Codex 供应商。
  2. 进入自定义配置，填入公益站的 API Key 和 API 请求地址（Base URL）。
  3. 模型名称：若“获取列表”功能失败，需手动前往公益站查看支持的模型名称并手动复制填入。
  4. 其他选项按需选填，添加后点击“使用”。
• 重要限制：Codex 不支持热重载（Hot Reload）。每次切换供应商配置后，必须重启 CCS 才能生效。若供应商名称相同的配置，则无需重启。首次使用务必重启。

关键要点

• 参数标准化：公益站接入的核心是 Base URL（通常含 /v1）和 API Key，这是所有客户端配置的通用基础。
• 令牌分组机制：创建 API Key 时务必注意“分组”设置，不同分组对应不同的模型权限，需在“模型广场”中确认。
• 工具选型建议：
  • 新手/日常使用：推荐 Cherry Studio，界面友好，支持聊天和绘图，配置简单。
  • 高阶/批量管理：推荐 CLIProxyAPI，适合需要管理多账号、高并发或避免直接暴露公益站限制的场景。
  • 特定工具调用：若需使用 Codex 等特定 CLI 工具，可使用 CCS 进行中转，但需注意其不支持热重载的限制。
• 避坑指南：
  • 在 CCS 中若无法自动获取模型列表，请手动输入公益站支持的模型名称。
  • 公益站资源有限，建议不要随意转发 API Key 给他人使用，以免被封禁或耗尽配额。
  • 图像生成模型在 Cherry Studio 中需单独配置为 New API 类型并指定端点类型为图像生成。

意义与影响

这篇文章不仅是一份操作指南，更揭示了当前 AI 生态中“去中心化”访问的趋势。通过公益站和自建代理（如 CLIProxyAPI），个人用户能够以极低的成本获取原本昂贵的大模型服务（如 GPT-5.5、Claude、Gemini 3.1 Pro 等）。

对于开发者而言，理解 Base URL 和 API Key 的标准化接口（OpenAI 兼容协议）是构建自定义 AI 工作流的关键。文章提供的三种方案覆盖了从“开箱即用”到“高度定制”的不同需求层级，降低了技术门槛，使得更多非专业用户也能参与到 AI 工具的深度使用中。同时，强调“不要转发公益站资源”也提醒了社区用户注意资源伦理，维护公益站的可持续运行。