Cherry Studio 中的 Claude。两个樱桃状的小型对话节点通过弯曲的果梗连接到一个整洁的模型选择窗口。

将 Cherry Studio 连接到 Claude

Cherry Studio 是一款简洁的桌面客户端，可与多种模型聊天，并直接支持 Anthropic 原生格式。将 AI Prime Tech 网关添加为 Anthropic 类型的提供商后，你就能在同一窗口中使用 Claude 和其他模型，只需一个主机地址和一个密钥。

打开模型服务

前往设置并打开模型服务。Cherry Studio 在这里列出所有可连接的提供商，你也可以在这里添加新的提供商。点击加号添加提供商，随后系统会要求你选择其类型。

选择类型很重要，因为它决定了通信格式。要通过网关使用 Claude，应选择 Anthropic 类型，它对接原生 /v1/messages 接口，而不是 OpenAI 风格的端点。

Cherry Studio 以列表形式管理提供商，因此网关会与你配置的其他服务并列，你可以为每个对话切换提供商。这使它非常适合多模型网关：一个提供商条目可以包含多个 Claude 模型，你可以根据需要从菜单中选择。将网关作为多个条目中的一个，正是 Cherry Studio 能够成为易用的多模型控制台的原因。你可以针对每个对话切换提供商，无需离开应用。

选择 Anthropic 类型

选择 Anthropic 作为提供商类型并启用。随后，Cherry Studio 会显示两个决定连接配置的字段：API 密钥和 API 主机。将网关密钥粘贴到密钥字段中。

由于类型是原生 Anthropic，Cherry Studio 会以网关为 Claude 提供的 Messages 格式发送请求。设置类型后，无需再操心单独的协议开关。

如果网关还为其他模型提供 OpenAI 兼容接口，应将它们添加为单独的 OpenAI 类型提供商，而不是混入当前条目。让 Anthropic 类型的条目专用于 Claude，可以明确通信格式，避免跨协议混淆。将不同协议放在独立的提供商条目中，是一个简单的习惯，却能避免后续大量混淆。这样，每个条目都只需考虑一种通信格式。

正确设置 API 主机

API 主机是最容易填错的字段。只输入主机根地址，末尾不要加 /v1，因为 Cherry Studio 会自行追加版本路径。手动添加 /v1 会导致路径重复，请求失败。

因此，这个值就是网关主机地址。如果添加提供商后遇到 404 错误或路径错误，原因几乎总是 API 主机中多余的 /v1。

主机地址末尾的斜杠也会导致同类问题，因此请只输入主机地址，不要在其后添加任何内容。请求失败时，最快的诊断方法是重新检查 API 主机字段，先去掉主机名之后的所有内容，再排查其他位置。发生故障时，先检查这一个字段，通常就能当场解决大多数配置问题。你需要的是不带任何后缀的主机地址。

用末尾井号锁定地址

Cherry Studio 支持一个小而重要的技巧：在 API 主机末尾加上 #，客户端就会原样使用该 URL，不再追加任何内容。当自动追加机制造成干扰时，可以用这种方式强制指定精确的端点。

对于标准网关，通常只需填写主机地址，让 Cherry Studio 自动追加路径。只有当网关要求精确路径，而自动追加会破坏该路径时，才使用 #。

# 值得记住，恰恰是因为它并不直观——对于路径不符合 Cherry Studio 默认假设的网关，它提供了一种应对方法。如果你发现自动追加的 /v1/messages 与网关要求不一致，# 可以让你手动写出完整 URL。现在记住这个 # 技巧，将来路径不匹配时就能立即想到解决方法。这一个覆盖机制就能处理任何非标准网关路径。

选择模型并开始聊天

在提供商下添加你需要的 Claude 模型，使用网关提供的 ID，例如用 claude-sonnet-4-5 处理日常聊天，用 claude-opus-4-8 处理更复杂的推理。随后，它们会出现在 Cherry Studio 的模型菜单中。

开始一个对话，从菜单中选择 Claude 模型，即可与网关通信。由于提供商使用原生 Anthropic 格式，依赖 Messages 格式的功能会按预期运行。

你可以同时打开多个对话，分别使用不同的 Claude 模型，便于比较 Sonnet 和 Opus 对同一提示词的处理方式。由于它们都通过同一个网关提供商运行，切换模型只需在菜单中选择，无需重新配置。通过单个提供商运行所有模型的一个小乐趣，就是并排比较模型。对同一提示词分别使用 Sonnet 和 Opus，只需切换一次菜单。

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

常见问题

如何将 Claude 添加到 Cherry Studio？

打开设置、模型服务，点击添加，选择 Anthropic 类型，粘贴密钥，并将 API 主机设置为 https://aiprimetech.io（根地址，不带 /v1）。

API 主机应包含 /v1 吗？

不应包含。使用主机根地址；Cherry Studio 会自行追加版本路径。手动添加 /v1 会导致路径重复并使请求失败。

末尾的 # 有什么作用？

它会锁定精确的 URL——Cherry Studio 原样使用主机地址，不追加任何内容。仅在需要精确路径时使用。

Claude 应选择哪种提供商类型？

Anthropic。它对接网关为 Claude 提供的原生 /v1/messages 接口。

几分钟内开始使用 Claude

获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。

获取你的 API 密钥

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。