Claude Code

通过第三方工具 CC Switch 的本地代理，在 Claude Code 中使用 Fusion Model。

第三方兼容性说明： CC Switch 由第三方维护。它将 Anthropic Messages 请求转换为 OpenAI Chat Completions，再将响应转换回原格式。对话、流式输出、工具调用、推理内容、Token 统计、提示词缓存和长时间 Agent 任务的行为都可能因协议转换而存在差异。

接入参数

使用 FUMO Dashboard 的 Key，适用于线上注册与充值的账号。

参数	值
Base URL	`https://capi.fumolab.ai/api/fusion/v1`
可用模型 ID	`fusion-max-2.0`、`fusion-max-1.0`、`fusion-code-1.0`
API 协议	OpenAI Chat Completions API
连接方式	CC Switch 本地代理，通常为 `http://127.0.0.1:15721`

工作原理

Claude Code 通常发送 Anthropic Messages 请求。Fusion 提供 OpenAI 兼容的 Responses 和 Chat Completions 接口，不提供原生 Anthropic Messages 接口。本教程推荐使用 Chat Completions 作为上游协议，由 CC Switch 将请求和响应转换为 Claude Code 所需的格式。

CC Switch↗ 在本地代理中完成协议转换，调用链路如下：

Claude Code
    → Anthropic Messages
    → CC Switch on 127.0.0.1
    → OpenAI Chat Completions
    → FUMO

配置步骤

1. 安装 CC Switch

按照官方安装说明↗安装当前版本。

例如，在 macOS 上运行：

brew install --cask cc-switch

2. 获取 FUMO API Key

按照快速开始中的线上自助步骤（企业账号请见企业接入指南），创建并保存 API Key。已有销售对接的 FUMO 用户，请在注册时填写 Sales Code，或登录后按账号说明绑定。

3. 添加 Claude Code 服务商

在 CC Switch 中完成以下配置：

选择 Claude Code。
点击 Add Provider（添加服务商），创建自定义服务商。
名称填写 FUMO。
填入 FUMO API Key。
打开 Advanced Options（高级选项）。
将 Upstream Format / API Format（上游格式）设为 OpenAI Chat Completions。
启用 Full URL Mode（完整 URL 模式）。
在接口地址中填写 Base URL 加上 /chat/completions：

https://capi.fumolab.ai/api/fusion/v1/chat/completions

完整 URL 模式会原样使用该地址，不再追加请求路径。

4. 设置模型映射

首次配置时，可以将 Claude Code 的各个模型角色都映射到 Fusion Code：

CC Switch 字段	Fusion 模型 ID
Main model	`fusion-code-1.0`
Sonnet model	`fusion-code-1.0`
Opus model	`fusion-code-1.0`
Haiku model	`fusion-code-1.0`

也可以将 Main 或 Opus 角色映射为已授权的 fusion-max-1.0 模型 ID。公共网关会校验每个传入的 ID；请求通过后，Fusion 核心只将其作为兼容标签，因此这些映射不会覆盖与 Key 关联的 Fusion 配置。

5. 启用本地代理

保存并启用 FUMO 服务商。
打开 CC Switch 的 Proxy（代理）开关。
为 Claude Code 启用应用接管。
保持代理监听地址为 127.0.0.1。
打开新终端，让 Claude Code 读取更新后的环境变量。

启动 Claude Code 前，可以检查接管是否生效：

echo "$ANTHROPIC_BASE_URL"

该值应指向 CC Switch 的本地代理，通常为：

http://127.0.0.1:15721

在项目目录中启动 Claude Code：

cd /path/to/your/project
claude

验证接入

建议从简单任务开始，逐步测试：

提问一个简单的文本问题。
让 Claude Code 读取一个文件。
让它提出一处小修改，先不写入文件。
实际应用小修改，并检查 diff。
测试一条可安全重复执行的终端命令。
测试需要多次工具调用的较长任务。

测试过程中检查 CC Switch 请求日志，重点核对工具名称、参数、流式工具调用和停止原因。

安全注意事项

本地代理能够读取 API Key、提示词、代码上下文、工具调用和响应。请保持监听地址为 127.0.0.1；只有明确需要局域网访问且已单独做好安全防护时，才使用 0.0.0.0。

在私有仓库中使用前，请按组织的第三方软件政策审查 CC Switch 的发布版本和源代码。

常见问题

Claude Code 仍在调用原来的服务商

确认代理和 Claude Code 应用接管均已启用，然后打开新终端，检查 ANTHROPIC_BASE_URL。

Fusion 返回 404

确认已启用 Full URL Mode，且接口地址为上表的 Base URL 加上 /chat/completions。

文本对话正常，但工具调用失败

检查 CC Switch 代理日志。工具定义、流式参数和工具结果消息都需要在两种 API 格式之间转换，可能需要调整适配器。

无法连接本地代理

确认 CC Switch 正在运行，并监听配置的端口。如果修改过默认端口，保存后请关闭再重新启动代理。