Cherry Studio Configuration
Cherry Studio is a cross-platform AI desktop client (supports Windows, macOS, Linux) with multi-model conversations, knowledge base, and workflow support — one of the most feature-rich open-source AI clients available.
By configuring HaoAI as your provider, you can use GPT, Claude, Grok, DeepSeek, and other available models in Cherry Studio with just one API Key.
Protocol Overview
Cherry Studio supports connecting to HaoAI via three protocols:
OpenAI Chat — Based on /v1/chat/completions, for GPT series models such as openai/gpt-4.1, openai/gpt-5.3-chat.
OpenAI Response — Based on /v1/responses, for GPT series models such as openai/gpt-4.1, openai/gpt-5.4-mini.
Claude — Based on /anthropic/v1/messages, for Claude series models such as anthropic/claude-sonnet-4.6, anthropic/claude-opus-4.6.
Prerequisites
- An HaoAI account with an API Key (Get one here )
- Cherry Studio installed (Download )
Configuration Steps
Step 1: Open Settings
Launch Cherry Studio and click the Settings icon in the bottom-left corner.
Step 2: Add a Model Provider
Go to Model Services in the left sidebar, scroll to the bottom, and click + Add. In the dialog, enter a provider name and select the corresponding provider type.
OpenAI Chat
Select OpenAI as the provider type and click OK.
OpenAI Response
Select OpenAI as the provider type (enable Response mode on the config page later) and click OK.
Claude
Select Anthropic as the provider type and click OK.
Step 3: Enter API Configuration
Fill in the API key and API address on the provider’s configuration page.
OpenAI Chat
| Field | Value |
|---|---|
| API Key | Your HaoAI API Key |
| API Address | https://api.hao.ai/v1 |
OpenAI Response
| Field | Value |
|---|---|
| API Key | Your HaoAI API Key |
| API Address | https://api.hao.ai/v1 |
Claude
| Field | Value |
|---|---|
| API Key | Your HaoAI API Key |
| API Address | https://api.hao.ai/anthropic |
Make sure the toggle in the top-right corner of the page is ON, otherwise the provider will not appear in the model selector.
Step 4: Add Models
Click the Manage button in the model section to automatically fetch the model list, then click + next to a model to add it to the enabled list.
OpenAI Chat
OpenAI Response
Claude
Step 5: Verify Configuration
Click the Test button, select any model to test. A passing result means the configuration is successful.
OpenAI Chat
OpenAI Response
Claude
Start Using
Return to the main interface, click the model selector at the top of the chat, and choose a model under the corresponding provider group to start chatting.
FAQ
Q: The model list is empty after clicking “Manage”
Check that the API address is correct (no trailing slash) and that the API key was copied completely without extra spaces.
Q: Connection failed during verification
- Confirm the API Key was copied completely from the HaoAI Console without extra spaces
- Confirm the API address is correct
- Confirm your network connection is working
Q: The provider doesn’t appear in the model selector
Check that the toggle in the top-right corner of the configuration page is enabled.