
# 国内直连教程：用CC Switch 一分钟配置 Claude Code

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 配置会简单很多：

```text
一分钟完成配置
不丢失原来的配置
不覆盖原来的配置
可以随意切换 Provider
```

也就是说，你可以同时保留：

```text
官方 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 令牌（API Key） | 访问官网获取 |




## 四、关键步骤

Claude Code 接入 QuickRouter API 时，核心配置只有两个：




注意：

Claude Code 使用 QuickRouter API 时，Base URL 填：

```text
https://api.quickrouter.ai
```

如果使用OpenAI GPT系列模型要加/v1填：

```text
https://api.quickrouter.ai/v1
```

`/v1` 通常用于 OpenAI 兼容接口，但 Claude Code 场景不要加。

---

## 五、用 CC Switch 配置 Claude Code

### 第一步：打开 CC Switch

打开 CC Switch 后，选择管理对象：

```text
Claude Code
```

---

### 第二步：新增 Provider

进入 Provider 管理页面，点击新增 Provider。

Provider 名称可以填写：

```text
QuickRouter API
```

---

### 第三步：填写接口地址

Base URL 填写：

```text
https://api.quickrouter.ai
```

不要加 `/v1`。

---

### 第四步：填写 API Key

API Key / Auth Token 填写你的 QuickRouter API Key：

```text
sk-xxxxxxxxxxxxxxxx
```

注意不要多复制空格，也不要把真实 Key 放到公开截图或文章里。

---

### 第五步：填写模型名称

模型名称填写 QuickRouter API 后台支持的 Claude 模型。

示例格式：

```text
claude-sonnet-xxx
```

具体以 QuickRouter API 控制台显示为准。

---

### 第六步：保存并切换

保存 Provider 后，在 CC Switch 中选择：

```text
QuickRouter API
```

然后点击切换。

这样 Claude Code 就会使用 QuickRouter API。

原来的配置不会丢失，也不会被覆盖。后续想切回官方 Claude 或其他 Provider，直接在 CC Switch 中切换即可。

---

## 七、启动 Claude Code 测试

进入你的项目目录：

```bash
cd your-project-folder
```

启动 Claude Code：

```bash
claude
```

输入测试内容：

```text
帮我分析这个项目的目录结构，并说明主要入口文件。
```

如果 Claude Code 正常返回内容，就说明配置成功。

---

## 八、常见问题

### 1. QuickRouter API 可以国内直连使用 Claude 吗？

可以。QuickRouter API 可以在国内网络环境下直连使用 Claude 等大模型，也支持 GPT、Gemini、DeepSeek、Grok 等模型。

---

### 2. 用 CC Switch 会覆盖原来的配置吗？

不会。

CC Switch 可以保留多个 Provider。你新增 QuickRouter API Provider 后，原来的配置仍然保留，可以随时切换回去。

---

### 3. 配置大概需要多久？

正常情况下，一分钟左右就可以完成。

只需要填写：

```text
Provider 名称
Base URL
API Key
模型名称
```

---

### 4. Base URL 要不要加 `/v1`？

Claude Code 不要加 `/v1`。

正确：

```text
https://api.quickrouter.ai
```

错误：

```text
https://api.quickrouter.ai/v1
```

---

### 5. 切换后没有生效怎么办？

退出 Claude Code，重新启动：

```bash
Ctrl + C
claude
```

如果还是没生效，关闭终端后重新打开，再运行：

```bash
cd your-project-folder
claude
```

---

## 九、总结

用 CC Switch 配置 Claude Code 接入 QuickRouter API，核心优势是：

```text
一分钟完成配置
国内直连使用 Claude 等大模型
不丢失原配置
不覆盖原配置
可以随意切换 Provider
支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw
```



如果你想在国内更方便地使用 Claude Code 调用 Claude 等大模型，CC Switch + QuickRouter API 是一种更简单、清晰、可切换的配置方式。


Claude Code 是常用的 AI 编程助手，可以在终端里读取项目、分析代码、修改文件和辅助开发。

国内直连教程：用CC Switch 一分钟配置 Claude Code

Claude Code 是常用的 AI 编程助手，可以在终端里读取项目、分析代码、修改文件和辅助开发。如果你在国内想用 Claude、GPT、Gemini、DeepSeek、Grok 等大模型

人工智能

开发工具

国内用户通过CCSwitch快速配置ClaudeCode接入QuickRouterAPI，实现直连Claude、GPT等AI模型。只需填写APIKey和BaseURL，1分钟完成配置，保留原有设置并可随时切换。支持ClaudeCode、Codex等工具，解决手动配置易出错问题，提升开发效率。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

国内直连教程：用CC Switch 一分钟配置 Claude Code-腾讯云开发者社区-腾讯云

国内直连教程：用CC Switch 一分钟配置 Claude Code

国内直连教程：用CC Switch 一分钟配置 Claude Code

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐