---
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”，点击 **启用**（一键导入时如果勾了“导入后立即启用”，CC-Switch 会自动做这一步，但仍建议打开 CC-Switch 确认这一项确实显示为已启用/当前使用，而不是只看到已经加进了列表）。
2. 完全退出正在运行的编程工具和终端，包括后台常驻的进程（Codex 桌面版、托盘里的 CC-Switch）。
3. 重新打开终端，再启动对应工具。
4. 第一次只发送简单的只读请求。

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

## 遇到问题

- **仍然使用旧配置**：完全退出工具和终端，再重新打开。
- **提示 401**：重新复制 API Key；Gemini CLI 还要确认存在 `bearer` 配置。
- **Codex 报错里的地址是 `api.openai.com` 而不是 `infistar.cc`**：说明“无限星河AI”这一项在 CC-Switch 里加进了列表，但没有真正切换成当前使用（没勾选“导入后立即启用”，或切换没有生效），Codex 因此仍在用切换前的默认官方地址，且这台电脑从未登录过官方账号，所以报“缺少鉴权”。回到 CC-Switch 确认“无限星河AI”显示为已启用/当前使用，完全退出终端和 Codex 后重新打开；如果状态显示已启用但问题依旧，改用上面 Codex 表格里的内容手动写进 `~/.codex/config.toml`（桌面版路径相同）。
- **提示 404**：Claude Code 和 Gemini CLI 使用根域名，Codex 使用带 `/v1` 的地址。
- **提示模型不存在**：填写模型广场中的原始模型 ID。

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