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

​
下载 CC-Switch

前往 CC-Switch 下载页，选择适合自己系统的安装包。 第一次打开时，如果提示导入已有配置，建议先导入并保留备份。

​
添加无限星河AI

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

​
Claude Code

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

​
Codex

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

​
Gemini CLI

API 端点填写 https://infistar.cc，模型填写 Gemini 原始模型 ID，并确认环境变量中有： 
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

​
启用配置

  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 或其他工具修改同一个客户端配置。