把 AI 接入
你的开发终端。

准备好这三项

使用 CC Switch 推荐

把 Findy 保存为一个服务商，之后可在图形界面中启用和切换，减少反复编辑终端配置的操作。

1. 下载并安装

   从项目的 GitHub Releases ↗ 下载适合系统和架构的安装包。CC Switch 用于管理配置，Claude Code CLI 仍需单独安装。

2. 添加 Findy 服务商

   打开 CC Switch，选择 Claude Code → 添加供应商（＋） → 自定义配置。名称填写 Findy，再填入接口地址和 API Key。界面名称可能随版本变化。

   服务商名称Findy

   请求地址https://subs.findyapi.com

   API KeyYOUR_FINDY_API_KEY

   上游格式Anthropic Messages（原生）

   完整 URL关闭

   认证字段ANTHROPIC_AUTH_TOKEN

   

3. 核对配置与模型

   展开「高级选项」，按截图填写「模型映射」。显示名称便于识别，真正发给接口的是「实际请求模型」。

   模型角色	实际请求模型（截图配置）
   Sonnet	claude-sonnet-5-5
   Opus	claude-opus-5-5
   Fable	claude-fable-5-1
   Haiku	claude-haiku-5-5
   Subagent	claude-sonnet-5-5

   

4. 启用 Findy，重新启动 CLI

   保存后，在服务商卡片中启用或切换到 Findy。退出正在运行的 Claude Code，重新打开终端并运行 claude，然后按下方步骤验证。

操作参考：CC Switch · 添加服务商

通过环境变量配置

以下是使用 Sonnet 的基础示例；其他角色映射可在 CC Switch 中配置。

适合快速测试，或无需图形工具的环境。以下配置只对当前终端及其启动的进程生效；关闭后需要重新设置。

macOS / Linux · Bash 或 Zsh

# 填入自己的令牌，并确认模型权限后，在同一个终端启动 Claude Code
export ANTHROPIC_BASE_URL="https://subs.findyapi.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_FINDY_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
claude

Windows · PowerShell

# 适用于 PowerShell，不适用于 cmd.exe
$env:ANTHROPIC_BASE_URL = "https://subs.findyapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_FINDY_API_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://subs.findyapi.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_FINDY_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5-5"
  }
}

替换后的令牌可能保留在终端历史或本地配置文件中，请妥善保管。不要把真实 API Key 提交到仓库、写入公开网页或发到截图里。

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY ANTHROPIC_MODEL

'ANTHROPIC_BASE_URL', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL' |
  ForEach-Object { Remove-Item "Env:$_" -ErrorAction SilentlyContinue }

配置参考：Claude Code · 连接网关 · 配置文件说明

确认连接成功

在 CLI 中检查模型列表

运行 /model 查看映射后的模型，使用方向键选择并确认。截图中选中的是 claude-opus-5-5；你也可以按任务选择其他已开通的模型。截图里的价格是 CLI 界面显示值，不代表 Findy 实际计费，具体以控制台为准。

再到 Findy 控制台查看对应调用记录。一次正常回复仅证明基础调用可用；工具调用、长上下文等能力仍取决于实际模型和网关兼容性。测试请求按平台规则计费。

桌面端 App：用 CC Switch 配置

在 CC Switch 左侧选择 Claude Desktop，为桌面端单独添加或编辑 Findy。下面按截图中的「直连」方式配置；Claude Code CLI 的环境变量不代替这里的桌面端设置。

1. 填写 Findy 连接信息

请求地址按截图填写，不以斜杠结尾。这里展示的是原生 Claude 模型的直连配置；其他模型的映射方式不在本节范围内。

2. 核对模型列表并保存

可使用界面中的「获取模型列表」或「添加模型」。截图配置了以下四个模型，请以你的账户实际权限为准：

• claude-sonnet-5-5
• claude-fable-5-1
• claude-opus-5-5
• claude-haiku-5-5

完成后点击右下角「保存」。截图顶部显示 Findy 是正在使用的供应商；如果你新建了配置，还需确认已将其启用。

3. 回到桌面 App 验证

打开 Claude 桌面端，检查 Gateway 提示和模型菜单；如果仍显示旧设置，重新打开 App 后再检查。选择已开通模型，发送一条简单消息，并在 Findy 控制台确认调用记录。

模型出现在菜单中仅说明界面已加载配置，实际可用性以请求结果为准。测试请求按平台规则计费。

遇到问题，从这里排查

兼容性参考：Claude Code · 网关兼容性指南