看了这个搜索组合,我就知道你大概率是在Windows上折腾AI编程工具链条:装好Claude Code这个终端里的编程Agent,再弄个CC Switch来回切换模型供应商,最后把DeepSeek V4 Pro塞进去用一个统一的API入口。这套配置对Windows用户来说,确实比MacOS那边多几个坑,主要是权限、网络代理、环境变量和Node版本这几个老问题。我最近刚在一台全新的Windows 11机器上完整跑了一遍这套链路,过程还算顺利,但中途也踩了几个不太常见的错。这篇文章把整个安装、配置、切换、排错的过程完整写出来,包括我在实际环境里碰到的问题和最终解决的参数,希望能帮你少走几趟弯路。
先说清楚这套东西是干什么的。Claude Code是Anthropic出的终端编程助手,你可以在Terminal里直接跟它对话,让它帮你读写代码。CC Switch则是一个很轻量的模型配置切换器,它的核心作用是维护好几个不同的API Provider配置,比如Anthropic官方、第三方中转、或者DeepSeek这类兼容OpenAI接口的模型地址,随时一键切换。而DeepSeek V4 Pro作为模型端,可以让你通过CC Switch统一接到Claude Code里用。这类组合最典型的场景就是:你想用Claude Code的交互和Agent能力,但出于成本、访问速度或者团队内部统一网关的考虑,后端并不想直接走Anthropic官方API,而是接到兼容层或者DeepSeek这样的第三方模型上。其中又以DeepSeek性价比高、代码理解能力强而出名。
这套方案适合谁?适合所有把Claude Code当作日常编码外挂、又希望以更低成本或更灵活方式控制模型供应商的开发者、测试和运维人员。也适合那些需要在同一台Windows机器上,在公司项目和个人项目之间来回切换不同模型的同学。如果你现在连“Claude Code装好了但一跑就报错”这一关都还没过,这篇对你同样有用。
下面直接上干货。
1. 动手之前先理清楚:CC Switch和Claude Code的关系
1.1 为什么不能只装一个Claude Code就完事
很多人第一次接触这套组合时会一脸懵:我明明装的是Claude Code,为什么还要装CC Switch?这两个东西难道不是重复的吗?
其实它们两个的角色完全不同。Claude Code是客户端,负责跟你在终端里对话、调工具、改代码,它像一个会操作代码的实习生。而CC Switch是一个配置管理工具,负责决定这个实习生背后连接的“大脑”到底是哪个模型、哪个API网关。没有CC Switch,Claude Code默认只能连Anthropic官方API,或者读环境变量里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。有了CC Switch,你可以把多套模型配置集中管理,而且可以随时热切换,不用反复改环境变量、重启终端。
我用一个生活比喻:Claude Code是房子里的全套智能家电,CC Switch是配电箱里的空气开关。你不需要为了换一个灯泡就重新拉一根电线,只需要把开关打到对应的那一路就行。
1.2 CC Switch的核心工作方式
CC Switch的原理并不复杂,它本质上是一个轻量级的本地代理服务,监听本机的一个端口(大部分情况下是127.0.0.1的某个随机端口)。当你把Claude Code的ANTHROPIC_BASE_URL指向这个本地代理地址时,Claude Code发出的请求会先到达CC Switch,再由CC Switch根据你选中的配置,转发到你指定的真实模型API端点上。
这个设计最大的好处是:Claude Code不用知道后端到底是Anthropic、DeepSeek还是某个私有网关。它只需要知道自己连接的是一个“长得像Anthropic API”的地址。CC Switch在后端把各种不同的协议、模型名、鉴权方式处理成Claude Code能理解的格式。
所以你在配置时要注意,CC Switch并不直接跟模型交互,它只是管道。管道的入口是Claude Code配置的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY,管道的出口是你在CC Switch各个Provider配置里填写的base_url、api_key和model字段。理解了这条链路,后面配置时才不会犯糊涂。
1.3 为什么DeepSeek V4 Pro是这套组合的常见搭配
DeepSeek V4 Pro在编码场景下很受欢迎,原因很简单:代码上下文理解能力强、推理速度尚可、而且token价格有优势。对重度使用Claude Code的人来说,如果每个Agent会话都走官方API,日积月累成本不小。把模型切到DeepSeek V4 Pro之后,日常的人工智能辅助编程成本会明显下降。
另外,DeepSeek提供的是OpenAI兼容的API端点。这也就意味着CC Switch配置DeepSeek时不走Claude Code的原生Anthropic协议,而是走一个兼容转换层。CC Switch会负责把Anthropic格式的请求转换为OpenAI格式,再发给DeepSeek。这一点是配置DeepSeek时比较容易踩坑的地方,后面我会详细说。
2. Windows环境下安装Claude Code的完整步骤
2.1 准备Node.js环境
Claude Code在Windows上并不是一个原生exe程序,它是以npm包形式分发的。所以在安装Claude Code之前,你的电脑上必须先有一个可用的Node.js环境。
我这里推荐直接去Node.js官网下载LTS版本的Windows安装包(目前是20.x或者22.x,越新越好),安装时一路默认即可。安装完成后打开PowerShell,输入下面三条命令验证环境是否正常:
node -v npm -v npx -v如果你能正常看到类似v20.11.1这样的版本号,那Node环节就通过了。如果提示node不是内部或外部命令,说明安装时没有把Node加入PATH,这时需要重新运行安装包,并且在自定义安装步骤里勾选“Add to PATH”。
一个我实际踩过的坑:如果你电脑上装有多个Node版本,比如用nvm-windows同时装了16和20,那么执行npm全局安装时,一定要确认当前默认版本是你想要的那个。Claude Code对Node版本有要求,太老的Node(16以下)会导致安装后运行直接报语法错误。
2.2 通过npm安装Claude Code
环境准备好之后,安装Claude Code本身很简单,只需要在PowerShell里执行一条命令:
npm install -g @anthropic-ai/claude-code全局安装之后,命令行里就会多出claude这个命令。你可以通过下面的命令确认安装结果:
claude --version如果能看到类似1.0.0之类的版本输出,说明安装成功。
这里有一个Windows特有的坑:如果你之前没有开启Windows Terminal或者PowerShell的执行策略,有可能会碰到claude.ps1无法加载,因为在此系统上禁止运行脚本这类报错。解决办法是管理员权限下执行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser但如果你是在Git Bash或者CMD里运行Claude Code,则基本不会遇到这个问题,因为CMD不经过PowerShell的ExecutionPolicy机制。
2.3 完成登录和基础鉴权
安装完成后,第一次在终端里输入claude,Claude Code会自动进入一个登录引导流程,正常情况下会提示你在浏览器里打开一个https://claude.ai/...的地址完成OAuth授权。
不过很多人在这一环节被卡住了,因为Claude Code的登录服务并不一定在所有网络条件下都通畅。这时你有两个选择:一个是继续通过claude命令尝试官方登录,但请注意,如果你是在非官方支持地区或受限网络下使用,这个OAuth流程很可能反复失败。
另一个选择是跳过OAuth登录,直接走API Key模式。Claude Code支持通过环境变量来跳过登录流程:
$env:ANTHROPIC_API_KEY="sk-ant-..."设置完之后再运行claude,就不会再弹浏览器登录页了。配合CC Switch时,这个API Key其实不一定要填真实可用的Anthropic官方Key,你可以填一个占位符,因为请求会通过CC Switch转发到其他供应商。但注意,在Claude Code的某些版本里,API Key格式校验比较严格,建议至少填成sk-ant-xxxxx的样子,避免被客户端拦截。
我个人在实际使用中更推荐:先不设置任何环境变量,等CC Switch配置好之后,把Claude Code的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY作为系统级环境变量统一设置好,这样最干净,也方便切换。
3. CC Switch的安装与初始配置
3.1 下载和安装CC Switch
CC Switch的安装比Claude Code还要简单,它本身就是一个自带界面的桌面级工具,你从官方GitHub Releases页面下载Windows版本安装包即可。一般会得到一个压缩包或者一个exe安装程序。如果是压缩包,解压后直接运行里面的可执行文件就行,不需要额外安装依赖。
值得注意的是,CC Switch在Windows上运行时建议以普通用户身份运行,不要动不动就“以管理员身份运行”。因为它要监听本地端口,虽然管理员权限更容易监听,但有时权限过高反而会触发某些安全软件拦截。如果你在别的电脑上遇到过“CC Switch启动后Claude Code连不上”的问题,先确认一下是不是被Windows Defender防火墙拦了。
需要单独说明的是:如果你下载的版本需要同时装有Claude Code才能识别配置,那安装顺序一定是先装Claude Code再装CC Switch。如果你先装了CC Switch再装Claude Code,某些版本的CC Switch在自动检测配置文件路径时可能会找不到目录,需要重启一次CC Switch才能正常识别。
3.2 配置一个Provider的基础结构
打开CC Switch之后,你会看到一个比较简洁的主界面。第一次使用时,界面上通常是空的,你需要手动添加一个Provider。
添加Provider时要填的核心字段不多,主要如下:
- 名称:随意填,比如“DeepSeek-V4-Pro”,这只是用来展示的。
- 类型:选择“Anthropic”或“OpenAI”。这个字段决定了CC Switch用什么协议去跟你的实际API后端通信。一般DeepSeek选择OpenAI。
- Base URL:这里填你实际模型API的地址。对于DeepSeek官方API来说,一般是
https://api.deepseek.com/v1。 - API Key:填写你在DeepSeek开放平台上申请的Key。
- Model:填写具体模型名,这里对应的是
deepseek-chat或者deepseek-reasoner。部分整合版本里,也可能会显示为deepseek-v4-pro。
我建议你把Provider的“名称”和“Model”分开思考。名称是CC Switch里的显示标签,而Model最终会写进Claude Code发给API的请求体里。也就是说,如果你在Provider列表中新建了一个名叫“DeepSeekV4Pro”的配置,那CC Switch把这个配置切换到当前生效状态时,会把这些信息映射到本地代理的响应中,Claude Code会话里看到的模型名也是由这些字段决定的。
3.3 本地代理的工作原理与端口占用
配置好Provider之后,CC Switch会在本机起一个本地代理服务,这个服务默认监听一个本地端口。以我使用的版本为例,默认地址通常是http://127.0.0.1:14555。当然,具体端口号取决于你下载的CC Switch版本和系统分配,你可以在CC Switch的设置页面里查看或修改。
这个本地代理端口非常重要,因为Claude Code要连的就是它。你需要在Claude Code的启动配置里,把ANTHROPIC_BASE_URL设置成这个本地地址,格式是:
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:14555"设置好之后,Claude Code发出的所有请求,全部会被CC Switch的本地代理接收并转发到真实API。你可以在CC Switch的界面上实时看到当前生效的Provider是哪一条,以及最近请求的日志。
本地代理还有一个好处是可处理“不同厂商的协议差异”。比如你配置的Claude Code环境变量里ANTHROPIC_API_KEY是个临时占位符,本地代理在转发请求时会自动替换成真实API Key,这样你就不用在多个终端窗口里反复切换环境变量了。
4. DeepSeek V4 Pro接入CC Switch的详细配置
4.1 第一步:拿到API Key和确认接口BaseURL
在配置任何模型之前,先去DeepSeek开放平台注册账号并创建API Key。创建好之后,你会得到一个形如sk-...的字符串。这个Key就是后面CC Switch要替你保管的核心机密。请注意,DeepSeek有时候会把API Key明文显示在页面上,但只显示一次,所以务必立刻复制保存。
同时你还需要确认你使用的DeepSeek接口地址。这里有个常见误区:很多人把Base URL填成了https://api.deepseek.com,但你会发现请求总是报404或者路由找不到。通常给OpenAI兼容客户端用的地址需要加/v1后缀,也就是https://api.deepseek.com/v1。如果你在CC Switch里填错了Base URL,启动之后日志里往往会显示类似404 not found或者路径不存在的报错。
4.2 第二步:在CC Switch新建DeepSeek Provider配置
打开CC Switch,点击“新建Provider”或“添加配置”,然后按下面这张表的参数来填:
| 配置字段 | 推荐值 | 说明 |
|---|---|---|
| 名称 | DeepSeek-V4-Pro | 仅用于在CC Switch中识别 |
| 类型 / 协议 | OpenAI | DeepSeek接口兼容OpenAI格式 |
| Base URL | https://api.deepseek.com/v1 | 注意末尾不要带多余的斜杠 |
| API Key | sk-你的真实Key | 保存在CC Switch内部 |
| Model | deepseek-chat 或 deepseek-v4-pro | 以你实际拿到的模型名为准 |
这里重点提醒:填Base URL时,不要复制官网首页的地址,一定要用接口文档里给出的完整路径。我实际见过不少人在这一步把https://api.deepseek.com填进去,然后CC Switch转发时就在/responses接口上报错。正确做法是请求https://api.deepseek.com/v1/chat/completions这样的完整路径才符合OpenAI SDK的默认拼接规则。
4.3 第三步:让CC Switch在当前Provider和DeepSeek之间建立映射
配置好Provider之后,回到CC Switch主界面,确保当前选中的Provider就是刚建好的DeepSeek配置。有些版本里,你需要点击一下配置条目右侧的“启用”或“应用”按钮,才会真正生效。
这时CC Switch会启动本地代理并开始监听端口。你可以通过访问代理的健康检查地址来确认代理是否正常,比如在浏览器打开http://127.0.0.1:14555,如果能正常返回一个类似{“status”: “ok”}的JSON,说明代理已经在工作了。
然后,打开PowerShell,设置Claude Code环境变量,让Claude Code把请求发到这个代理上:
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:14555" $env:ANTHROPIC_API_KEY="sk-ant-placeholder"注意,这里的ANTHROPIC_API_KEY并不需要是真实的Key,因为真实Key已经存在CC Switch的配置里了。但Claude Code客户端会校验Key格式,所以不要直接留空。填一个sk-ant-xxx的占位符是最稳妥的。
设置完成后,重新启动claude,你就应该能在CC Switch的日志里看到请求被转发到DeepSeek的记录。Claude Code的回复,也不再是来自Anthropic官方模型,而是DeepSeek模型输出。
4.4 第四步:把环境变量固化到系统里
每次打开Terminal都重新设置一遍环境变量显然不现实,所以你要把这两个变量写进系统环境变量里。具体操作是:按下Win键搜索“环境变量”,打开“编辑系统环境变量”,在“环境变量”选项卡里新建两个用户变量:
变量名: ANTHROPIC_BASE_URL 变量值: http://127.0.0.1:14555变量名: ANTHROPIC_API_KEY 变量值: sk-ant-placeholder保存之后,重新打开PowerShell,输入claude,应该就能直接连上CC Switch了。这样配置的好处是,哪怕你有多个终端窗口,只要是同一个Windows用户,环境变量都会自动生效,不需要每个窗口都重复设置。
4.5 关于DeepSeek V4 Pro模型名的补充说明
你可能注意到我上面写了deepseek-chat和deepseek-v4-pro两个候选模型名。这取决于你申请到的API账号看到的模型列表。在DeepSeek官方平台,模型名一般就是平台上展示的名字,比如deepseek-chat对应的是通用对话模型,而deepseek-reasoner对应的是推理增强模型。如果你拿到的是某个内部版本或者较新的V4 Pro版本,那么模型名可能会直接是deepseek-v4-pro。
为了避免“模型不存在”的报错,建议在配置之前先简单用curl测试一下你的API Key和模型名是否可用。命令如下:
curl https://api.deepseek.com/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的真实Key" \ -d '{"model":"deepseek-v4-pro","messages":[{"role":"user","content":"你好"}]}'如果返回了正常的JSON回复,那说明Key和模型名都没问题,可以放心写进CC Switch配置里。如果返回model not found之类的错误,就去控制台查一下你账号名下到底有哪些可用模型。
5. 实战中遇到的错误与排查方法
5.1 CC Switch本地代理报错:404 not found
我在实际配置过程中,遇到最多的就是类似这样的错误:
CC Switch local proxy failed while handling codex endpoint /responses: ... unexpected status 404 not found这个报错的直接原因是:Claude Code发起了对新版/responses接口的请求,但你在CC Switch配置的Provider指向的真实API后端不支持该路径。尤其是你把Provider类型选成了Anthropic,而后端其实是一个OpenAI兼容的DeepSeek接口时,就会导致路径映射出错。
解决办法有两个方向。第一方向:检查CC Switch里Provider的“类型”是否选择正确。DeepSeek类型请一定选择OpenAI。第二方向:如果CC Switch版本较老,需要在配置中手动指定接口路径映射,比如在Provider设置里找到类似“自定义请求路径”或“接口风格”的选项,将其调整为Chat Completions风格,而非Responses风格。
另一种可能是Base URL填写不完整。比如只填了https://api.deepseek.com,少了/v1,那么发起请求时拼接出来的完整URL就会是https://api.deepseek.com/v1,但其真正期望的可能是https://api.deepseek.com/v1,这个情况下更多是响应体解析错误而不是404。若你填写的Base URL本身就缺少路径前缀,最终拼接的路径很可能对不上DeepSeek的接口格式。
5.2 401 unauthorized错误
unexpected status 401 unauthorized这个错误表示鉴权失败。大多数情况下是因为Claude Code发出的请求带过去的API Key是环境变量里设置的占位符,而CC Switch没有成功把这个占位符替换成真实Key。
请重点检查CC Switch当前选中的Provider是否真的是带正确Key的那个,以及Provider配置里的API Key字段是否为空。另外,如果你同时安装了多个配置,CC Switch可能会有缓存,切换配置后需要退出并重启CC Switch进程,确保重新加载了最新Key。
从我个人经验看,Windows上最容易出现401的原因不是Key本身错误,而是环境变量里设置的ANTHROPIC_API_KEY覆盖了CC Switch注入的Key,导致后端收到的是sk-ant-placeholder,而不是真实Key。遇到这种情况,你可以将环境变量里的ANTHROPIC_API_KEY临时改成一个空字符串或者直接删除,让Claude Code尽可能采用CC Switch中转后的Key。
5.3 502 bad gateway错误
502 bad gateway错误说明CC Switch本身是正常工作的,但它在尝试访问真实后端API时连接失败或超时。这种错误通常跟网络环境有关,跟配置本身关系不大。
你可以分两步排查。第一步,肉眼确认CC Switch的日志里显示的出站请求地址是https://api.deepseek.com/v1,而不是其他诡异地址。第二步,在浏览器或者curl里直接请求DeepSeek的API,看看能否返回正常结果。如果curl正常但CC Switch总是502,可能是CC Switch与DeepSeek服务之间有SSL握手的问题,这时可以尝试在Provider配置的Base URL里把https改成http测试一下(不过一般不建议生产环境这么做,仅用于定位问题)。
5.4 503 service unavailable错误
503 service unavailable表示目标API服务端暂时不可用,或者过载了。如果是DeepSeek官方API返回503,大概率是平台侧负载较高,换个时间段再试即可。如果是在用企业内部网关或者第三方中转服务,则需要确认网关配置的限流策略。
不过还有一种常见情况:CC Switch在Windows上启动时,默认后台监听127.0.0.1端口,但Claude Code是一个Node进程,在发起请求时可能选择走系统代理策略。如果系统里设置了HTTP代理,Node的fetch请求就可能被代理接管,从而访问不到本机代理所在的服务,进而报出“connection refused”或“503”。这类“本机代理”,必须确认Claude Code发给CC Switch的流量没有绕道系统HTTP代理。在Windows上我建议用如下命令临时禁用系统代理再测试:
$env:NO_PROXY="127.0.0.1,localhost"这个环境变量可以让Node请求跳过系统代理直达本地端口。
5.5 Claude Code提示“not available in your country”
如果Claude Code在启动时提示claude code might not be available in your country. check supported countries...,这通常是官方客户端在初始化时对所在地网络出口IP做了一次合规检查,结果被判断不可用。官方的判断依据一般是出口IP的geo信息。
遇到这种情况,首先要正视:你的网络环境不一定能稳定访问官方Claude Code服务。但这不代表你无法使用Claude Code,因为Claude Code有一个所谓的“本地模式”或“BYOK(自备密钥)模式”。通过配置ANTHROPIC_BASE_URL指向本地代理或第三方兼容网关,客户端本身的网络检查会提前中断,Claude Code就不会继续去请求Claude官方相关服务,而是直接走本地代理。
我实测下来,比较有效的做法是:先设置好ANTHROPIC_BASE_URL为CC Switch的本地地址,然后再启动claude,此时初始化流程会跳过部分与官方服务器交互的步骤,不再出现这个国家限制提示。这句话我加粗,因为这是整套配置中非常关键的一环。如果第一次启动还是提示不可用,可以做一次claude doctor环境诊断,再确认环境变量是否已经正确加载。
5.6 端口被占用导致无法启动CC Switch
Windows上还有一个特别高频的问题:CC Switch启动后提示端口被占用,或者Claude Code连不上本地代理。
排查方法很简单。先看你的CC Switch配置的端口是多少,然后打开PowerShell执行:
netstat -ano | findstr 14555如果输出里有非你预期进程的PID占用了端口,那就可以根据PID去任务管理器里找到占用进程,结束它,或者修改CC Switch的监听端口。
我遇到过最无语的情况:之前装过一个别的模型转发工具,悄悄占用了14555端口,导致CC Switch启动时没有报错,但实际监听失败,Claude Code怎么都连不上。后面我用netstat一查才发现,这根本不是同一个进程。所以在排错顺序上,端口占用一定要优先排查。
6. 多模型配置与日常切换技巧
6.1 同时配置Anthropic官方和DeepSeek
做开发的人通常不会只用一个模型。我自己在工作机上就同时配置了两套Provider:一套是Anthropic官方API,用于正式代码审查和复杂重构;另一套是DeepSeek V4 Pro,用于日常对话、脚本生成和比较机械的增删改查。
这套组合在用CC Switch时非常灵活。我在CC Switch里建了两个配置:一个叫“Anthropic官方”,一个叫“DeepSeekV4Pro”。当我在公司项目上写代码,需要更多上下文理解时,就切换到官方API;当我在处理临时脚本、批量修改文本这类低风险任务时,就切到DeepSeek。
切换操作在CC Switch界面上只要点一下对应的配置条目,再点“应用”按钮即可。切换完成后,CC Switch的本地代理端口不变,环境变量不变,所以不需要重启Claude Code。但需要注意,当前已经打开的claude会话可能还保留着上一次的上下文连续状态,如果连续发送消息,模型名不会改变,新的请求才会走新的Provider。要想让新配置生效,最干净的方法是退出当前claude会话,重新输入claude再开一个新会话。
6.2 使用CC Switch的命令行方式切换配置
有些进阶用户跟我一样,习惯完全用键盘操作,不太喜欢在GUI里点来点去。其实CC Switch在Windows版本里也提供了一些命令行的联调接口。具体看你装的版本,你可以尝试在PowerShell里执行:
cc-switch list cc-switch use DeepSeekV4Pro如果命令不可用,检查CC Switch安装目录下是否有一个命令行辅助程序,或者干脆用GUI方式先切换到默认配置,然后写一个简单的PowerShell脚本调用CC Switch的配置文件接口。
不过个人建议:日常切换用GUI足够,没必要为了酷炫去折腾命令行。毕竟CC Switch本身是一个桌面工具,GUI响应速度已经很快了。
6.3 给CC Switch配置加一个自定义环境变量映射
在某些特殊场景下,你可能希望Claude Code用不同的ANTHROPIC_MODEL请求不同的模型名。比如想让Claude Code在对话中显示成DeepSeek V4 Pro,而不是通用API模型名。
对于这个需求,你可以在CC Switch的Provider配置里找到“模型映射”或“Model Mapping”一栏。把模型名设置成deepseek-v4-pro。这样Claude Code内部拿到的模型名就是统一的deepseek-v4-pro,对话里也不会串味。
6.4 调整Claude Code的系统提示和上下文上限
DeepSeek V4 Pro和Anthropic系列模型在系统提示(System Prompt)处理和上下文窗口大小上可能存在差异。如果你在Claude Code中使用DeepSeek,常常会发现它的回应风格更加简短直接,没有Anthropic模型那种“过度礼貌”的铺陈感。这不是问题,反而在自动化操作时更干脆。
但是,如果你发现DeepSeek模型在某些复杂任务里理解不了太多上下文,可以适度调整Claude Code的上下文限制参数。在Claude Code里,可以使用/config进入设置界面,调整maxTokens或上下文相关选项。我在项目比较大时,会选择把上下文窗口调低一些,减少token浪费,因为DeepSeek虽然便宜,但上下文过长时输出质量也会下降。
7. 常用命令和配置速查表
7.1 Cli常用命令
| 命令 | 用途 |
|---|---|
claude | 启动Claude Code |
claude --version | 查看版本号 |
claude doctor | 环境诊断,查看Node、配置等信息 |
claude --help | 列出所有可用命令 |
claude /clear | 在会话内清空上下文 |
claude /config | 打开交互式配置 |
7.2 环境变量速查
| 变量名 | 值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | http://127.0.0.1:14555 | CC Switch本地代理地址 |
ANTHROPIC_API_KEY | sk-ant-placeholder | 占位符,真实Key由CC Switch替换 |
NO_PROXY | 127.0.0.1,localhost | 避免流量被系统代理拦截 |
7.3 CC Switch常见配置项说明
| 配置项 | 作用 | 注意点 |
|---|---|---|
| Base URL | 真实API端点地址 | 留意是否带/v1路径 |
| API Key | 供应商鉴权凭证 | 不要使用Claude Code占位符Key |
| Model | 模型名称 | 必须跟平台开通的模型一致 |
| Provider类型 | 协议转换方式 | DeepSeek选OpenAI兼容协议 |
7.4 Windows系统代理干扰的规避
我在安装时还碰到过一个非常隐蔽的问题:虽然我设置了ANTHROPIC_BASE_URL=http://127.0.0.1:14555,但Claude Code发出的请求仍然不走这个地址,而是走到了某个外部代理服务器上。这是因为Node.js环境默认读取了系统全局代理设置。
解决办法有两个。第一个:在PowerShell里为当前终端窗口设置NO_PROXY环境变量。第二个:在Windows系统设置里,打开“设置 → 网络和Internet → 代理”,手动把本地地址localhost和127.0.0.1加入“请勿对以下地址使用代理”的列表。这样Claude Code的请求就能直连CC Switch本地端口。
8. 一些心里话和小技巧
这整套配置折腾下来,我发现Windows上安装Claude Code其实不难,最难的反而是“让Claude Code愿意跟CC Switch说话”。这个“愿意”的背后,是环境变量、端口、代理、协议转换、鉴权替换一系列链路都要对上。任何一个环节断了,终端里都会冒出一堆看似莫名其妙的错误。
我的建议是:从安装一开始就尽量保持“最小链路”。也就是说,先只配置Claude Code和CC Switch,用最简单的Provider(比如官方Anthropic)跑通一次,然后再加入DeepSeek V4 Pro的配置。不要一上来就直接把所有配置写满,否则出错时你连是哪个环节的问题都搞不清楚。
在实际使用中,我最喜欢CC Switch的一点是,它把平时会分散在终端、环境变量、配置文件里的所有模型信息,收敛到了一个小界面里。以前我需要保存好几个不同的API Key和Base URL,现在只需要在CC Switch里维护一个列表,切换模型就只是点一下的事。
如果你是重度Claude Code用户,建议把你的配置信息另外备份一份。CC Switch的配置文件是存在本地的,找到它的配置目录后,可以把配置文件复制到网盘或者Git私有仓库,方便换电脑时快速恢复。我自己就因为这个操作,在换新笔记本时省掉了很大的重复配置时间。
最后再分享一个小技巧:如果你发现Claude Code在Windows上第一次启动很慢,可以先在PowerShell里执行一次claude --version预热一下,后续启动会明显变快。这个小问题通常是因为模块加载缓存还没建立,跑过一次之后就顺了。
以上,就是我在Windows上从零到一完成“Claude Code + CC Switch + DeepSeek V4 Pro”整套配置的完整记录。这套组合日常写代码、改脚本、分析项目结构都非常顺手,尤其是将模型切换能力掌握在自己手里之后,工作流的灵活性提升了一大截。如果你也在配置中遇到了奇妙报错,欢迎对照这篇内容逐层排查,大部分问题都能在“配置映射”和“本地代理链路”这两个大方向上找到答案。