Flatrouter
Claude Code

配置模型供应商

用 CC Switch 把 Flatrouter 接入 Claude Code,无需手动编辑 JSON 或环境变量。

推荐使用 CC Switch 完成配置 —— 一款开源的供应商管理工具,可视化操作,无需手动编辑 JSON 或环境变量。

1. 安装 CC Switch

macOS

brew install --cask cc-switch

或前往 Releases 下载 .dmg 手动安装。

Windows

前往 Releases 下载 .msi 安装程序。

Linux

# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb

# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm

# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

支持 macOS 12+、Windows 10+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+。

2. 添加供应商

第 1 步:新增供应商

打开 CC Switch,进入供应商管理页,点击右上角 + 按钮。

第 2 步:填写配置

按下表填写,点击 + 添加 完成。

配置项值说明
❶ 供应商名称flatrouter-claude自定义,方便识别
❷ 官网链接https://flatrouter.com供应商官网
❸ API Key你的 Flatrouter API Key在 控制台 → API Keys 获取
❹ 请求地址https://api.flatrouter.com/anthropic末尾不要加斜杠
❺ API 格式 / 认证字段Anthropic Messages (原生) / ANTHROPIC_AUTH_TOKEN(默认)保持默认
❻ 模型配置留空留空即使用默认 Claude 模型
❼ 选项勾选「隐藏 AI 署名」和「Teammates 模式」按需勾选
❽ 写入通用配置✅ 勾选写入全局配置,所有项目生效

CC Switch 会自动写入 ~/.claude/settings.json,无需手动编辑任何文件。

第 3 步:启用供应商

添加完成后回到列表,选中 flatrouter-claude,点击使用按钮,看到「切换成功」提示即完成。

3. 验证配置

进入项目目录启动 Claude Code,首次启动按 Esc 跳过登录。启动后注意顶部信息栏,确认显示 Claude 图标;发送一句 hi 打个招呼,收到回应即说明请求已经走通、计费正常。

故障排除

遇到问题时,在 Claude Code 终端中运行 /status 检查配置,确认以下关键字段:

  • Anthropic base URL 为 https://api.flatrouter.com/anthropic
  • Model 显示当前使用的模型

Q: 提示 “Authentication error”

确认 Anthropic base URL 正确,并检查 API Key 是否有效。

Q: 连接超时

确认请求地址填写为 https://api.flatrouter.com/anthropic,末尾不带斜杠。

Q: 流式响应卡顿

Flatrouter 已内置全球加速,通常为本地网络问题,检查本地连接后重试。

本页目录