One-click import workflow
- Open the API Keys page in the DimiLinks console.
- On the target key, click “Import to CC Switch” or “Import to Cherry Studio.” Before importing to CC Switch, you can choose which tool to configure (Claude Code / Codex / Gemini CLI) under “Configure CC Switch for.” The console recommends a default based on the key’s models.
- The browser opens a system-level deep link. The corresponding client handles it and writes the base URL, key, and model automatically.
api-direct.dimilinks.com. One-click import writes the correct form with or without /v1, depending on whether the target client appends the API path automatically.
Common reasons an import fails:
- The client is not installed or has not registered its deep-link scheme (
ccswitch:///cherrystudio://). - The browser blocked the scheme navigation. Focus the address bar and press Enter once, then try again.
- When the operating system sees the protocol for the first time, it asks whether to open the local application. Approve the request.
- The import succeeded but does not appear in CC Switch: providers appear only in the list for the tool selected during import. Claude Code, Codex, and Gemini have separate lists. Open the correct tool tab, or select a different target in the console and import again.
- For Claude Code, choose a key in a Claude group. A key limited to general-purpose groups cannot call Claude models.
CC Switch deep-link structure
The console generates a URL like this:Cherry Studio deep-link structure
data is URL-safe base64 that decodes to JSON:
type matches a Cherry Studio provider type: openai / anthropic / gemini.
Add a provider manually without a deep link
If you do not want one-click import, create the provider manually in the client:
After setup, use “Test connection” or send a minimal chat message to verify the connection.