Claude Code + CC Switch + Cherry Studio 多模型API调用配置指南。

[fishlitte]

🚀 Claude Code + CC Switch + Cherry Studio 多模型调用配置指南

本指南将详细介绍如何通过 CC Switch 配置管理工具，配合 Cherry Studio 的本地 API 服务，实现让 Claude Code 调用 DeepSeek, GLM 等任意厂商模型的目的。

🧠 核心原理

1. Cherry Studio: 扮演“模型聚合器”和“API 转换器”的角色。它在本地启动一个服务，将内部的 DeepSeek、OpenAI 等模型，统一转换为 Claude Code 可以识别的格式。
2. CC Switch: 扮演“配置管理器”的角色。它负责将 Claude Code 的 API 请求，导向 Cherry Studio 的本地服务，并管理所有复杂的配置。

🛠️ 第一部分：前置准备

在开始之前，请确保你的系统已满足以下条件：

1. 安装 Node.js：CC Switch 和 Claude Code 依赖 Node.js 环境。在终端输入 node --version，如显示版本号（如 v18.x）则已安装。如未安装，请访问 nodejs.org 下载安装。
2. 安装 Claude Code：在终端执行以下命令进行全局安装：

   npm install -g @anthropic-ai/claude-code

   ⚠️ 注意：如果你之前已安装 Claude Code 并登录了官方账号，请在终端执行 claude /logout 退出登录，以避免与后续的 API 配置冲突。

🔧 第二部分：配置 Cherry Studio（后端服务）

1. 添加 API 提供商：打开 Cherry Studio，进入 设置 -> 模型服务。在这里，添加并配置你想使用的所有模型厂商（如 DeepSeek, OpenAI, 智谱等）的 API Key。

2. 启动 API 服务：为了让外部程序（如 CC Switch）能够调用 Cherry Studio，需要启动其内置的 API 服务器。

   • 在 Cherry Studio 主界面，通过命令行启动服务，指定你想要的端口和 API 密钥：

   cherry-studio start --port 23333 --api-key your-secret-key

   参数说明：

   • --port 23333: 将服务端口设为 23333（可自定义，但需与后续步骤保持一致）。
   • --api-key your-secret-key: 设置一个 API 访问密钥，请务必记住此密钥。

   2.1. 或者在应用中进行配置

3. 验证服务状态：服务启动后，打开浏览器访问 http://127.0.0.1:23333/api-docs。如果能正常打开 Swagger API 文档页面，说明服务已成功运行。

🎛️ 第三部分：配置 CC Switch（前端管理器）

1. 安装 CC Switch：前往 CC Switch 的官方 GitHub 仓库：https://github.com/farion1231/cc-switch，在 Releases 页面下载适合你操作系统的安装包。
2. 添加 Cherry Studio 配置：
   • 打开 CC Switch，选择左侧的 "Claude Code" 选项卡。
   • 点击右上角的 "+" 按钮，创建一个新的提供商配置。
   • 在弹出的窗口中，填写以下信息：
     • 提供商名称：自定义，如 Cherry-Studio-Local。
     • API Base URL：http://127.0.0.1:23333（端口号必须与 Cherry Studio 设置的一致，且末尾没有斜杠）。
     • API Key：填入在 Cherry Studio 中设置的 your-secret-key。
3. 🛜 关键设置：切换 API 格式与开启代理
   在添加或编辑提供商时，找到以下两个关键配置项：
   • API 格式 (API Format): 从下拉菜单中选择 OpenAI Chat Completions。
   • 本地代理 (Proxy): 在 CC Switch 主界面的顶部，找到 "Proxy" 开关并将其 开启。
   • 为什么要这样做？因为 Cherry Studio 的本地服务遵循 OpenAI 的 API 格式，所以必须通过这两步设置，让 CC Switch 将 Claude Code 的原生请求格式转换后，再发给 Cherry Studio。
4. 指定模型并启用：
   • 在配置窗口下方的 "模型列表" 中，填入你希望在 Cherry Studio 中使用的具体模型 ID（例如 deepseek-chat 或 glm-4.7）。
   • 点击 "添加" 保存配置，然后在提供商列表中，点击你刚创建的配置，使其成为 "当前使用" 状态。
   • 在cc switch中模型配置界面，需要配置供应商:模型名，例如：deepseek:deepseek-chat

---

🐛 常见问题与排错 (FAQ)

• Q: CC Switch 提示连接失败或 404 错误？

  • A: 请检查 API Base URL 是否以 /v1 结尾。如错误提示为 404，可尝试在 CC Switch 设置中切换 “API 格式” 选项。

• Q: 启动 Claude Code 后报错 Connection refused？

  • A: 确保 Cherry Studio 的 API 服务正在运行。检查 cherry-studio start 命令的终端窗口是否被关闭，并确认 CC Switch 中填写的端口号与启动时指定的端口一致。

• Q: 启动 Claude Code 后报错 Unauthorized？

  • A: 确认 CC Switch 中填写的 API Key 与 Cherry Studio 启动命令中的 --api-key 参数值完全一致。

• Q: 启动 Claude Code 后，模型响应错误或不符合预期？

  • A: 请检查你在 CC Switch 中填写的“模型名称”（如 deepseek-chat），是否与 Cherry Studio 中该厂商支持的模型 ID 完全一致。可以通过curl -H "你的授权头" http://127.0.0.1:23333/v1/models进行查询。