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 已内置全球加速,通常为本地网络问题,检查本地连接后重试。