> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agipower.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Cc switch
# CC-Switch Guide for AGIPower
[CC-Switch](https://github.com/farion1231/cc-switch) is an open-source, cross-platform desktop tool designed to centrally manage configuration for AI coding assistants. It supports managing provider settings for four major coding tools—Claude Code, Codex, Gemini CLI, and OpenCode—so you can switch API providers in one click through a visual interface, without manually editing environment variables or JSON files.
CC-Switch can manage four coding tools: **Claude Code**, **Codex**, **Gemini CLI**, and **OpenCode**. By configuring AGIPower as a provider in CC-Switch, you can:
* **Visual management**: No more manual edits to environment variables and config files—complete everything in a GUI
* **One-click switching**: Switch instantly between AGIPower and other providers without restarting your terminal
* **Unified configuration**: Configure AGIPower once and sync it to multiple coding tools
* **Automatic failover**: Automatically switch to a backup provider if the primary provider is unavailable
* **Request monitoring**: View request logs and usage statistics in real time
CC-Switch supports both the Anthropic protocol and the OpenAI protocol, both of which integrate seamlessly with AGIPower.
## Install CC-Switch
### macOS
```bash title="Homebrew (Recommended)" theme={null}
brew tap farion1231/ccswitch
brew install --cask cc-switch
```
```text title="Manual Install" theme={null}
1. Download the latest macOS ZIP from the CC-Switch Releases page:
https://github.com/farion1231/cc-switch/releases
2. Unzip it and drag CC-Switch.app into the Applications folder
3. On first launch, you may see “Developer cannot be verified”. Go to:
System Settings → Privacy & Security → click “Open Anyway”
```
### Windows
```text title="MSI Installer (Recommended)" theme={null}
1. Download the latest .msi installer from the CC-Switch Releases page:
https://github.com/farion1231/cc-switch/releases
2. Double-click the .msi file and follow the prompts to complete installation
```
```text title="Portable Version" theme={null}
1. Download the latest portable .zip from the CC-Switch Releases page:
https://github.com/farion1231/cc-switch/releases
2. Extract to any directory and double-click CC-Switch.exe to run
```
### Linux
```bash title="Debian/Ubuntu (.deb)" theme={null}
# After downloading the .deb package from the Releases page
sudo dpkg -i cc-switch_*.deb
```
```text title="AppImage" theme={null}
1. Download the .AppImage file from the Releases page
2. Grant execute permission: chmod +x CC-Switch_*.AppImage
3. Double-click to run or execute in a terminal: ./CC-Switch_*.AppImage
```
CC-Switch also provides a Web UI version for servers without a GUI or for SSH remote environments. Download the Linux x64 tar.gz package from the Releases page, extract it, and run it. The default port is 17666.
## Get a AGIPower API Key
Before configuring CC-Switch, you’ll need a AGIPower API Key. AGIPower offers two billing options—choose based on your use case:
```text title="Subscription API Key (Recommended)" theme={null}
✅ Use cases: personal development, learning/exploration, vibe coding
✅ Features: fixed monthly fee, predictable cost, 5–10x price leverage
✅ API Key format: sk-ss-v1-xxx
How to get it:
1. Visit the subscription management page: https://agipower.ai/platform/subscription
2. Choose a plan (Pro $20/month, Max $100/month, Ultra $200/month)
3. After subscribing, create a subscription API key on the page
For details, see: Subscription Plan Guide
📚 https://agipower.ai/guide/subscription
```
```text title="Pay-as-you-go API Key" theme={null}
✅ Use cases: production environments, commercial products, enterprise apps
✅ Features: no rate limits, production-grade stability, billed by actual usage
✅ API Key format: sk-xxx
How to get it:
1. Visit the pay-as-you-go page: https://agipower.ai/platform/pay-as-you-go
2. Top up your account (top-ups automatically include 20% bonus credits)
3. Create an API key in the "Pay As You Go API Keys" section
For details, see: Pay-as-you-go Guide
📚 https://agipower.ai/guide/pay-as-you-go
```
* **Personal development/learning** → use a **Subscription API Key** (`sk-ss-v1-xxx`) for lower, better value cost
* **Production/commercial projects** → use a **Pay-as-you-go API Key** (`sk-xxx`) for higher stability and no limits
Subscription keys are not allowed for production use. Violations may result in account restrictions.
## Configure the AGIPower Provider
### Step 1: Open Provider Management
After launching CC-Switch, select the coding tool you want to configure in the top navigation bar (e.g., **Claude Code**) to open the provider management page.
On first launch, CC-Switch automatically imports your existing local Claude Code / Codex / Gemini CLI / OpenCode configuration as the default provider—no manual migration required.
### Step 2: Add the AGIPower Provider
Click **Add Provider** and fill in the following configuration:
#### Claude Code Configuration (Anthropic Protocol)
| Setting | Value | Notes |
| ----------------- | -------------------------- | -------------------------------------- |
| **Provider Name** | `AGIPower` | Custom name for easy identity |
| **Base URL** | `https://agipower.ai` | AGIPower Anthropic-compatible endpoint |
| **API Key** | `sk-ss-v1-xxx` or `sk-xxx` | Your AGIPower API key |
Configure **Model Mapping** to map Claude Code’s three speed tiers to models on AGIPower:
| Tier | Recommended Model | Notes |
| --------------------- | ----------------------------- | --------------------------------------------- |
| **Haiku (Fast)** | `anthropic/claude-haiku-4.5` | Fast completions, simple tasks |
| **Sonnet (Balanced)** | `anthropic/claude-sonnet-4.5` | Recommended for daily development; best value |
| **Opus (Powerful)** | `anthropic/claude-opus-4.5` | Complex architecture, large refactors |
With AGIPower, you can map not only to Claude models, but also to models from other providers. For example:
* Haiku tier → `volcengine/doubao-seed-code` (Doubao coding model)
* Sonnet tier → `openai/gpt-5.2` (GPT-5.2)
* Opus tier → `google/gemini-3-pro-preview` (Gemini 3 Pro)
For more models that support the Anthropic protocol, see the [AGIPower model list](https://agipower.ai/models?sort=newest\&supported_protocol=messages).
##### JSON Config Example (Copy & Paste)
```json theme={null}
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "",
"ANTHROPIC_BASE_URL": "https://agipower.ai",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.5",
"ANTHROPIC_MODEL": "anthropic/claude-opus-4.5",
"API_TIMEOUT_MS": "30000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
```
Copy and paste the configuration above into Claude Code’s config file, then save to complete setup.
#### Codex
| Setting | Value | Notes |
| ----------------- | ---------------------------- | ----------------------------------- |
| **Provider Name** | `AGIPower` | Custom name for easy identity |
| **Base URL** | `https://api.agipower.ai/v1` | AGIPower OpenAI-compatible endpoint |
| **API Key** | `sk-ss-v1-xxx` or `sk-xxx` | Your AGIPower API key |
##### config.toml Example (Copy & Paste)
```toml theme={null}
model_provider = "agipower"
model = "openai/gpt-5.2-codex"
[model_providers.agipower]
name = "AGIPower"
base_url = "https://api.agipower.ai/v1"
wire_api = "responses"
```
Copy and paste the configuration above into Codex’s config file, then save to complete setup.
#### Gemini CLI Configuration (Vertex AI Protocol)
| Setting | Value | Notes |
| ----------------- | -------------------------- | -------------------------------------- |
| **Provider Name** | `AGIPower` | Custom name for easy identity |
| **Base URL** | `https://api.agipower.ai` | AGIPower Vertex AI-compatible endpoint |
| **API Key** | `sk-ss-v1-xxx` or `sk-xxx` | Your AGIPower API key |
##### Environment Variable Example (Copy & Paste)
```env theme={null}
GOOGLE_GEMINI_BASE_URL=https://api.agipower.ai
GEMINI_API_KEY=
GEMINI_MODEL=google/gemini-3-flash-preview
```
Copy and paste the configuration above into Gemini CLI’s config file, then save to complete setup.
#### OpenCode Configuration (OpenAI Protocol)
| Setting | Value | Notes |
| ----------------- | -------------------------- | -------------------------------------- |
| **Provider Name** | `AGIPower` | Custom name for easy identity |
| **Base URL** | `https://api.agipower.ai` | AGIPower Vertex AI-compatible endpoint |
| **API Key** | `sk-ss-v1-xxx` or `sk-xxx` | Your AGIPower API key |
##### JSON Config Example (Copy & Paste)
```json theme={null}
{
"models": {
"openai/gpt-5.2": {
"name": "gpt-5.2 (via AGIPower)"
}
},
"npm": "@ai-sdk/openai-compatible",
"options": {
"apiKey": "",
"baseURL": "https://api.agipower.ai/v1"
}
}
```
Copy and paste the configuration above into OpenCode’s config file, then save to complete setup.
Make sure to replace `<AGIPower_API_KEY>` in the configuration with your real AGIPower API key:
**Subscription API Key (Recommended for personal development)**
* Format: `sk-ss-v1-xxx`
* Get it here: [Subscription management page](https://agipower.ai/platform/subscription)
* Detailed guide: [Subscription plan docs](/en/guide/subscription)
**Pay-as-you-go API Key (Production environments)**
* Format: `sk-xxx`
* Get it here: [Pay-as-you-go page](https://agipower.ai/platform/pay-as-you-go)
* Detailed guide: [Pay-as-you-go docs](/en/guide/pay-as-you-go)
### Step 3: Switch to the AGIPower Provider
After adding it, click the toggle button next to **AGIPower** in the provider list to route the current coding tool’s requests through AGIPower.
CC-Switch supports hot-switching providers—**no need to restart your terminal or coding tool**. After switching, new requests are immediately forwarded via AGIPower, and existing conversation context remains unaffected.
### Step 4: Share Configuration Across Apps (Optional)
If you use multiple coding tools, CC-Switch can sync the same provider configuration across all managed apps. This is especially convenient for an API gateway like AGIPower that supports multiple protocols:
1. Enable **Cross-app sharing** (Universal Provider) in the provider settings
2. Set default model mappings for each app
3. Save—this provider will automatically sync to Claude Code, Codex, Gemini CLI, and OpenCode
## Supported Models
Models that support the Anthropic protocol are being adapted in batches. You can filter the currently supported models via the [official model list](https://agipower.ai/models?sort=newest\&supported_protocol=messages) and select the Anthropic Messages protocol.
The OpenAI protocol supports a much broader set of models. You can filter the [model list](https://agipower.ai/models) by "OpenAI API Compatible".
## Troubleshooting
### Common Issues
#### API Key Error or Authentication Failure
**Issue**: After configuring the provider, you see that the API key is invalid or unauthorized.
**Solution**:
1. **Check the API key format**:
* Subscription keys should start with `sk-ss-v1-`
* Pay-as-you-go keys should start with `sk-`
* Make sure there are no extra spaces or line breaks
2. **Verify the API key is valid**:
* Subscription: visit the [subscription management page](https://agipower.ai/platform/subscription) to check subscription status and quota
* Pay-as-you-go: visit the [pay-as-you-go page](https://agipower.ai/platform/pay-as-you-go) to ensure your balance is sufficient
3. **Confirm the Base URL is correct**:
* Claude Code (Anthropic protocol): `https://agipower.ai`
* Codex / OpenCode (OpenAI protocol): `https://api.agipower.ai/v1`
* Gemini CLI (Vertex AI protocol): `https://agipower.ai/api/vertexai`
#### macOS Shows “Developer Cannot Be Verified”
**Issue**: On first launch, macOS shows “Developer cannot be verified”.
**Solution**:
Because the developer does not yet have Apple Developer signing, macOS may block the app on first run.
1. Go to **System Settings** → **Privacy & Security**
2. Find the blocked CC-Switch message at the bottom of the page
3. Click **Open Anyway**
4. In the confirmation dialog, click **Open**
This prompt will not appear on subsequent launches.
#### Coding Tool Not Responding After Switching Providers
**Issue**: After switching to AGIPower in CC-Switch, the coding tool’s requests don’t change.
**Solution**:
1. Confirm CC-Switch is running (the system tray icon should be visible)
2. Check whether the provider for that coding tool has been switched correctly in CC-Switch (the active provider is highlighted)
3. Trigger a new request in the coding tool and confirm it routes through AGIPower
4. If it still doesn’t work, restart the coding tool and test again
#### Model Does Not Support the Anthropic Protocol
**Issue**: In Claude Code, a model reports that it doesn’t support the Anthropic protocol.
**Solution**:
* Use the [AGIPower model list](https://agipower.ai/models?sort=newest\&supported_protocol=messages) and filter by "Anthropic API Compatible" to see currently supported models
* Ensure the model ID in model mapping is correct (e.g., `anthropic/claude-sonnet-4.5`, not `claude-sonnet-4.5`)
* Use a model from the supported list above
If you run into any issues, or have suggestions and feedback, feel free to reach out via:
* **Official website**: [https://agipower.ai](https://agipower.ai)
* **Support email**: [support@agipower.ai](mailto:support@agipower.ai)
* **Business inquiries**: [support@agipower.ai](mailto:support@agipower.ai)
* **Twitter**: [@AGIPowerAI](https://twitter.com/AGIPowerAI)
* **Discord community**: [http://discord.gg/vHZZzj84Bm](http://discord.gg/vHZZzj84Bm)
For more contact options and details, visit our [Contact page](/en/help/contact).
For CC-Switch project issues, please report them via [CC-Switch GitHub Issues](https://github.com/farion1231/cc-switch/issues).