ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Claude Code 快速安装并接入 DeepSeek-V4-pro 教程:用 cc-switch 管理多模型配置

Claude Code 快速安装并接入 DeepSeek-V4-pro 教程:用 cc-switch 管理多模型配置 1. Windows 下 winget 安装 Claude Code 与 cc-switch 多模型切换实战Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接在命令行里读写文件、执行命令、跑测试适合习惯在终端里干活的开发者。而 DeepSeek-V4-pro 是 DeepSeek 系列里推理能力较强的模型长上下文和代码理解都不错。把这两者接起来再配合 cc-switch 做多模型配置管理就能在同一个 Claude Code 界面里随时切换不同模型不用每次手动改环境变量。这篇教程聚焦 Windows 环境从 winget 安装 Claude Code 开始到用 cc-switch 接入 DeepSeek-V4-pro再到实际对话验证每一步都给可复制的命令和配置。如果你之前装 Claude Code 时遇到 npm 报错、权限问题或者想同时管理多个模型配置这篇会比较对路。适合谁Windows 上做开发、想用 Claude Code 但不想被单一模型绑死、愿意花十分钟搭好环境的同学。我试过在 Windows 上用 npm 全局装 Claude Code结果卡在权限和 node 版本上后来换 winget 一次就过了。所以下面优先走 winget 路线。1.1 为什么选 winget 而不是 npmClaude Code 官方文档给了几种安装方式Windows 上常见的是 npm 全局安装和 winget 安装。npm 方式需要你先有 Node.js 环境而且全局安装经常碰到 EACCES 权限问题尤其是没开管理员权限的 PowerShell 里。winget 是 Windows 自带的包管理器安装路径和依赖都由系统管省心不少。先确认 winget 可用。打开 PowerShell输入winget --version如果返回类似v1.6.xxxx的版本号说明可用。如果提示找不到命令去 Microsoft Store 搜「应用安装程序」更新一下。接着装 Claude Codewinget install Anthropic.ClaudeCode安装过程会下载并配置好可执行文件。装完后新开一个 PowerShell 窗口重要否则 PATH 没刷新验证claude --version正常会输出类似2.1.137 (Claude Code)的版本信息。看到这个就说明 Claude Code 本体装好了。1.2 cc-switch 是什么为什么要用它Claude Code 默认走 Anthropic 官方接口但它的配置支持通过环境变量或配置文件指向兼容接口。问题在于如果你要同时用官方模型、DeepSeek、其他兼容模型每次切换都得改ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY手动改容易出错也记不住哪个 key 对应哪个模型。cc-switch 就是解决这个的开源小工具它提供一个图形界面让你把多套配置存起来点一下就能切换当前 Claude Code 用的是哪套。配置里包含 Base URL、API Key、Model ID 三件套切换后 Claude Code 读到的就是新配置。去 cc-switch 的 GitHub Releases 页面拉到最底部找到 Windows 版本比如CC-Switch-v3.14.1-Windows.msi下载后双击安装。安装完打开界面里可以「添加」配置。1.3 拿到 DeepSeek-V4-pro 的 API Key接入前需要先有 DeepSeek 的 API Key。登录 DeepSeek 开放平台在 API Keys 页面创建一个新的 key复制保存好只显示一次。同时确认账户里有余额否则请求会返回余额不足的错误。DeepSeek 的接口是 OpenAI 兼容格式Claude Code 通过 Anthropic 兼容层访问时需要把 Base URL 指向兼容端点。这里我们用 TaoToken 作为统一接入层它提供 Anthropic 兼容接口Claude Code 可以直接对接。TaoToken 的 API 地址是https://taotoken.net/api官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。在 TaoToken 控制台创建 API Key后面 cc-switch 配置里会用到。2. cc-switch 配置文件详解与 DeepSeek-V4-pro 接入这一节把 cc-switch 里要填的东西拆开讲清楚包括 Base URL、API Key、Model ID 三件套分别填什么以及配置文件长什么样。很多人卡在「填了但连不上」多半是 Base URL 多了或少了路径或者 Model ID 写错。2.1 三件套Base URL、API Key、Model IDClaude Code 通过 Anthropic 协议发请求请求会打到ANTHROPIC_BASE_URL指向的地址。TaoToken 的 Anthropic 兼容端点是https://taotoken.net/api注意不要在后面多加/v1或/messagesClaude Code 会自己拼路径。API Key 用你在 TaoToken 控制台创建的那个通常以sk-开头。Model ID 填 DeepSeek-V4-pro 对应的标识常见写法是deepseek-v4-pro[1m]其中[1m]表示 1M 上下文版本如果只要标准版用deepseek-v4-pro即可。轻量任务可以用deepseek-v4-flash。在 cc-switch 里点「添加」供应商名称随便填比如DeepSeek-V4-pro然后填字段值Base URLhttps://taotoken.net/apiAPI Key你的 TaoToken Keysk- 开头Modeldeepseek-v4-pro[1m]保存后cc-switch 会把这套配置写入 Claude Code 读取的配置文件。Claude Code 在 Windows 上读取的配置路径通常是用户目录下的.claude/settings.jsoncc-switch 切换时会更新里面的env段。2.2 可复制的 settings.json 片段如果你想手动确认或直接改配置文件路径是C:\Users\你的用户名\.claude\settings.json内容结构如下把 Key 换成你自己的{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey, ANTHROPIC_MODEL: deepseek-v4-pro[1m], ANTHROPIC_SMALL_FAST_MODEL: deepseek-v4-flash } }ANTHROPIC_MODEL是主模型ANTHROPIC_SMALL_FAST_MODEL是处理轻量任务比如生成标题、简单补全时用的快模型。两个都填上Claude Code 会根据任务自动选。如果你用 cc-switch 管理就不用手动改这个文件切换配置时它会帮你写。但知道文件在哪出问题时能直接看当前生效的是什么。2.3 用 cc-switch 切换并确认生效在 cc-switch 界面里选中刚添加的DeepSeek-V4-pro配置点「切换」或「应用」。切换后cc-switch 通常会提示当前激活的配置。此时回到 PowerShell运行claude进入 Claude Code 交互界面。第一次启动会让你选颜色主题随便选一个回车即可。进入后输入/status或直接问一句看它用的模型是不是 DeepSeek。如果 cc-switch 切换后 Claude Code 没生效检查两点一是 cc-switch 是否真的写入了settings.json打开文件看env段二是当前 PowerShell 是否在切换前就已经启动了 claude 进程环境变量在进程启动时读取切换后要重开 claude。3. 验证请求对话测试与 skill 加载配置填完不算完得实际发一次请求确认链路通。这一节演示怎么在 Claude Code 里验证 DeepSeek-V4-pro 是否真的在工作以及怎么加载 skill 做实际任务。3.1 发一条测试对话在 PowerShell 里进入一个空文件夹比如mkdir demo cd demo claude进入 Claude Code 后直接输入你好请用一句话说明你当前使用的模型名称和上下文长度。如果配置正确它会返回类似「我是 DeepSeek-V4-pro支持 1M 上下文」的回复。如果返回 401 或认证错误说明 API Key 不对如果返回 model not found说明 Model ID 写错了如果卡住不动多半是 Base URL 不通。也可以让它做点实际的事比如创建一个文件在当前目录创建一个 hello.txt内容写 DeepSeek-V4-pro via Claude Code。Claude Code 会请求权限执行写文件操作按提示确认。执行完ls一下能看到hello.txt就说明工具调用链路也通了。3.2 加载 skill 做 PPT 生成Claude Code 支持 skill 机制把预定义的技能包放到~/.claude/skills/目录下就能通过自然语言触发。比如下载guizang-ppt-skill解压后放到C:\Users\你的用户名\.claude\skills\guizang-ppt-skill注意文件夹名要去掉-main后缀里面应该包含SKILL.md、assets/、references/。放好后在 Claude Code 里输入帮我安装 guizang-ppt-skill 这个 skill。请确认 ~/.claude/skills/guizang-ppt-skill/ 目录下能看到 SKILL.md、assets/、references/ 三项。它会执行ls验证并告诉你安装好了。之后你说「做一份杂志风 PPT」就会触发这个 skill。生成过程中会有多次权限申请确认即可。中间可能出现「文件夹不存在」之类的非致命错误Claude Code 会自己创建不用管。生成完成后demo 文件夹里会多出一个 ppt 目录里面有.html文件浏览器打开就是网页版 PPT。想转成可编辑的 PPTX告诉它把这个网页 PPT 转成可编辑的 PPTX 文件保存到桌面。桌面上就会出现.pptx文件用 PowerPoint 打开可以继续编辑。4. 常见报错排查401、local proxy failed、reading choices接入过程中最容易碰到几类报错这里逐个对照原因和解决办法。遇到报错先别急着重装按下面的顺序排查通常能定位。4.1 401 认证失败报错长这样API Error: 401 {error:{message:Invalid API key,type:authentication_error}}原因API Key 填错、过期或者复制时带了空格。解决打开settings.json检查ANTHROPIC_API_KEY确认是完整的sk-开头字符串前后无空格。如果用的是 cc-switch重新在界面里粘贴一次 Key 再切换。另外确认 Key 是在 TaoToken 控制台创建的且账户有余额。4.2 local proxy failed 或连接超时报错Error: connect ECONNREFUSED 127.0.0.1:xxxx local proxy failed原因Claude Code 尝试走本地代理端口但那个端口没有服务在跑。常见于之前设置过HTTP_PROXY或HTTPS_PROXY环境变量残留下来。解决在 PowerShell 里检查echo $env:HTTP_PROXY echo $env:HTTPS_PROXY如果有值且不是你需要的清掉Remove-Item Env:HTTP_PROXY Remove-Item Env:HTTPS_PROXY然后重开 claude。另外确认 Base URL 是https://taotoken.net/api不要写成http://或带多余路径。4.3 reading choices 报错报错Error reading choices: unexpected end of JSON input原因接口返回的不是预期 JSON通常是 Base URL 路径不对请求打到了错误端点返回了 HTML 或空响应。解决确认ANTHROPIC_BASE_URL是https://taotoken.net/api末尾没有斜杠也没有/v1。如果手动改过配置恢复成上面 §2.2 的片段。4.4 OAuth 相关报错报错OAuth error: invalid_grant原因Claude Code 尝试走 Anthropic 官方 OAuth 登录流程但你用的是第三方兼容接口不需要 OAuth。解决确认settings.json里设置了ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY并且没有残留的 OAuth token 文件。如果之前登录过官方账号可以删掉~/.claude/下的凭据缓存文件再试。4.5 模型名不识别报错model: deepseek-v4-pro not found原因Model ID 拼写错误或者该模型在当前接入层不可用。解决确认写成deepseek-v4-pro[1m]或deepseek-v4-pro注意方括号是英文半角。如果还不行换成deepseek-v4-flash测试排除是模型名问题还是链路问题。5. 多模型配置管理与长期使用建议环境搭好只是开始日常用起来还得考虑多模型切换、配置备份、skill 维护这些事。这一节聊几个实用习惯。5.1 用 cc-switch 管理多套配置cc-switch 的价值在于你可以存多套配置一套 DeepSeek-V4-pro 做主力一套 DeepSeek-V4-flash 做快速任务一套其他兼容模型做备用。切换时点一下就行不用改文件。建议给每套配置起清晰的名字比如DeepSeek-Pro-1M、DeepSeek-Flash避免时间久了分不清。切换后记得重开 Claude Code 进程因为环境变量在启动时读取。如果你经常切换可以写个简单的 PowerShell 函数切换后自动重启 claude。5.2 配置备份与迁移settings.json和~/.claude/skills/目录是核心资产。换机器时把这两个东西拷过去基本就能恢复环境。skills 目录可能比较大建议只备份自己常用的几个。settings.json 里含 API Key备份时注意别传到公开仓库。如果团队多人用可以把 skill 包放到共享目录各自拷到自己的~/.claude/skills/下。配置里的 Key 各自用自己的不要共用。5.3 长期编码任务用 Coding Plan如果你打算把 Claude Code 当日常主力编码工具长期跑 Agent 任务、批量改代码建议了解一下 TaoToken 的 Coding Plan。它针对长时间、高频次的编码场景做了优化比按量计费更适合持续使用。具体可以看 TaoToken 控制台里的套餐说明。对于偶尔用用的场景按量计费就够了。关键是先把环境跑通确认模型输出质量符合预期再决定要不要上长期方案。5.4 skill 维护小技巧skill 装多了之后~/.claude/skills/会变得杂乱。建议定期清理不用的每个 skill 文件夹保持结构完整SKILL.md必须在根目录。如果 skill 触发不灵先检查文件夹名是否和 skill 内部声明的一致以及SKILL.md里的触发词是否覆盖了你的说法。另外skill 执行过程中如果频繁报权限错误可以在 Claude Code 里调整权限设置或者把常用操作加入白名单减少每次确认的打扰。6. 从安装到跑通一条可复制的完整路径把前面的步骤串起来完整路径是这样的winget 装 Claude Code装 cc-switch在 TaoToken 控制台创建 API Keycc-switch 里填 Base URLhttps://taotoken.net/api、Key、Modeldeepseek-v4-pro[1m]切换配置重开 PowerShell进 demo 文件夹跑claude发测试对话确认模型再加载 skill 做实际任务。这条路径里最容易出问题的是 Base URL 和 Model ID 两个字段以及切换配置后没重开进程。把这两点记住基本能避开大部分坑。如果你在验证模型输出质量可以到 TaoToken 的模型对话页面直接试对比不同模型的表现。接入文档里有更详细的参数说明和示例遇到不确定的字段可以去查。需要管理 Key 就去 API Keys 页面创建、删除、查看用量都在那。跑通之后你可以把 demo 文件夹删掉正式项目里直接用。Claude Code 在项目根目录启动时会读取当前目录的文件作为上下文所以进项目文件夹再跑claude就行。DeepSeek-V4-pro 的 1M 上下文在处理大文件、长日志时比较有优势日常小任务用 flash 模型更快更省。
返回列表