用 CC-Switch 管理

CC-Switch （GitHub: farion1231/cc-switch ）是跨平台桌面应用（Windows / macOS / Linux），用图形界面统一管理多种本地 Agent 的 provider 配置，支持一键切换、模型自动拉取与配置备份。本文介绍如何用它连接 Inflox。

它能解决什么

每个本地 Agent 的配置文件格式各不相同（JSON、TOML、.env），手动切换 API 供应商意味着逐个改文件。CC-Switch 把以下工具的 provider 配置集中到一个界面管理，切换时自动写入对应工具的真实配置文件：

• Claude Code、Claude Desktop
• Codex（OpenAI Codex CLI）
• Gemini CLI
• Grok Build
• OpenCode
• OpenClaw
• Hermes

安装

macOS

方式一：Homebrew（推荐）

brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch

方式二：手动下载

从 Releases  下载 CC-Switch-v{version}-macOS.dmg（推荐）或 .zip。macOS 版本已通过 Apple 签名与公证，可直接安装打开，无需额外步骤。

Windows

从 Releases  下载 CC-Switch-v{version}-Windows.msi 安装包，或 -Windows-Portable.zip 便携版（Windows 10 及以上）。

Linux

从 Releases  下载对应发行版安装包：

• CC-Switch-v{version}-Linux.deb（Debian / Ubuntu 22.04+）
• CC-Switch-v{version}-Linux.rpm（Fedora / RHEL / openSUSE 34+）
• CC-Switch-v{version}-Linux.AppImage（通用）

Arch Linux 用户可直接 paru -S cc-switch-bin。

添加 Inflox Provider

CC-Switch 内置 50+ 供应商预设，但不包含 Inflox。连接 Inflox 有两种方式：按工具添加自定义配置，或使用「通用 Provider」一次同步多个工具。

方式一：通用 Provider（推荐，一个配置同步多工具）

通用 Provider 可以将同一份配置同步到 Claude Code / Codex / Gemini CLI，适合 Inflox 这类同时提供多协议兼容的网关：

1. 打开主界面右上角 + → 切换到「通用 Provider」标签页。
2. 点击「添加通用 Provider」，填写：
   • 名称：Inflox
   • API Key：你的 wk- Key（见 创建 API Key）
   • 端点 URL：https://api.inflox.ai
3. 勾选要同步的工具（Claude Code / Codex / Gemini CLI）。
4. 保存并启用。

通用 Provider 修改后会自动同步到已勾选工具的配置；删除通用 Provider 时也会同步删除对应工具的配置。

方式二：按工具自定义配置

在 + 面板中选中当前工具（如 Claude Code），使用「Custom」预设手动填写配置。

Claude Code

Anthropic Messages 协议，配置字段填入 env 对象：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.inflox.ai",
    "ANTHROPIC_AUTH_TOKEN": "wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "{provider}/{model}",
    "ANTHROPIC_SMALL_FAST_MODEL": "{provider}/{model}"
  }
}

Codex

Codex 使用 OpenAI Responses 协议，需要配置两个文件：

~/.codex/auth.json（API Key）：

{
  "OPENAI_API_KEY": "wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

~/.codex/config.toml（端点与模型）：

model = "{provider}/{model}"
model_provider = "inflox"
 
[model_providers.inflox]
name = "Inflox"
base_url = "https://api.inflox.ai/v1"
wire_api = "responses"
model_context_window = 1000000

OpenCode / OpenClaw / Hermes

三者均为 OpenAI 兼容接口，配置字段一致：

{
  "baseURL": "https://api.inflox.ai/v1",
  "apiKey": "wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "models": [
    { "id": "{provider}/{model}", "name": "{provider} {model}" }
  ]
}

Gemini CLI

Gemini 协议需模型启用 gemini 协议后才可用（当前生产默认未启用），配置字段：

{
  "env": {
    "GEMINI_API_KEY": "wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "GOOGLE_GEMINI_BASE_URL": "https://api.inflox.ai"
  }
}

自动拉取模型（Auto-Fetch）

添加或编辑 Provider 时，填好 API Key 与 端点 URL 后，点击模型输入框旁的下载图标（Fetch Models 按钮），CC-Switch 会调用 OpenAI 兼容的 /v1/models 接口自动拉取可用模型列表，无需手动复制模型 ID。

• Inflox 的 GET https://api.inflox.ai/v1/models 无需鉴权且返回 OpenAI 兼容格式，可直接使用该功能。
• 若拉取失败（401/403），先检查 API Key；若端点不支持 /v1/models（404/405），可改用手动填写。

切换与管理

• 主界面切换：选中 Provider 卡片，点击「启用」（Enable）。
• 系统托盘快速切换：点击托盘菜单中的 Provider 名称即可即时切换，无需打开主界面。
• 生效方式：除 Claude Code 支持热切换（无需重启）外，其余工具切换后需重启终端或对应 CLI 才会生效。
• 排序：支持拖拽调整 Provider 顺序；当前启用的 Provider 不可删除（CC-Switch 遵循「最小侵入」原则，保证工具始终有可用配置）。

切回官方登录

1. 在添加 Provider 时选择对应的「官方登录」（Official Login）预设，如 Anthropic Official / OpenAI Official / Google Official。
2. 启用该 Provider，重启 CLI 工具。
3. 按工具自身的登录 / OAuth 流程重新登录。

进阶功能一览

CC-Switch 还提供以下能力（不在本文展开）：

• 统一 MCP 面板：跨 Claude Code / Codex / Gemini CLI / OpenCode 等管理 MCP 服务器，双向同步。
• Prompts / Skills 管理：跨应用同步 CLAUDE.md / AGENTS.md 等提示文件；一键安装 Skills。
• 本地代理路由：协议转换、自动故障转移、熔断与上游健康监控。
• 用量看板：统计各 Provider 的消费、请求数与 Token 趋势。
• 云同步：通过 Dropbox / OneDrive / iCloud / WebDAV 跨设备同步配置。
• Deep Link：通过 ccswitch:// 协议一键导入 Provider / MCP / Prompts / Skills。
• 会话管理：浏览、搜索并恢复支持的会话历史。

数据存储与备份

• 数据库：~/.cc-switch/cc-switch.db（SQLite，存放 Provider / MCP / Prompts / Skills）。
• 本地设置：~/.cc-switch/settings.json。
• 自动备份：~/.cc-switch/backups/，自动轮转保留最近 10 份。
• 可在「设置 → 高级 → 数据管理」导入 / 导出 .sql 备份文件。

相关文档

• Claude Code
• Codex CLI
• OpenCode
• Pi