在 CC-Switch 中使用 OpenVeer

详细指导如何在 CC-Switch 中配置和使用 OpenVeer API 服务，通过简单的配置即可在 CC-Switch 中调用多种 AI 模型进行辅助编程。

简介

CC-Switch 是一款开源的桌面应用，用于统一管理 Claude Code、Codex、Gemini CLI 等多个 AI 编程命令行工具的 API 供应商配置。
它把繁琐的配置文件操作变成了图形界面里的几次点击——添加好供应商后，您就可以在不同 API 服务之间一键切换，无需再手动编辑配置文件。

通过 CC-Switch 接入 OpenVeer，您可以方便地为 Claude Code 和 Codex 配置 OpenVeer 服务，并在多个供应商之间自由切换。

准备工作

在开始之前，请确保：

1. 已安装命令行工具
   至少安装一个受支持的 CLI 工具，如 Claude Code 或 Codex CLI

2. 已获取 OpenVeer API 密钥
   登录 OpenVeer 控制台 获取您的 API 密钥（以 sk- 开头）

第一步：安装 CC-Switch

根据您的操作系统选择安装方式：

macOS

通过 Homebrew 安装（推荐）：

```bash
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

也可以从 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载 `.dmg` 安装包。CC-Switch 已通过 Apple 代码签名和公证，可直接安装（需 macOS 12 及以上）。

Windows

从 GitHub Releases 下载 .msi 安装包或绿色版 .zip。

需要 Windows 10 及以上版本。

Linux

从 GitHub Releases 下载对应格式的安装包：

* Debian / Ubuntu：`.deb` 包
* Fedora / RHEL：`.rpm` 包
* 通用：`.AppImage` 格式
* Arch Linux：`paru -S cc-switch-bin`

第二步：添加 OpenVeer 供应商

CC-Switch 主界面顶部可以切换不同的 CLI 工具分组。请根据您要配置的工具，参考下方对应的步骤添加 OpenVeer 供应商。

为 Claude Code 配置

1. 切换到 Claude Code 分组

在主界面顶部选择 **Claude Code**。

**2. 打开添加供应商面板**

点击主界面右上角的 **+** 按钮。

**3. 填写供应商信息**

在表单中填写以下内容：

| 字段          | 填写内容                     | 说明                   |
| ----------- | ------------------------ | -------------------- |
| **名称**      | `OpenVeer`                | 自定义标识，便于识别           |
| **端点地址**    | `https://api.openveer.com` | OpenVeer 的 API 地址     |
| **API Key** | `sk-xxxxxxxxxxxx`        | 您的 OpenVeer API 密钥    |
| **API 格式**  | `Anthropic Messages`     | 保持默认的 Anthropic 原生格式 |


  <img src="https://mintcdn.com/apicore/_1ZGW4_iuaSfzpC6/images/integrations/cc-switch/step-2.png?fit=max&auto=format&n=_1ZGW4_iuaSfzpC6&q=85&s=7d91af6ec3f40c7bb2666ba455a09faa" alt="CC-Switch 主界面" width="2024" height="1480" data-path="images/integrations/cc-switch/step-2.png" />


**4. 保存配置**

点击 **添加** 按钮保存，OpenVeer 会出现在供应商列表中。

为 Codex 配置

1. 切换到 Codex 分组

在主界面顶部选择 **Codex**。

**2. 打开添加供应商面板**

点击主界面右上角的 **+** 按钮。

**3. 填写供应商信息**

Codex 供应商通过两个配置块完成设置：

在 **auth.json** 配置块中填入密钥：

```json
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

在 **config.toml** 配置块中填入供应商配置：

```toml
model = "gpt-5.5"
model_provider = "OpenVeer"

[model_providers.OpenVeer]
name = "OpenVeer"
base_url = "https://api.openveer.com/v1"
wire_api = "responses"
requires_openai_auth = true
```

**4. 保存配置**

填写完成后为供应商命名（如 `OpenVeer`），点击 **添加** 按钮保存。CC-Switch 会自动校验 JSON 与 TOML 格式。

第三步：切换供应商

添加完成后，即可在 OpenVeer 与其他供应商之间随时切换：

在主界面切换

1. 在供应商列表中选中 OpenVeer
2. 点击 启用（或 使用）按钮
3. 看到 "切换成功" 提示即表示完成

通过系统托盘快速切换

CC-Switch 会常驻系统托盘，无需打开主界面即可切换：

1. 点击系统托盘中的 CC-Switch 图标
2. 在菜单中直接点击目标供应商名称，立即生效

支持的模型

切换到 OpenVeer 供应商后，您可以在对应的 CLI 工具中使用 OpenVeer 提供的多种模型：

常见问题

Q1: 切换供应商后没有生效？

• Claude Code：支持热切换，请开启一个新的会话；如仍未生效，重启 Claude Code
• Codex：切换后需要重新启动终端或 Codex

Q2: 提示 API 密钥无效？

1. 确认 API Key 以 sk- 开头，且完整复制无多余空格
2. 前往 OpenVeer 控制台 确认密钥状态有效
3. 检查端点地址是否填写正确（Claude Code 用 https://api.openveer.com，Codex 用 https://api.openveer.com/v1）

Q3: 添加 Codex 供应商时提示格式错误？

CC-Switch 会校验 auth.json（JSON 语法）和 config.toml（TOML 语法）。请检查：

• JSON 中的括号、引号、逗号是否完整
• 不要使用中文引号
• TOML 中的字段名拼写是否正确

Q4: CC-Switch 会修改哪些文件？

CC-Switch 会自动写入对应工具的配置文件：

• Claude Code：~/.claude/settings.json
• Codex：~/.codex/config.toml 和 ~/.codex/auth.json

切换前会自动备份，您无需手动编辑这些文件。

Q5: 如何查看 API 使用情况和费用？

登录 OpenVeer 控制台 查看 API 调用统计、Token 消耗明细和费用趋势。

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 OpenVeer 文档中心
• 📚 CC-Switch 项目主页
• 💬 Discord 社区
• 🐦 Twitter @OpenVeer_