Source: https://aiprimetech.io/zh/learn/use-claude-api-with-cherry-studio/ [首页](/zh/) / [学习](/zh/learn/) / 将 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: # 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 密钥](/register) AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。 ## 更多 Claude API 指南 [如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[使用 Claude 运行 Codex CLI](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)