Agentsflare CC Switch 配置方案

CC Switch 是一款开源的跨平台 AI CLI 工具配置管理工具，支持集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等主流 AI 编码代理的 API 配置，让你无需手动修改配置文件即可快速切换不同的 API 提供商和模型。

安装 CC Switch

macOS

方式一：Homebrew（推荐）

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

方式二：手动安装

从 GitHub Releases 下载 .dmg 文件，打开后将 CC Switch.app 拖拽到 Applications 文件夹。

Windows

方式一：MSI 安装包（推荐）

从 GitHub Releases 下载 .msi 安装包，双击运行安装。

方式二：便携版

下载 .zip 便携版，解压后直接运行 CC-Switch.exe。

Linux

Arch Linux (AUR)

paru -S cc-switch-bin

Debian / Ubuntu

sudo dpkg -i cc-switch_*.deb

AppImage（通用）

chmod +x CC-Switch_*.AppImage
./CC-Switch_*.AppImage

Web 版（无桌面环境 / 服务器）

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web

默认端口 17666，通过浏览器访问 http://localhost:17666 即可使用。

---

在 CC Switch 中添加 Agentsflare Provider

安装完成后启动 CC Switch，点击右上角的 + 按钮添加新配置，按以下步骤填写 Agentsflare 信息：

配置项	值
名称	Agentsflare（或任意易识别的名称）
Endpoint	根据工具类型选择：Anthropic 兼容端点或 OpenAI 兼容端点
API Key	你的 Agentsflare API Key

选择应用类型

CC Switch 支持为不同工具创建独立的配置，在顶部切换应用类型：

• Claude — 对应 Claude Code / Claude Desktop
• Codex — 对应 OpenAI Codex CLI
• Gemini — 对应 Gemini CLI
• OpenCode — 对应 Opencode
• OpenClaw — 对应 Openclaw
• Hermes — 对应 Hermes Agent

配置 Agentsflare 端点

根据应用类型选择对应的 Agentsflare 端点：

应用类型	Endpoint	说明
Claude / Claude Desktop	https://api.agentsflare.com/anthropic	Anthropic Messages API 兼容端点
Codex / OpenCode / OpenClaw / Hermes	https://api.agentsflare.com/v1	OpenAI API 兼容端点

填写完成后，点击 Fetch Models 加载可用模型列表，然后点击 保存 即可。

---

Claude Code 配置

通过 CC Switch 配置（推荐）

1. 在 CC Switch 中选择 Claude 应用类型
2. 添加或选择 Agentsflare Provider
3. 填写以下参数：

参数	值
ANTHROPIC_API_KEY	你的 Agentsflare API Key
ANTHROPIC_BASE_URL	https://api.agentsflare.com/anthropic
模型	例如 claude-opus-4-6、claude-sonnet-4-6

4. 点击 启用 激活配置
5. 启动 Claude Code 即可使用 Agentsflare 代理访问 Claude 模型

手动配置（备用）

如需手动配置，参考 Claude Code 配置文档。

---

Claude Desktop 配置

Claude Desktop 是 Anthropic 推出的桌面客户端，配置方式如下：

通过 CC Switch 配置

1. 在 CC Switch 中选择 Claude 应用类型
2. 添加 Agentsflare Provider，Endpoint 填写 https://api.agentsflare.com/anthropic
3. 在 Claude Desktop 中开启开发者模式
4. 通过 Configure third-party inference 配置自定义 API 地址：
   • Base URL: https://api.agentsflare.com/anthropic
   • API Key: 你的 Agentsflare API Key

手动配置（备用）

参考 Claude Desktop 配置文档。

---

Codex 配置

通过 CC Switch 配置（推荐）

1. 在 CC Switch 中选择 Codex 应用类型
2. 添加 Agentsflare Provider，Endpoint 填写 https://api.agentsflare.com/v1
3. 填写以下参数：

参数	值
OPENAI_API_KEY	你的 Agentsflare API Key
OPENAI_BASE_URL	https://api.agentsflare.com/v1
模型	例如 gpt-5.2

4. 点击 启用 激活配置
5. 启动 Codex 即可使用

选择 API 端点

Agentsflare 提供两个兼容 OpenAI 的 API 端点，CC Switch 中默认使用基础 URL。如需指定具体端点：

端点类型	配置值	适用场景
Chat Completions（默认）	https://api.agentsflare.com/v1 或 https://api.agentsflare.com/v1/chat/completions	标准对话、代码生成、常规任务
Responses	https://api.agentsflare.com/v1/responses	复杂推理、工具调用、多轮上下文

注意：Codex 原生使用 OpenAI Responses API。当使用 Chat Completions 端点（如 https://api.agentsflare.com/v1）时，必须在 CC Switch 中开启本地路由（Chat Completions Routing）。CC Switch 的本地代理会将 Codex 发出的 Responses 请求自动转换为 Chat Completions 请求，再将响应重建回 Responses 格式，无需手动改配置。如果未开启路由，Codex 直接向 Chat Completions 端点发送 Responses 请求会导致报错。

手动配置（备用）

如需手动配置，参考 Codex 配置文档。

---

OpenCode 配置

通过 CC Switch 配置（推荐）

1. 在 CC Switch 中选择 OpenCode 应用类型（如支持）
2. 添加 Agentsflare Provider，Endpoint 填写 https://api.agentsflare.com/v1
3. 填写 API Key 和模型信息
4. 点击 启用 激活配置

手动配置（备用）

如需手动配置，参考 OpenCode 配置文档。

---

OpenClaw 配置

通过 CC Switch 配置（推荐）

1. 在 CC Switch 中选择 OpenClaw 应用类型（如支持）
2. 添加 Agentsflare Provider，Endpoint 填写 https://api.agentsflare.com/v1
3. 填写 API Key 和模型信息
4. 点击 启用 激活配置

手动配置（备用）

如需手动配置，参考 OpenClaw 配置文档。

---

Hermes Agent 配置

Hermes Agent 是 Nous Research 推出的开源 CLI 编码代理，支持 300+ 模型和跨平台网关。

通过 CC Switch 配置（推荐）

1. 在 CC Switch 中选择 Hermes 应用类型（如支持）
2. 添加 Agentsflare Provider，Endpoint 填写 https://api.agentsflare.com/v1
3. 填写以下参数：

参数	值
base_url	https://api.agentsflare.com/v1
api_key	你的 Agentsflare API Key
模型	例如 claude-sonnet-4-6、gpt-5.2 等

4. 点击 启用 激活配置

手动配置（备用）

如果 CC Switch 暂不支持 Hermes，可通过以下方式手动配置：

方式一：使用 hermes model 交互式配置

hermes model
# 选择 "Custom endpoint (self-hosted / VLLM / etc.)"
# 输入 API base URL: https://api.agentsflare.com/v1
# 输入 API Key: 你的 Agentsflare API Key
# 输入模型名称: claude-sonnet-4-6

方式二：手动编辑配置文件

编辑 ~/.hermes/config.yaml：

model:
  default: claude-sonnet-4-6
  provider: custom
  base_url: https://api.agentsflare.com/v1
  api_key: 你的 Agentsflare API Key

方式三：使用环境变量

编辑 ~/.hermes/.env：

OPENAI_BASE_URL=https://api.agentsflare.com/v1
OPENAI_API_KEY=你的 Agentsflare API Key

配置完成后，重启 Hermes：

hermes gateway restart

---

快速切换配置

CC Switch 的核心优势是支持一键切换不同 Provider 配置：

1. 在 CC Switch 主界面，选择已添加的 Provider 配置
2. 点击 启用 即可激活该配置
3. 对于支持的 CLI 工具（如 Claude Code），部分工具支持热切换，无需重启
4. 对于需要重启的工具，CC Switch 会提示你重启对应工具

---

常见问题

CC Switch 无法检测到已安装的 CLI 工具

确保对应工具已正确安装且命令在 PATH 中。你可以手动在终端运行以下命令验证：

claude --version    # Claude Code
codex --version     # Codex
opencode --version  # OpenCode
openclaw --version  # OpenClaw
hermes --version    # Hermes

切换配置后工具未生效

部分工具需要重启才能读取新配置。请：

1. 退出当前工具会话
2. 重新启动工具
3. 再次验证连接

模型列表加载失败

如果点击 Fetch Models 后无法加载模型列表，请检查：

1. API Key 是否正确
2. Endpoint URL 是否填写正确（注意是否包含 /v1 或 /anthropic 后缀）
3. 网络连接是否正常

如何同时管理多个 API Key

CC Switch 支持为同一 Provider 添加多个配置，通过不同名称区分（如 Agentsflare-Key1、Agentsflare-Key2）。在需要时切换即可。

---

参考资源

• CC Switch GitHub 仓库
• CC Switch 官方文档
• CC Switch GitHub Releases