メインコンテンツへスキップ
更新日: 2026-06-23
Cherry Studio is a desktop AI client that works well for multi-model chat, research notes, and MCP-assisted workflows. When connecting it to Crazyrouter, the most reliable path is Cherry Studio’s custom OpenAI provider mode, because it usually gives you the cleanest model management, streaming, and general chat compatibility.

​
Overview

Using Cherry Studio’s custom provider support, you can add Crazyrouter as an OpenAI-compatible upstream:
  • Recommended protocol: OpenAI-compatible API
  • Recommended provider type: OpenAI
  • API URL: https://api.crazyrouter.com
  • Auth method: sk-... token
  • Recommended first validation model: gpt-5.5
Cherry Studio’s official docs explain that if the upstream endpoint is something like https://xxx.com/v1/chat/completions, you usually enter only the root URL in API URL. For Crazyrouter, start with https://api.crazyrouter.com, not https://api.crazyrouter.com/v1.
Cherry Studio appends the standard remaining path automatically. You only need to enter a full custom path ending with # when the upstream is not using the normal .../v1/chat/completions route shape. Normal Crazyrouter chat setup does not need that.

​
Best For

  • desktop users who want one place for multiple models
  • teams or individuals doing daily chat, writing, translation, and research
  • users who want to combine Crazyrouter with MCP tools
  • users who want fast switching between cheap and strong models

​
Protocol Used

Recommended protocol: OpenAI-compatible API The recommended setup is to add a custom OpenAI provider and enter the Crazyrouter root domain in API URL:
Do not start with:
  • https://api.crazyrouter.com/v1/chat/completions
  • https://api.crazyrouter.com/v1/models
Cherry Studio only needs a full custom path with a trailing # in special non-standard routing scenarios. Normal Crazyrouter chat setup does not need that.

​
Prerequisites

Recommended starting whitelist:
  • gpt-5.5
  • claude-opus-4-8
  • gemini-3.1-pro

​
5-Minute Quick Start

1

Create a dedicated Cherry Studio token

In the Crazyrouter dashboard, create a new token named cherry-studio. For the first pass, allow only 2 to 4 models you know you actually need.
2

Add a custom provider

Open Cherry Studio, go to Settings → Model Services, then click Add or + Add. Choose the provider type OpenAI and name it Crazyrouter.
3

Enter the connection settings

In the provider settings, enter:
  • API Key: your sk-...
  • API URL: https://api.crazyrouter.com
Then click Check to validate the token and URL.
4

Fetch and add models

Open Manage, fetch the model list, and add the models you want to use. Seeing a model in the popup does not always mean it is already enabled in the provider list, so you may still need to click + to add it. For first-run validation, start with only one baseline model: gpt-5.5.
5

Enable the provider and send the first prompt

Turn on the provider toggle, go back to the chat screen, pick gpt-5.5, and send a simple prompt such as Reply only OK. If you get a normal reply, the setup is working.
Recommended order: get gpt-5.5 working first, then add claude-opus-4-8 and gemini-3.1-pro.

​
Token Setup Best Practices

​
Verification Checklist

  • Check succeeds in the provider settings
  • API URL is set to https://api.crazyrouter.com
  • the provider toggle is enabled
  • at least one model was added from Manage
  • the first chat request succeeds
  • streaming output renders normally
  • MCP services work if you enabled them
  • the request appears in the Crazyrouter logs

​
MCP Usage Tips

Cherry Studio supports MCP services, but the cleanest rollout is a two-step process:
  1. verify the Crazyrouter chat model first
  2. add MCP services only after the model path is stable
That keeps model-routing issues separate from MCP tool issues. If you enable MCP:
  • start with a model that handles tool use reliably
  • attach only one MCP service for the first test
  • use a simple read-only tool call before trying more complex actions

​
Common Errors and Fixes

​
Performance and Cost Tips

  • Start with only 1 to 2 models so the first rollout stays easy to debug
  • Default to gpt-5.5, then switch to claude-opus-4-8 for harder long-form and code tasks
  • If you keep long conversations open, give Cherry Studio its own quota cap
  • Since Cherry Studio makes model switching easy, reserve expensive models for heavier work only
  • If usage looks abnormal, check the Crazyrouter logs first for retries or long multi-turn sessions

​
FAQ

​
Which URL should I enter in Cherry Studio?

Start with https://api.crazyrouter.com. Because Cherry Studio’s own docs explain that many OpenAI-compatible upstreams only need the root URL, and the client appends the standard path itself. Crazyrouter should be set up that way first.

​
When would I need a full endpoint path ending with #?

Only when your upstream is not using a standard OpenAI route pattern. For normal Crazyrouter chat setup, do not use that mode first.

​
Which model should I test first?

Start with gpt-5.5.

​
Can I configure many models right away?

Yes, but it is better not to do that on day one. Get one baseline model working first, then expand.

​
Can Cherry Studio use MCP together with Crazyrouter?

Yes, but validate the chat model first and enable MCP after that. It makes troubleshooting much easier.
If your main goal is desktop multi-model chat and light MCP workflows, Cherry Studio is a strong option. If your main goal is agentic coding inside an IDE or terminal, Cursor, Claude Code, Codex, or Cline should still be the higher priority tools.