如果你正在搜索 CC Switch Claude Code，那你大概率已经安装了这个编码助手。问题其实更具体：你需要让 CC Switch 写入正确的 Claude Code 提供商配置，使用正确的 Flatkey 密钥，指向正确的基础 URL，选择你的密钥实际可以访问的模型，并在使用日志中验证请求。
本指南覆盖使用 Flatkey 和 NewAPI 风格一键工作流进行 CC Switch Claude Code 路由的实用路径。NewAPI 目前的 CC Switch 文档描述了从 New API 令牌页面通过 ccswitch:// 深度链接导入。Flatkey 用户也可以手动使用相同的 CC Switch 配置界面：添加 Claude Code 提供商，粘贴 Flatkey API 密钥，设置 Claude Code 网关基础 URL，获取模型，保存配置文件，并验证路由。
本指南仅包含文字内容。它不使用应用截图，因为当前 CC Switch 和 Flatkey 的 UI 流程在发布步骤图片之前应先经过截图复核。
Flatkey 的 CC Switch Claude Code 设置快速答案
对于基于 Flatkey 的 CC Switch Claude Code 配置，请在 CC Switch 中创建一个 Claude Code 提供商，并将 Flatkey 路由器作为网关。对于 Claude Code 的 Anthropic Messages 风格请求，请使用根网关 URL，而不是 OpenAI chat-completions 路径。
| CC Switch 字段或配置 | Flatkey 值 | 需要验证什么 |
|---|---|---|
| 应用 | Claude 或 Claude Code |
当目标是 Claude Code 时，不要配置 Codex 或 Gemini 应用。 |
| 提供商选项卡 | App-specific Provider 用于 Claude Code，或在你也同步 Codex/Gemini 时使用 Universal Provider |
通用提供商需要在同步后检查，因为每个应用可能期望不同的 URL 形式。 |
| 名称 | Flatkey Claude Code |
使用一个在后续 CC Switch 托盘切换中一眼就能看懂的名称。 |
| API Key | 你的 Flatkey API key | 从 Flatkey 仪表板 创建或复制。切勿在共享文档中粘贴真实密钥。 |
| Claude Code base URL | https://router.flatkey.ai |
将其用于 ANTHROPIC_BASE_URL。然后 Claude Code 会访问诸如 /v1/messages 的路径。 |
| OpenAI-compatible base URL | https://router.flatkey.ai/v1 |
将其用于 OpenAI 兼容客户端以及调用 /v1/models 的模型获取检查。 |
| Main/Sonnet/Opus/Haiku models | 来自 CC Switch 获取结果、Flatkey 控制台或 定价目录 的模型 ID | 使用精确的模型 ID。不要使用营销名称或模型家族标签。 |
| Verification | 运行一个很小的 Claude Code 提示并查看 Flatkey 使用日志 | 在请求出现在 Flatkey 仪表板中之前，设置都不算完成。 |
如果你的 CC Switch 表单提供高级 JSON 编辑器，Claude Code 配置文件应解析为如下结构。在文档中使用占位符；切勿在仓库中存储真实密钥。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-fk-your-flatkey-key",
"ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
"ANTHROPIC_MODEL": "your-claude-model-id"
}
}Claude Code 也支持 ANTHROPIC_API_KEY。除非你明确理解优先级，否则只使用一个认证变量，不要同时使用两个。对于 bearer 风格的网关路由，ANTHROPIC_AUTH_TOKEN 能让映射更明确，因为 Claude Code 会把它作为 Authorization 头的值发送。
NewAPI 在 CC Switch 工作流中的位置
NewAPI 目前的 CC Switch 文档说明，New API 控制台可以通过以下 JSON 添加一个 Chat Settings 快捷入口：
{ "CC Switch": "ccswitch" }之后，New API 令牌管理页面可以显示一个 CC Switch 选项，该选项会通过 ccswitch:// 深层链接启动 CC Switch，并打开提供商导入对话框。NewAPI 的文档将该对话框字段描述为应用类型、名称、主模型，以及 Haiku/Sonnet/Opus 模型选择。
对于 Flatkey，请使用相同的概念，但不要声称 NewAPI 令牌页面支持导入。如果你的密钥是 Flatkey 密钥，请直接在 CC Switch 中添加提供商。如果你的密钥位于 NewAPI 部署中，请使用 NewAPI 的一键导入。关键区别很简单：CC Switch 负责管理本地 Claude Code 配置，而 Flatkey 或 NewAPI 负责上游路由层。
开始之前
在更改 CC Switch Claude Code 提供商之前，请确认以下先决条件：
- CC Switch 已安装在运行 Claude Code 的机器上。
- Claude Code 已经安装并且可以正常打开。
- 你可以登录 Flatkey 并打开 仪表板。
- 你拥有该工作站或开发者的 Flatkey API 密钥。
- 你至少知道一个可供你的 Flatkey 账户使用的 Claude 模型 ID。
- 在第一次测试请求后，你可以查看 Flatkey 使用日志。
不要在第一次测试中使用共享的生产密钥。请创建一个以工具和所有者命名的受限密钥，例如 cc-switch-lee 或 claude-code-devbox。这样可以让首次 CC Switch Claude Code 试运行更容易审计，也更容易撤销。
步骤 1：创建或复制一个 Flatkey API 密钥
打开 Flatkey 仪表盘，并通过 CC Switch 为 Claude Code 的使用创建一个密钥。复制一次后，将其存储在你的密码管理器或团队密钥管理器中。
CC Switch 的 API 密钥字段应填写 Flatkey 密钥。除非你有意配置的是直接提供商而不是 Flatkey，否则不要将 Anthropic、OpenAI、Google 或特定提供商的密钥粘贴到此配置文件中。
对于团队，请按用户、设备或环境创建单独的密钥。一个共享密钥在技术上可能可用，但会使后续的使用审查和吊销变得更困难。
步骤 2：在 CC Switch 中添加 Claude Code 提供方
打开 CC Switch，前往 Claude Code 提供方区域。CC Switch 用户手册描述了两种添加路径：用于所选应用的应用专用提供方，以及用于在 Claude Code、Codex 和 Gemini 之间共享配置的通用提供方（Universal Provider）。
对于首次进行 CC Switch Claude Code Flatkey 设置，请从应用专用的 Claude Code 提供方开始：
- 打开 CC Switch。
- 在应用切换器中选择 Claude 或 Claude Code。
- 点击 + 按钮添加提供方。
- 如果没有 Flatkey 预设，请选择自定义提供方路径。
- 将提供方名称设为
Flatkey Claude Code。 - 粘贴你的 Flatkey API 密钥。
- 将 Claude Code 网关基础 URL 设为
https://router.flatkey.ai。 - 仅在确认你的账户可用后，再为 Main、Sonnet、Opus 和 Haiku 选择模型 ID。
如果你使用通用提供方（Universal Provider），请填写 Name、API Key 和 Endpoint URL，然后勾选你想同步的应用。同步后，检查生成的 Claude Code 配置。对于 Claude Code，活动基础地址应为 https://router.flatkey.ai。对于兼容 OpenAI 的应用配置，https://router.flatkey.ai/v1 通常是预期的基础 URL。
步骤 3：在选择 Main、Sonnet、Opus 和 Haiku 之前获取模型
CC Switch 在模型输入旁提供了一个 获取模型 操作。它使用已配置的 API 密钥调用一个兼容 OpenAI 的 /v1/models 端点，然后让你从下拉菜单中选择返回的模型 ID。
本文中，我们于 2026 年 6 月 11 日对 Flatkey 进行了日期检查，使用已配置的测试密钥从 https://router.flatkey.ai/v1/models 返回了 HTTP 200，并得到了一个模型列表响应。返回的示例包括 Claude 系列模型 ID，例如 claude-sonnet-4-6、claude-sonnet-4-5、claude-opus-4-7 和 claude-haiku-4-5。请将这些示例视为当前快照，而不是永久的模型推荐。
请使用以下模型选择规则：
- Main Model：选择你希望 Claude Code 默认使用的 Claude 模型。
- Sonnet Model：选择团队期望用于日常编码的平衡型模型。
- Opus Model：仅在预算和访问权限允许时，选择更高能力的模型。
- Haiku Model：如果可用，选择适合更快或后台任务的轻量级模型。
如果 Fetch Models 失败，不要猜测。打开 Flatkey 控制台或 定价目录，复制一个完全一致的 Claude 兼容模型 ID，然后先只用该模型进行测试。
步骤 4：保存、同步并检查生成的 Claude Code 配置
在你保存提供商后，CC Switch 会为 Claude Code 写入当前激活的提供商配置。具体文件路径可能因 CC Switch 版本和应用范围而异，但 Claude Code 的官方设置文档确认，可以通过 settings.json 中的 env 键来配置环境变量。
检查生成的配置是否不包含冲突的认证值。一个干净的 Flatkey 配置应包含以下模式之一：
# Bearer-token gateway style
ANTHROPIC_AUTH_TOKEN=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.ai或者：
# API-key style
ANTHROPIC_API_KEY=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.ai在测试新的 CC Switch Claude Code 配置文件时，不要让旧的直接 Anthropic 密钥仍然在你的 shell 中处于激活状态。如果 shell 仍然导出了另一个不同的 ANTHROPIC_API_KEY，排查问题会更困难，因为当前进程可能并没有使用你以为它正在使用的 CC Switch 配置文件。
步骤 5：在 Claude Code 和 Flatkey 使用日志中验证
在 CC Switch 中启用 Flatkey 提供程序后，打开一个新的终端。Claude Code 在某些 CC Switch 路径中可以支持热切换，但新的终端会在首次测试时消除 shell 状态混淆。
- 启动 Claude Code。
- 检查 Claude Code 中的当前模型或状态。
- 发送一个很小的提示，例如让它回复一句简短的话。
- 打开 Flatkey 控制台。
- 查看该请求时间、模型 ID 和密钥名称的使用日志。
只有当这三层都一致时，CC Switch Claude Code 设置才算完成：CC Switch 显示 Flatkey 提供程序为活动状态，Claude Code 使用的是预期的模型/base URL，并且 Flatkey 日志中能看到该请求。
使用 Flatkey 排查 CC Switch Claude Code 问题
| 问题 | 可能原因 | 修复方法 |
|---|---|---|
| 认证错误 | 密钥错误、已禁用、复制时带有空格，或者不是 Flatkey 密钥。 | 在 Flatkey 中创建一个新的密钥，再次粘贴，并确认你使用的是 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY，且没有冲突的值。 |
| 404 或错误的端点路径 | URL 包含了不适用于 Claude Code 的错误路径格式。 | 对于 Claude Code，请使用 https://router.flatkey.ai。对于 OpenAI 兼容的模型获取或其他客户端，请使用 https://router.flatkey.ai/v1。 |
| 获取模型失败 | 密钥无法调用 /v1/models，基础 URL 错误，或者端点暂时不可用。 |
模型获取路径请使用 https://router.flatkey.ai/v1，然后回退到 Flatkey 控制台中的精确模型 ID。 |
| Claude Code 仍在使用旧提供商 | 旧的终端进程或 shell 导出变量正在覆盖 CC Switch 配置文件。 | 打开新的终端，检查 shell 环境变量，并确保在 CC Switch 中启用了 Flatkey 提供商。 |
| 模型选择有效，但请求失败 | 所选模型已列出，但对你的密钥、组、余额或当前账户策略不可用。 | 先测试一个已知可访问的模型。检查 Flatkey 账户访问、余额、配额和使用日志。 |
| MCP 工具搜索改变了行为 | Claude Code 将非第一方基础 URL 视为网关路由。 | 在通过代理启用高级工具搜索行为之前，请遵循 Claude Code 的网关指导。除非你的网关会转发所需的块，否则不要启用网关特定标志。 |
大多数 CC Switch Claude Code 故障都归结为四个字段：密钥、基础 URL、模型 ID 和活动配置文件。在重建整个 CC Switch 数据库之前，请先检查这些项。
CC Switch 与 Claude Code 路由器
CC Switch 和 Claude Code 路由器解决的是工作流中的不同部分。CC Switch 是本地配置管理器。Flatkey 是路由和访问层。
| 层 | 它做什么 | 它不做什么 |
|---|---|---|
| CC Switch | 存储提供商配置文件，切换 Claude Code/Codex/Gemini 配置，管理模型字段，并且可以通过深度链接导入提供商。 | 它不是上游模型账户、计费系统或路由器。 |
| Claude Code | 运行编码助手并读取当前环境/配置值。 | 它不会自动管理你团队的多提供商密钥或计费。 |
| Flatkey | 为受支持的模型提供一个密钥、网关端点、模型访问、用量可见性、路由和计费控制。 | 它不能替代 CC Switch 的本地配置文件切换界面。 |
如果你只需要一个永久的网关设置，你可以直接配置 Claude Code。如果你在多个提供商、工作站或模型层级之间切换，CC Switch Claude Code 工作流能为你提供更清晰的控制界面。如果你也在把应用代码迁移到网关，请阅读 OpenAI-compatible API migration 指南。如果你在 Claude 专用代理和更广泛的网关之间做选择，请阅读 Claude API proxy vs router。
推荐的团队部署
对于一个开发者，1 个 Flatkey 密钥和 1 个 CC Switch 提供商就足够了。对于团队来说，应将 CC Switch Claude Code 配置视为一次小型访问控制部署。
- 为每位开发者、工作站或环境创建一个命名的 Flatkey 密钥。
- 记录已批准的 Claude 模型 ID，以及在 CC Switch 中每个 ID 映射到的层级。
- 在邀请更多用户加入同一路由配置之前，先使用配额。
- 在第一天后就检查使用日志，而不是只在账单意外出现后才查看。
- 在当前 UI 经审核确认之前，不要将截图放入公开文档。
- 仅对在 NewAPI 中管理的密钥使用 NewAPI 一键导入；Flatkey 密钥请使用手动 Flatkey 提供商设置。
FAQ
什么是 CC Switch Claude Code 设置？
CC Switch Claude Code 设置是 CC Switch 中的一个提供商配置文件，用于写入 Claude Code 应使用的端点、密钥和模型设置。使用 Flatkey 时，该配置文件会将 Claude Code 指向 Flatkey 路由器，并使用 Flatkey 密钥。
Flatkey Claude Code 的 base URL 需要包含 /v1 吗？
对于 Claude Code 的 ANTHROPIC_BASE_URL，请使用 https://router.flatkey.ai。对于明确调用 /v1/models 的 OpenAI 兼容应用客户端和模型获取检查，请使用 https://router.flatkey.ai/v1。
NewAPI 一键导入会自动配置 Flatkey 吗？
不会。NewAPI 的一键 CC Switch 路径是为 New API 令牌管理页面编写的。对于 Flatkey，除非 Flatkey 之后发布专门的 ccswitch:// 导入链接，否则需要在 CC Switch 中手动添加该提供商。
CC Switch 可以获取 Flatkey 模型吗？
可以，前提是所配置的密钥能够访问 Flatkey 的 OpenAI 兼容模型列表。本文在 2026 年 6 月 11 日进行的一次检查返回了来自 https://router.flatkey.ai/v1/models 的 HTTP 200，以及针对所配置测试密钥的模型列表响应。
我应该使用 ANTHROPIC_API_KEY 还是 ANTHROPIC_AUTH_TOKEN？
Claude Code 文档中两者都支持。ANTHROPIC_API_KEY 会作为 API 密钥头发送，而 ANTHROPIC_AUTH_TOKEN 会通过授权路径发送。对于 Flatkey 配置文件，请使用一种明确的方法，并避免同时设置两个不同的值。
我如何知道设置是否成功？
当 CC Switch 显示 Flatkey 提供商为活动状态，Claude Code 使用预期的模型，小型测试提示执行成功，并且请求出现在 Flatkey 使用日志中时，就说明设置成功了。
最终检查
当以下清单全部通过时，你的 CC Switch Claude Code Flatkey 设置就准备好了：
- CC Switch 在 Claude Code 下有一个名称清晰的 Flatkey 提供商。
- API 密钥是来自 控制台 的 Flatkey 密钥。
ANTHROPIC_BASE_URL解析为https://router.flatkey.ai。- 所选模型 ID 是你的密钥可用的准确 ID。
- 获取模型或手动输入模型均可成功。
- Claude Code 运行一个很小的测试提示。
- Flatkey 使用日志显示了该请求。
获取密钥，通过 Flatkey 路由 Claude Code，然后使用 CC Switch 让本地提供商配置文件保持易于切换、检查和回滚。
