---
title: CC-Switch 使用教程
sidebarTitle: CC-Switch
description: 使用 CC-Switch 保存和切换 Claude Code、Codex 与 Gemini CLI 的无限星河AI API 配置。
---

CC-Switch 用来保存和切换 Claude Code、Codex、Gemini CLI 的 API 配置。它本身不能聊天或编程，使用前需要先安装对应的工具。

## 下载 CC-Switch

前往 [CC-Switch 下载页](https://github.com/farion1231/cc-switch/releases/latest)，选择适合自己系统的安装包。

第一次打开时，如果提示导入已有配置，建议先导入并保留备份。

## 添加无限星河AI

打开要使用的工具页签，点击 **添加供应商**，名称填写“无限星河AI”。不同工具的地址不一样。

### Claude Code

| 配置项 | 填写内容 |
| --- | --- |
| API Key | 控制台创建的 API Key |
| API 端点 | `https://infistar.cc` |
| 认证字段 | `ANTHROPIC_AUTH_TOKEN` |

![CC-Switch 配置 Claude Code](/images/tutorials/cc-switch/cc-switch-claude-provider.png)

### Codex

| 配置项 | 填写内容 |
| --- | --- |
| API Key | 控制台创建的 API Key |
| API 端点 | `https://infistar.cc/v1` |
| 模型 | 模型广场中的原始模型 ID |
| 协议 | `Responses API` |

![CC-Switch 配置 Codex](/images/tutorials/cc-switch/cc-switch-codex-provider.png)

### Gemini CLI

API 端点填写 `https://infistar.cc`，模型填写 Gemini 原始模型 ID，并确认环境变量中有：

```dotenv
GOOGLE_GEMINI_BASE_URL=https://infistar.cc
GEMINI_API_KEY=你的_API_Key
GEMINI_API_KEY_AUTH_MECHANISM=bearer
GEMINI_MODEL=模型广场中的Gemini模型ID
```

![CC-Switch 配置 Gemini CLI](/images/tutorials/cc-switch/cc-switch-gemini-provider.png)

## 启用配置

1. 选择“无限星河AI”，点击 **启用**。
2. 完全退出正在运行的编程工具和终端。
3. 重新打开终端，再启动对应工具。
4. 第一次只发送简单的只读请求。

切回官方账号时，在 CC-Switch 中启用原来的配置，再重新启动工具。

## 遇到问题

- **仍然使用旧配置**：完全退出工具和终端，再重新打开。
- **提示 401**：重新复制 API Key；Gemini CLI 还要确认存在 `bearer` 配置。
- **提示 404**：Claude Code 和 Gemini CLI 使用根域名，Codex 使用带 `/v1` 的地址。
- **提示模型不存在**：填写模型广场中的原始模型 ID。

不要同时使用 CC-Switch、Codex++、AiMaMi 或其他工具修改同一个客户端配置。