CC-Switch Complete Tutorial for Adding Suppliers: 4-Step Configuration Guide Taking APIYI as an Example

After installing CC-Switch, the next step is adding your own API provider. A lot of beginners get stuck here: they aren't sure what to fill in, where to put it, or how to make it take effect. In this guide, we'll use APIYI (apiyi.com) as an example to walk you through the entire process—adding, switching, speed testing, and restoring official login.

Core Value: By the end of this article, you'll have mastered CC-Switch provider management and finished your entire configuration in just 3 minutes.

Preparation Before Adding a Provider to CC-Switch

Before we start, you'll need to have a few things ready:

Prerequisites Checklist

Registering an APIYI Account

If you don't have an APIYI account yet, get that sorted first:

1. Visit the APIYI official site at apiyi.com
2. Click register and create your account
3. Go to the console to get your API Key
4. Take note of the following info:
   • API Key: A string starting with sk-
   • Base URL: https://api.apiyi.com

🚀 New User Bonus: APIYI (apiyi.com) gives you free test credits right after registration. It supports Claude, GPT, Gemini, and other major models, so you can test things out before deciding to top up.

Checking for Environment Variable Conflicts

Important: If you've previously set an API Key in your system environment variables, it might override CC-Switch's configuration.

Check and clear any conflicting environment variables:

macOS/Linux:

# Check for conflicting variables
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# If they have values, you'll need to remove them from ~/.zshrc or ~/.bashrc

Windows:

• Open "System Properties → Advanced → Environment Variables"
• Look for and delete variables like ANTHROPIC_API_KEY or OPENAI_API_KEY if they exist.

Steps to Add a Provider in CC-Switch

Step 1: Open the Add Provider Interface

1. Launch the CC-Switch app.
2. Find the 「Add Provider」 button on the main interface (usually located above the provider list).
3. Click the button to open the provider configuration window.

Step 2: Choose a Configuration Method

CC-Switch offers two ways to add a provider:

Since APIYI is a third-party provider, we'll select the 「Custom」 configuration.

Step 3: Fill in Provider Configuration

This is the most critical step; you'll need to accurately fill in the following fields:

Basic Information

Claude Code Configuration (If Applicable)

CC-Switch supports the following fields for Claude Code:

Model Mapping Configuration (Optional)

If you need to specify default models, you can configure:

Full Configuration Example

Here is a complete configuration for adding APIYI as a provider:

# Basic Info
Name: APIYI
Base URL: https://api.apiyi.com

# Claude Code Config
ANTHROPIC_AUTH_TOKEN: sk-your-apiyi-key
ANTHROPIC_BASE_URL: https://api.apiyi.com

# Model Config (Optional)
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key",
    "ANTHROPIC_API_KEY": "sk-your-apiyi-key",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  },
  "codex": {
    "OPENAI_API_KEY": "sk-your-apiyi-key",
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  },
  "gemini": {
    "GEMINI_API_KEY": "sk-your-apiyi-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

Step 4: Save Configuration

1. Double-check that all required fields are filled out.
2. Click the 「Save」 or 「Confirm」 button.
3. CC-Switch will validate the configuration format.
4. Once saved successfully, the new provider will appear in your list.

💡 Configuration Tip: The interface provided by APIYI (apiyi.com) is fully compatible with OpenAI and Anthropic formats. You can simply use https://api.apiyi.com as the Base URL without adding a /v1 suffix (CC-Switch will handle it automatically).

3 Ways to Switch Providers in CC-Switch

Once you've added a provider, you'll need to switch to the new one for it to take effect. CC-Switch offers three ways to do this:

Method 1: Main Interface Switch (Recommended for Beginners)

This is the most straightforward way:

1. Go to the provider list in the CC-Switch main window.
2. Find the "APIYI" provider you just added.
3. Click the "Enable" button next to it.
4. Once the status changes to Active, the switch is complete.

┌─────────────────────────────────────────────────┐
│              CC-Switch Provider List             │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● APIYI (Active)          [Disable] [Test]    │  ← Currently Active
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

Method 2: System Tray Switch (Recommended for Power Users)

An even faster way that doesn't require opening the main window:

1. Locate the CC-Switch icon in your system tray (bottom-right on Windows / menu bar on macOS).
2. Click the icon to expand the menu.
3. Simply click the name of the "APIYI" provider.
4. It takes effect instantly—no extra confirmation needed.

Pro Tip: This is the quickest way to jump between providers if you're testing different services frequently.

Method 3: App-Specific Configuration

If you're using multiple CLI tools simultaneously, you can assign a unique provider to each one:

In CC-Switch, you can configure the provider for each application independently, giving you maximum flexibility.

How to Apply Changes in CC-Switch

Important: After switching providers, the configuration won't take effect in the CLI tool immediately. You'll need to restart the corresponding application.

Steps to Apply Changes

Verifying Your Setup

Once you've restarted, you can verify that the configuration is active using these methods:

Method 1: Direct Chat Test

claude
# Type a simple question. If it replies normally, you're good to go.
> Hello, please reply in Chinese.

Method 2: Use the CC-Switch Speed Test

1. Click the "Test" button next to the provider.
2. Check the latency and status.
3. A green ✓ indicates the connection is working perfectly.

Method 3: Check Configuration Files

# Claude Code config file
cat ~/.claude/settings.json

# You should see something like this:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 Validation Tip: You can check your API call history via the APIYI (apiyi.com) console. If you see new request records there, it means your configuration is active.

Restoring Official Login via CC-Switch

If you need to switch back to the official services, CC-Switch provides a one-click restore feature.

Restoring Official Login for Claude Code

1. Find the "Official Login" preset in the CC-Switch provider list.
2. Click "Enable" to switch to official mode.
3. Restart your terminal and run claude.
4. Follow the official Claude Code login flow (OAuth authentication).

Restoring Official Login for Codex

1. Select the "Official Login" preset (Codex version).
2. Click to enable it.
3. Restart and run codex.
4. Follow the prompts to complete the official OpenAI authentication.

Restoring Official Login for Gemini CLI

1. Select the "Google Official" preset.
2. Click to enable it.
3. Restart and run gemini.
4. Follow the prompts to complete the Google OAuth process.

Recovery Process Summary

Note: When you restore the official login, CC-Switch automatically backs up your custom settings. When you switch back to a third-party provider next time, your previous configuration will still be there.

CC-Switch: Advanced Provider Management Tips

Tip 1: Provider Speed Comparison

After adding multiple providers, you can run a batch speed test to pick the fastest one:

1. Click the "Test" button for each provider one by one.
2. Record the latency values for each.
3. Choose the provider with the lowest latency as your primary option.

Reference Standards:

Tip 2: Duplicating Providers

If you need to create a provider with a similar configuration:

1. Select an existing provider.
2. Click "Duplicate" or right-click and select "Copy".
3. Modify the name and specific settings.
4. Save it as a new provider.

Tip 3: Config Backup and Sync

CC-Switch supports cloud synchronization for your configurations:

1. Go to Settings → Storage.
2. Select a cloud sync folder (like Dropbox or OneDrive).
3. All your provider configurations will sync automatically.

This makes it easy to share the same provider setup across multiple devices.

Tip 4: Sharing Provider Configs

Version 3.9.0+ supports the "Shared Provider" feature:

• A single provider configuration can be applied to Claude, Codex, and Gemini simultaneously.
• This is perfect for gateways like APIYI that support multiple protocols.
• Just check "Sync to all apps" when adding a provider.

CC-Switch: Adding Providers FAQ

APIYI Provider Configuration Cheat Sheet

To help you get set up quickly, here are the full configuration parameters for APIYI:

Summary

With this tutorial, you've learned the full workflow for managing providers in CC-Switch:

1. Add Provider: Click Add Provider → Select Custom → Fill in the configuration → Save.
2. Switch Providers: Click Enable on the main interface or click the provider name directly from the system tray.
3. How to Apply: Restart your terminal or the corresponding CLI client.
4. Revert to Official: Select the Official Login preset → Restart → Complete the OAuth flow.

The combo of CC-Switch + APIYI makes API management a breeze:

• CC-Switch: Visual management with one-click switching.
• APIYI (apiyi.com): A unified interface, affordable pricing, and support for multiple models.

Head over to APIYI (apiyi.com) right now to get your API Key, add it as a provider in CC-Switch, and start enjoying a more efficient AI coding experience!

📝 Author: APIYI Tech Team | APIYI (apiyi.com) – Making AI API calls simpler