1. 为什么要在 Claude Code 里接 Qwen3.6
Claude Code 是目前用起来最顺手的终端 AI Agent 之一,能读项目、改代码、跑命令,但它默认绑的是 Anthropic 的模型,长期跑下来 token 消耗不小。如果你只是想拿它做日常的代码检查、重构建议、写点脚本,其实完全可以把底层模型换成 Qwen3.6——最近这波活动里 Qwen3.6 和 Qwen3.5 的 token 是不限量的,截止到月底,对想低成本跑 AI Agent 的开发者来说是个不错的窗口。
问题在于,Claude Code 原生只认 Anthropic 的接口协议,而 Qwen3.6 提供的是 OpenAI 兼容格式的接口。这两者字段结构、请求路径都不一样,直接填进去是跑不通的。所以中间需要一个协议转换层,把 Claude Code 发出的 Anthropic Messages 请求,翻译成 OpenAI Chat Completions 格式再转发出去。CC Switch 就是干这个的——它本身是个本地 AI Agent 供应商管理工具,能帮你保存多套配置、随时切换,同时内置了协议转换和本地路由功能。
这篇就按「拿到 Key → 装 CC Switch → 填配置 → 启动路由 → 验证请求」的顺序走一遍,每一步都给到可复制的片段和填写位置。适合已经装了 Claude Code、想换个便宜模型跑 Agent 的人。整个过程不需要你懂协议细节,照着填就行。
需要说明的是,Qwen3.6 的免费额度是通过官方 MaaS 平台发放的,你需要在那边注册并创建应用拿到 API Key。CC Switch 只负责本地转发,不参与额度发放。所以流程是两段:先去平台拿凭证,再回本地配工具。
2. 前置准备:拿到 Qwen3.6 的 Base URL 和 Key
这一步的目标是凑齐三样东西:modelId、APIKey、接口地址。没有这三个,后面 CC Switch 里没法填。
先打开活动入口,在模型列表里找到 Qwen3.6。点进模型详情页,右上角有个「API调用」按钮,点进去会让你创建一个应用。应用名称随便填,比如claude-code-test,创建完系统会自动生成一套凭证。
创建成功后,页面上会显示你需要复制的信息。这里要留意,接口地址通常有两个版本:一个是 OpenAI 兼容格式的,一个是 Anthropic Messages 原生格式的。因为 Claude Code 走的是 Anthropic 协议,理论上你可以直接用 Anthropic 原生地址,但 Qwen3.6 这边更稳妥的做法是用 OpenAI 兼容地址,让 CC Switch 在本地做协议转换。两种都能用,区别在 CC Switch 里选的协议类型不同。
把这三样记下来:
| 项目 | 说明 | 示例形态 |
|---|---|---|
| modelId | 模型标识,填到配置里 | 类似qwen3.6-35b-a3b |
| APIKey | 调用凭证,注意保密 | 一长串字符 |
| 接口地址 | Base URL,请求根路径 | 平台提供的服务地址 |
注意:APIKey 只在创建时完整显示一次,如果没复制到,回应用管理里重新生成一个。别把它贴到公开仓库里。
如果你打算长期用,建议把 Key 存到环境变量或者本地的密钥管理里,而不是硬编码在配置文件里。CC Switch 的配置是存在本地的,问题不大,但养成习惯更好。
另外提一句,如果你除了 Qwen3.6 还想接别的模型做对比,TaoToken 这边也提供了统一的接入方式,Base URL 是https://taotoken.net/api,配合 API Keys 页面生成的 Key 就能用,模型对话入口可以先去试试效果。它的好处是多个模型走同一套凭证,切换成本低。不过这篇的重点还是 Qwen3.6 的免费额度,TaoToken 作为备选方案提一下。
拿到三样信息后,下一步就是装 CC Switch 并填配置。
3. 可复制配置:CC Switch 里怎么填
CC Switch 的下载地址在它的 GitHub releases 页面,搜cc-switch就能找到,选对应系统的安装包。装好之后打开,进入工具配置页面,点右上角的「+」添加一个新的供应商。
关键在「自定义配置」这一项。选它之后,会出来一个表单,需要填供应商名称、APIKey、接口请求地址、模型 modelId,还有一个协议格式的选择。下面是我实测能跑通的填法。
供应商名称随便起,比如qwen-free。APIKey 填你从平台复制的那串。接口请求地址填平台给的 Base URL。modelId 填qwen3.6-35b-a3b(以你实际拿到的为准)。
协议格式这里要重点说一下:如果你用的是 OpenAI 兼容地址,就选OpenAI 协议;如果你用的是 Anthropic 原生地址,就选Anthropic Messages 原生格式。底层 CC Switch 会自动做转换。我这边用的是 OpenAI 协议,因为兼容性更稳。
配置保存后,CC Switch 会生成一份本地配置文件。它的结构大致长这样,你可以对照检查字段有没有填错:
{ "provider": "qwen-free", "baseUrl": "https://maas.xfyun.cn/modelService", "apiKey": "sk-你的Key", "model": "qwen3.6-35b-a3b", "protocol": "openai", "localRoute": true, "claudeRoute": true }字段说明:baseUrl是请求根路径,apiKey是凭证,model是模型 ID,protocol决定转换方向,localRoute和claudeRoute控制本地路由是否开启。这几个字段名在不同版本里可能略有差异,但含义一致。
如果你更习惯用 TOML 或者 settings 形式管理,CC Switch 也支持导出。核心就是保证 Base URL、Key、Model ID 三件套齐全,协议类型和地址格式匹配。这里再强调一次三件套:
- Base URL:平台给的接口地址,填在
baseUrl - Key:APIKey,填在
apiKey - Model ID:modelId,填在
model
填完点保存。这时候还没完,还要启动路由。
4. 启动路由并验证一次对话请求
保存配置后,回到 CC Switch 主界面,找到你刚建的供应商,点「启动」。如果是第一次装 CC Switch,并且你选的是 OpenAI 协议,需要手动把本地路由和Claude 路由两个开关都打开。这两个开关的作用是:本地路由负责监听端口、接收 Claude Code 的请求;Claude 路由负责把 Anthropic 格式转成 OpenAI 格式再发出去。少开一个都会导致请求失败。
启动成功后,CC Switch 一般会显示监听地址,类似http://127.0.0.1:某端口。这个地址就是 Claude Code 要指向的端点。
接下来打开 Claude Code,让它做一件具体的事来验证。最简单的办法是进一个项目目录,让它检查代码:
cd your-project claude然后在 Claude Code 里输入:
帮我检查一下当前项目的目录结构,列出主要的源文件如果配置正确,Claude Code 会正常返回结果,说明请求已经通过 CC Switch 转发到 Qwen3.6 并拿到了响应。你也可以直接发一个更明确的指令,比如让它解释某个函数的作用,观察返回内容是否合理。
想更直接地验证接口通不通,可以绕过 Claude Code,直接用 curl 打一次 CC Switch 的本地端点:
curl http://127.0.0.1:你的端口/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: 你的Key" \ -d '{ "model": "qwen3.6-35b-a3b", "max_tokens": 128, "messages": [ {"role": "user", "content": "用一句话说明什么是递归"} ] }'如果返回里有正常的文本内容,说明链路是通的。如果返回报错,看下一节的排查。
实测下来,第一次配置最容易卡在路由没启动或者协议选错这两点上。只要这两步对了,后面基本一次过。
5. 常见报错排查:401、local proxy failed、reading choices
配置过程中会遇到几类典型报错,这里按真实错误信息对照排查。
401 Unauthorized:最常见。原因通常是 APIKey 填错、Key 过期,或者 Key 和 Base URL 不匹配(比如把 A 平台的 Key 填到了 B 平台的地址上)。检查方法:回平台确认 Key 是否还有效,重新复制一次,注意别带多余空格。如果用的是 TaoToken 的 Key,确认 Base URL 是https://taotoken.net/api,两者要配套。
local proxy failed / 本地代理启动失败:一般是端口被占用,或者 CC Switch 没有权限监听本地端口。解决办法:换个端口,或者关掉占用该端口的程序。Windows 上有时是防火墙拦了,放行一下即可。还有一种情况是本地路由开关没打开,回去把localRoute打开。
reading choices 相关报错:这个通常出现在协议转换环节。choices是 OpenAI 响应里的字段,如果 CC Switch 按 OpenAI 协议解析但实际返回的不是这个结构,就会报读取choices失败。原因多半是协议类型选错了——你用的是 Anthropic 原生地址,却选了 OpenAI 协议。改回匹配的协议类型即可。反过来,用 OpenAI 地址却选了 Anthropic 格式,也会出类似问题。
OAuth 相关报错:如果你之前用 Claude Code 登录过 Anthropic 账号,本地可能残留了 OAuth 凭证,导致它优先走官方认证而不是你的本地路由。检查 Claude Code 的配置文件,确认它指向的是 CC Switch 的本地地址,而不是官方端点。必要时清掉旧的认证缓存重新配。
模型返回空或者乱码:检查 modelId 是否拼写正确,大小写敏感。有些平台的 modelId 带版本后缀,少一段就匹配不上。
排查顺序建议是:先确认 Key 和 Base URL 配套 → 再确认协议类型和地址格式匹配 → 再确认路由开关都开了 → 最后看端口和防火墙。按这个顺序走,大部分问题能定位到。
6. 后续怎么用:切换、扩展与长期方案
跑通之后,日常使用就是打开 CC Switch 确保供应商处于启动状态,然后正常用 Claude Code。想换回官方模型或者切到别的供应商,在 CC Switch 里点一下切换就行,不用改 Claude Code 的配置。这就是它比手动改配置文件方便的地方。
如果你后面想接更多模型做对比,或者免费额度到期后需要稳定的付费方案,可以了解下 TaoToken 的 Coding Plan,它面向长期编码和 Agent 场景,Base URL 同样是https://taotoken.net/api,配合 API Keys 页面生成的凭证使用。接入文档里有各语言的示例,模型对话入口可以先跑几个请求感受下响应质量。它的定位是把多个模型的接入统一起来,省得每换一个模型就重配一遍。
回到 Qwen3.6 这波活动,截止到月底,token 不限量,适合拿来跑一些批量任务或者日常的代码辅助。但要注意,免费额度通常有并发或者速率限制,别拿它跑高并发的生产任务。个人开发、学习、小项目验证是完全够的。
最后给个小技巧:把 CC Switch 的配置导出备份一份,换机器或者重装时直接导入,省得重新填。配置文件里含 Key,备份时注意别传到公开地方。另外,Claude Code 的项目级配置和 CC Switch 的全局配置是分开的,切换供应商不影响你项目里的其他设置,这点可以放心。