1. Quick Start Guides
AnyRoute English
  • AnyRoute User Guide
  • Frequently Asked Questions
  • AnyRoute Support Group
  • Supported Models
  • Environment Setup
    • Node.js Installation Guide
    • CC Switch Introduction
  • Quick Start Guides
    • Codex CLI Quick Start
    • Claude Code Quick Start
    • OpenClaw Quick Start
    • Hermes Quick Start
    • Cherry Studio Quick Start
    • Claude Desktop Quick Start
    • Codex Desktop Quick Start
    • GPT Image 2 Guide
    • Claude Code in VS Code
  • Advanced Guides
    • Personal AGENTS.md Global Rules
    • Claude Code and Codex Collaboration Guide
  1. Quick Start Guides

Cherry Studio Quick Start

Purpose#

This guide connects Cherry Studio to AnyRoute and verifies the connection.

Quick configuration#

You need three values:
Base URL: https://cc.anyroute.io
API key: a key created in AnyRoute
Model ID: for example, claude-opus-4-6

1. Before you begin#

Confirm that Cherry Studio is installed and that you have an AnyRoute account and API key.

Create an API key#

1.
Sign in to the AnyRoute API Keys page.
2.
Select Create Key.
3.
Enter a name such as cherry-studio.
4.
Select a group that matches the provider type and models you plan to use.
5.
Keep the other settings at their defaults unless you need restrictions.
Create an AnyRoute key
Copy the API key
The copied key must be complete and contain no added spaces.

2. Open Cherry Studio settings#

Open Cherry Studio and select Settings.
Cherry Studio settings

3. Add AnyRoute as a provider#

1.
Under model services, select Add.
Add a provider
2.
Enter a provider name such as AnyRoute.
Enter the provider name
3.
Select OpenAI or Anthropic according to the model family and key group.
Select a provider type
4.
Enter:
API key: your AnyRoute key
API address: https://cc.anyroute.io
Enter the AnyRoute API settings
5.
Add the exact model ID.
Match the key group to the provider type: use a Codex/OpenAI-compatible group for OpenAI-type models and a Claude/Anthropic-compatible group for Anthropic-type models.

Supported models#

OpenAI-compatible examples#

gpt-5.4
gpt-5.5
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna

Anthropic-compatible examples#

claude-opus-4-8
claude-sonnet-5
claude-fable-5
For the full current list, see Supported Models.
Add a model
Select Check or Test. Continue when Cherry Studio reports a successful connection.
Successful provider test

4. Verify with a chat#

1.
Create a new conversation.
2.
Select the model you added.
3.
Send a short test message such as Hello.
Select the AnyRoute model
Successful model response

Troubleshooting#

HTTP 503#

The selected model route may be unavailable or busy. Retry later or select another available model.

HTTP 502#

The upstream model connection failed. Wait briefly and retry, or select another model.

AI_RetryError#

Automatic retries were exhausted, usually after repeated upstream errors. Try another model or retry later.

HTTP 401 or 403#

Copy the key again and confirm that the provider type matches the key group.

HTTP 400#

Check that the API address is https://cc.anyroute.io and that the model ID exactly matches a supported model.

The request keeps loading#

Start a new conversation, restart Cherry Studio, check the network connection, or switch models and groups.

One-minute checklist#

SettingExpected value
Base URLhttps://cc.anyroute.io
API keyComplete, active, and without spaces
Model IDExact supported model ID
Group and typeOpenAI-compatible group ↔ OpenAI; Claude-compatible group ↔ Anthropic

Join AnyRoute WeChat Group

To get support for AnyRoute

scan QR code
Modified at 2026-07-24 19:03:56
Previous
Hermes Quick Start
Next
Claude Desktop Quick Start
Built with