CC Switch

一、产品简介

CC Switch 是一个跨平台的 AI 编程工具配置管理器，可管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等工具的供应商、模型、MCP、提示词和 Skills 配置。接入 verahub-cn 时，可以把同一组 API 地址、密钥和模型策略作为统一模板，再按不同工具的协议写入对应配置。适合以下场景：

同时使用 Claude Code、Codex、OpenCode、OpenClaw 或 Hermes Agent
需要在不同模型供应商之间快速切换
希望集中管理 MCP、Skills、系统提示词和模型配置
团队内需要统一 verahub-cn 接入方式与模型命名

二、安装 CC Switch

1. 桌面版安装

macOS 用户可使用 Homebrew 安装：

brew install --cask cc-switch

Windows、Linux 用户可在 CC Switch GitHub Releases 下载对应安装包：

Windows：.msi 或便携版压缩包
macOS：.dmg
Linux：.deb、.rpm 或 .AppImage

2. 纯命令行版本

如果在服务器、CI 或无桌面环境中使用，可安装 cc-switch-cli：

brew install cc-switch-cli

桌面版更适合本机开发和可视化切换；CLI 版更适合远程服务器、自动化环境和纯终端工作流。

三、添加 verahub-cn Provider

打开 CC Switch 后，进入 Provider / Add Provider，选择自定义供应商或 OpenAI-compatible 配置。不同工具读取配置的位置不同，建议先把 verahub-cn 的核心参数准备好，再写入目标工具对应的 provider。

使用目标	Base URL	说明
OpenAI 兼容工具	`https://api.vera-hub.cn/v1`	适用于 Codex、OpenCode、OpenClaw、Hermes Agent 等 OpenAI-compatible 接入
Anthropic 兼容工具	`https://api.vera-hub.cn`	适用于 Claude Code 等使用 Anthropic Messages 形态的工具

推荐字段：

字段	示例
Provider ID	`verahub`
Display Name	`verahub-cn`
API Key	在 verahub-cn 控制台创建并复制
OpenAI Base URL	`https://api.vera-hub.cn/v1`
Anthropic Base URL	`https://api.vera-hub.cn`

不同工具的协议入口不同。若 Claude Code 报 Anthropic 相关错误，优先检查是否使用了 https://api.vera-hub.cn；若 OpenCode、OpenClaw、Hermes Agent 报 OpenAI endpoint 错误，优先检查是否使用了 https://api.vera-hub.cn/v1。

四、同步到常用编程工具

Claude Code

选择或创建 verahub-cn Provider 后，在 Claude Code 配置中使用：

export ANTHROPIC_BASE_URL="https://api.vera-hub.cn"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-4-8"
claude

OpenCode

OpenCode 中的模型通常使用 provider/model 格式：

verahub/gpt-5.5
verahub/gpt-5.4
verahub/claude-opus-4-8
verahub/deepseek-v4-pro
verahub/MiniMax-M3

OpenClaw / Hermes Agent

建议把 verahub-cn 配置为一个独立 provider，例如：

verahub/kimi-k2.7-code
verahub/glm-5.2
verahub/MiniMax-M3

再在各工具自己的配置文件中把默认模型指向对应的 verahub/... 模型。OpenClaw 这类工具还需要把 baseUrl 写在它自己的 models.providers.<id> 里，不能只在模型 allowlist 中写一个 verahub/model 名称。

五、推荐模型

场景	推荐模型 ID	说明
顶级编程 / Agent	`claude-opus-4-8`、`gpt-5.5`	适合复杂重构、代码审查、多文件修改和长链路代理任务
OpenAI 兼容编程	`gpt-5.5`、`gpt-5.4`	适合通用编程、代码分析和开发者工具链场景
Coding Agent	`deepseek-v4-pro`、`MiniMax-M3`	适合工具调用、环境交互和高吞吐工程任务
中文工程 / 开源模型	`glm-5.2`、`kimi-k2.7-code`	适合中文项目上下文、长任务规划和团队知识整理
备用与降本	`MiniMax-M3`、`deepseek-v4-pro`、`glm-5.2`	适合摘要、分类、批处理和低成本辅助任务

具体可用模型以 verahub-cn 模型列表为准。

六、验证配置

1. 在 CC Switch 中切换 Provider

选择 verahub-cn Provider。
点击启用或通过系统托盘切换。
重启对应 CLI 或终端会话。

多数工具需要重启终端或 CLI 才能读取新配置。Claude Code 的部分配置支持热切换，但排障时仍建议先重启一次。

2. 用目标工具发起测试

可使用一个低风险问题验证：

请用一句话说明当前项目的主要技术栈。

如果能正常返回，并且 verahub-cn 控制台出现调用记录，说明供应商和模型配置已经生效。

七、常见问题

切换 Provider 后仍然走旧模型

重启对应 CLI、终端或 IDE 插件
检查当前工具是否有项目级配置覆盖全局配置
确认 CC Switch 中启用的是目标工具对应的配置，而不是只切换了另一个工具

OpenAI 兼容工具连接失败

确认 Base URL 以 /v1 结尾
确认模型 ID 与 verahub-cn 模型列表完全一致
检查 API Key 是否来自当前 verahub-cn 账号

Claude Code 报认证或 Messages 错误

确认 Claude Code 使用的是 https://api.vera-hub.cn，不要额外添加 /v1
确认环境变量为 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
尝试重启 Claude Code 会话

八、参考链接

CC Switch GitHub：https://github.com/farion1231/cc-switch
cc-switch-cli Homebrew：https://formulae.brew.sh/formula/cc-switch-cli

对话型 AI

编程开发

技术工程

翻译场景

一、产品简介

二、安装 CC Switch

1. 桌面版安装

2. 纯命令行版本

三、添加 verahub-cn Provider

四、同步到常用编程工具

Claude Code

OpenCode

OpenClaw / Hermes Agent

五、推荐模型

六、验证配置

1. 在 CC Switch 中切换 Provider

2. 用目标工具发起测试

七、常见问题

八、参考链接

​一、产品简介

​二、安装 CC Switch

​1. 桌面版安装

​2. 纯命令行版本

​三、添加 verahub-cn Provider

​四、同步到常用编程工具

​Claude Code

​OpenCode

​OpenClaw / Hermes Agent

​五、推荐模型

​六、验证配置

​1. 在 CC Switch 中切换 Provider

​2. 用目标工具发起测试

​七、常见问题

​八、参考链接

一、产品简介

二、安装 CC Switch

1. 桌面版安装

2. 纯命令行版本

三、添加 verahub-cn Provider

四、同步到常用编程工具

Claude Code

OpenCode

OpenClaw / Hermes Agent

五、推荐模型

六、验证配置

1. 在 CC Switch 中切换 Provider

2. 用目标工具发起测试

七、常见问题

八、参考链接