Claude Code 是常用的 AI 编程助手，可以在终端里读取项目、分析代码、修改文件和辅助开发。
如果你在国内想用 Claude、GPT、Gemini、DeepSeek、Grok 等大模型，可以通过 QuickRouter API https://quickrouter.ai 。国内直连接入。QuickRouter API 支持统一 API Key、统一接口地址，适合 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具使用。
本文以 Claude Code 为例，介绍如何用 CC Switch 快速配置 QuickRouter API。
一、为什么用 CC Switch？
手动配置 Claude Code 通常需要修改环境变量或配置文件，新手容易遇到这些问题：
- Base URL 写错
- API Key 填错
- 配置文件格式错误
- 原来的配置被覆盖
- 想切换回原配置很麻烦
用 CC Switch 配置会简单很多：
一分钟完成配置
不丢失原来的配置
不覆盖原来的配置
可以随意切换 Provider
也就是说，你可以同时保留：
官方 Claude 配置
QuickRouter API 配置
其他备用 Provider 配置
需要哪个，就在 CC Switch 里切换哪个。
二、CC Switch 支持哪些工具？
CC Switch 支持多个 AI 编程 CLI 工具，包括：
- Claude Code
- Codex
- Gemini CLI
- OpenCode
- OpenClaw
本文只演示 Claude Code 配置 QuickRouter API。
其他工具也可以按类似方式添加 Provider。
三、准备工作
你需要准备：
| 项目 | 说明 |
|---|---|
| Claude Code | 本地已安装 |
| CC Switch | 官网下载 |
| QuickRouter 令牌（API Key） | 点击访问官网获取 |
QuickRouter 官网：
https://quickrouter.ai
---
## 四、关键步骤
Claude Code 接入 QuickRouter API 时，核心配置只有两个：
注意：
Claude Code 使用 QuickRouter API 时，Base URL 填：
```text
https://api.quickrouter.ai
如果使用OpenAI GPT系列模型要加/v1填：
https://api.quickrouter.ai/v1
/v1 通常用于 OpenAI 兼容接口，但 Claude Code 场景不要加。
五、用 CC Switch 配置 Claude Code
第一步：打开 CC Switch
打开 CC Switch 后，选择管理对象：
Claude Code
第二步：新增 Provider
进入 Provider 管理页面，点击新增 Provider。
Provider 名称可以填写：
QuickRouter API
第三步：填写接口地址
Base URL 填写：
https://api.quickrouter.ai
不要加 /v1。
第四步：填写 API Key
API Key / Auth Token 填写你的 QuickRouter API Key：
sk-xxxxxxxxxxxxxxxx
注意不要多复制空格，也不要把真实 Key 放到公开截图或文章里。
第五步：填写模型名称
模型名称填写 QuickRouter API 后台支持的 Claude 模型。
示例格式：
claude-sonnet-xxx
具体以 QuickRouter API 控制台显示为准。
第六步：保存并切换
保存 Provider 后，在 CC Switch 中选择：
QuickRouter API
然后点击切换。
这样 Claude Code 就会使用 QuickRouter API。
原来的配置不会丢失，也不会被覆盖。后续想切回官方 Claude 或其他 Provider，直接在 CC Switch 中切换即可。
七、启动 Claude Code 测试
进入你的项目目录：
cd your-project-folder
启动 Claude Code：
claude
输入测试内容：
帮我分析这个项目的目录结构，并说明主要入口文件。
如果 Claude Code 正常返回内容，就说明配置成功。
八、常见问题
1. QuickRouter API 可以国内直连使用 Claude 吗？
可以。QuickRouter API 可以在国内网络环境下直连使用 Claude 等大模型，也支持 GPT、Gemini、DeepSeek、Grok 等模型。
2. 用 CC Switch 会覆盖原来的配置吗？
不会。
CC Switch 可以保留多个 Provider。你新增 QuickRouter API Provider 后，原来的配置仍然保留，可以随时切换回去。
3. 配置大概需要多久？
正常情况下，一分钟左右就可以完成。
只需要填写：
Provider 名称
Base URL
API Key
模型名称
4. Base URL 要不要加 /v1？
Claude Code 不要加 /v1。
正确：
https://api.quickrouter.ai
错误：
https://api.quickrouter.ai/v1
5. 切换后没有生效怎么办？
退出 Claude Code，重新启动：
Ctrl + C
claude
如果还是没生效，关闭终端后重新打开，再运行：
cd your-project-folder
claude
九、总结
用 CC Switch 配置 Claude Code 接入 QuickRouter API，核心优势是：
一分钟完成配置
国内直连使用 Claude 等大模型
不丢失原配置
不覆盖原配置
可以随意切换 Provider
支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw
如果你想在国内更方便地使用 Claude Code 调用 Claude 等大模型，CC Switch + QuickRouter API 是一种更简单、清晰、可切换的配置方式。