> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CC-Switch 接入 APIONE

> 在图形界面中保存 APIONE 配置，按工具切换供应商。

CC-Switch 适合需要在多套 API 配置之间切换的开发者。先为目标工具建立独立配置，再启用 APIONE，后续可从供应商列表切回原有配置。

## 安装与准备

从 [CC-Switch Releases](https://github.com/farion1231/cc-switch/releases) 下载适合 Windows、macOS 或 Linux 的安装包。macOS 也可以使用：

```bash theme={null}
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

在 [APIONE 控制台](https://apione.ai/zh/app/api-keys) 创建 API Key，并从[模型目录](https://apione.ai/zh/models)确认模型 ID 与协议。已有配置先保留，便于回切。

![CC Switch 的 Codex 页面与添加供应商入口](https://mintcdn.com/apione/ZEt0-xxBt_qeI_Go/images/integrations/screenshots/cc-switch-codex-add-provider.png?fit=max\&auto=format\&n=ZEt0-xxBt_qeI_Go\&q=85\&s=3f2663894e0f38025e36e082da137442)

在 CC Switch 中选择 Codex，然后点击右上角的「添加供应商」。

## 添加供应商

1. 打开 CC Switch，选择要配置的工具。
2. 点击 **添加供应商**，选择自定义配置，名称填写 **APIONE**。
3. 填入 APIONE API Key，根据下表设置地址。
4. 选择模型并保存。Codex 的模型列表可通过「选择模型」或「手动添加」维护，修改后按界面提示重启 Codex。

| 工具 | 接入方式 | 地址 |
| - | - | - |
| Claude Code | Anthropic Messages | `https://api.apione.ai` |
| Codex | OpenAI Responses | `https://api.apione.ai/v1` |
| OpenCode | OpenAI Chat Completions | `https://api.apione.ai/v1` |
| Gemini CLI | Gemini API Key | 参见 [Gemini CLI](https://apione.ai/docs/guides/gemini-cli.md)，按客户端拼接规则设置 |

![CC Switch 的 APIONE 供应商名称、掩码密钥、接口地址和模型列表](https://mintcdn.com/apione/ZEt0-xxBt_qeI_Go/images/integrations/screenshots/cc-switch-codex-provider-config.png?fit=max\&auto=format\&n=ZEt0-xxBt_qeI_Go\&q=85\&s=327958abbb94c93f88f158b9843bf95e)

CC Switch 的 Codex 供应商配置示例，使用 Responses 协议。

## Codex 路由模式

保存供应商后，在 Codex 页选择「路由」，点击「开始路由」，在弹窗中将「路由到」设为 APIONE，再确认。路由模式通过本机 CC Switch 转发请求，使用时请保持 CC Switch 运行。

![Codex 路由模式的确认弹窗，目标供应商为 APIONE](https://mintcdn.com/apione/ZEt0-xxBt_qeI_Go/images/integrations/screenshots/cc-switch-codex-routing-confirm.png?fit=max\&auto=format\&n=ZEt0-xxBt_qeI_Go\&q=85\&s=56e31d06daa60be089ff7a87efa52fff)

在 Codex 路由确认弹窗中选择 APIONE。

## Claude Code 模型映射

Haiku、Sonnet、Opus 是客户端的选择档位。为各档位填写 APIONE 当前可用且支持 Messages 和工具调用的模型 ID；不要直接沿用其他平台的厂商前缀或别名。配置示意：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apione.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIONE_KEY",
    "ANTHROPIC_MODEL": "YOUR_APIONE_MODEL_ID"
  }
}
```

把占位符替换为实际值。若系统已设置另一套 Anthropic 密钥，先清理冲突项，避免同一请求携带多个鉴权头。

## 验证与切回

启用后新开会话，发送一句简短文本，并在 APIONE 控制台确认对应请求。若仍使用旧配置，重启目标工具，检查终端环境变量是否覆盖了 CC-Switch 写入的设置。切回原供应商时，在列表中重新启用对应条目即可。

跨应用共享配置时，逐个核对协议、地址和模型。只有需要本地代理或故障转移时再配置 Proxy & Failover，并单独验证代理链路。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.