1. Windows 上跑 Claude Code 到底卡在哪从 Git Bash 到 Node.js 的完整链路很多人第一次在 Windows 上装 Claude Code卡住的地方往往不是 Claude Code 本身而是它依赖的两个前置件Git Bash 和 Node.js。Claude Code 是一个跑在终端里的 AI 编程助手它能读你项目里的文件、执行命令、改代码但它的运行方式是类 Unix 的Windows 自带的 CMD 和 PowerShell 在路径处理、脚本执行策略上和它配合起来经常出岔子。Git Bash 提供了一套类 Linux 的命令行环境Node.js 则是 Claude Code 的运行底座缺一个都跑不起来。这篇文章面向的是刚接触 Claude Code、想在 Windows 本地把第一个对话请求跑通的人。我会从 Git Bash 安装讲到 Node.js 环境验证再到 cc-switch 多模型切换和 DeepSeek 接入每一步都给可复制的命令和配置片段。你跟着做最后能在终端里看到 Claude Code 正常回你话并且知道它当前用的是哪个模型。先说清楚这套链路的关系你在 Git Bash 里敲claude命令Claude Code 这个 Node.js 程序启动它读取你的 settings 配置拿到 API Base URL、API Key 和 Model ID然后向对应的模型服务发请求。cc-switch 的作用是帮你管理多套这样的配置一键切换不同模型提供商不用每次手动改配置文件。理解了这个链路后面每一步你都知道自己在干什么。我实测下来Windows 上最容易出问题的三个点一是 Node.js 装完npm -v报执行策略错误二是 Claude Code 装完claude -v找不到命令三是 cc-switch 配好之后 Claude Code 还是走默认通道。这三个坑后面都会给排查方法。2. 前置准备Git Bash 与 Node.js 安装验证的完整步骤2.1 安装 Git BashGit Bash 是 Git for Windows 自带的终端环境。打开 Git 官网下载页选 64 位安装包双击 exe 一路 Next 用默认选项即可。安装完成后在桌面空白处右键菜单里出现 Open Git Bash here 就说明装好了。点开它你会看到一个黑底白字的命令行窗口这就是后面所有操作的入口。验证 Git 是否可用在 Git Bash 里输入git --version能返回类似git version 2.4x.x就通过了。2.2 安装 Node.jsClaude Code 基于 Node.js 开发没有它跑不起来。去 Node.js 官网选 LTS 长期支持版不要选 Current 尝鲜版。下载 msi 安装包后双击一路 Next其中有一个 Tools for Native Modules 页面把复选框勾上它会顺带装一些编译工具后面装某些 npm 包时用得到。装完后回到 Git Bash验证两条命令node -v npm -v正常会返回v20.x.x和10.x.x这样的版本号。如果npm -v报错提示类似 无法加载文件因为在此系统上禁止运行脚本这是 PowerShell 执行策略的问题。以管理员身份打开 PowerShell运行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 回车然后回到 Git Bash 重新跑npm -v即可。2.3 安装 Claude Code环境就绪后安装 Claude Code 只需要一条命令。在 Git Bash 里输入npm install -g anthropic-ai/claude-code-g表示全局安装装完后在任何目录都能调用claude命令。如果下载慢可以换国内镜像源npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com安装完成后验证claude --version能返回版本号就说明 Claude Code 已经装好了。如果提示claude: command not found检查 npm 全局安装路径是否在系统 PATH 里可以用npm config get prefix查看全局路径把它加到环境变量中。2.4 整体环境自检在进入配置之前把四条命令依次跑一遍全部返回版本号才算环境完整git --version node -v npm -v claude --version这一步别跳过。我见过不少人 Claude Code 装完直接去配模型结果请求发不出去回头排查发现是 Node.js 版本太旧或者 Git Bash 没装对。先把地基打牢后面省很多事。3. cc-switch 配置 DeepSeek可复制的 settings 与多模型切换实践3.1 为什么需要 cc-switchClaude Code 默认走 Anthropic 官方通道需要海外支付方式和对应的 API Key对国内用户门槛不低。cc-switch 是一个模型切换工具它帮你管理多套模型提供商配置一键切换。你可以同时配好 DeepSeek、其他兼容 OpenAI 格式的模型需要哪个切哪个不用手动改配置文件。cc-switch 的安装包在 GitHub 上有发布国内下载慢的话可以用镜像站。Windows 用户下载.msi安装包双击一路 Next。装完后建议以管理员身份运行因为它需要修改 Claude Code 的配置文件权限不够会写不进去。3.2 获取 DeepSeek API Key打开 DeepSeek 官网注册登录进入控制台找到「API Keys」或「密钥管理」点「创建 API Key」起个名字比如claude-code复制生成的密钥字符串。这个 Key 只显示一次关掉就看不到了先存好。新用户一般有免费额度可以先体验。模型选择上DeepSeek 提供不同档位的模型推理能力强的适合复杂重构和大型项目理解响应快、价格低的适合日常编码和快速问答。根据你的场景选。3.3 在 cc-switch 中配置打开 cc-switch点「添加提供商」如果列表里有 DeepSeek 直接选没有就选「自定义 Provider」或「OpenAI Compatible」因为 DeepSeek 的接口兼容 OpenAI 格式。然后按顺序填三项配置项填写内容API Base URLhttps://api.deepseek.comAPI Key你复制的 DeepSeek 密钥Model ID你选定的 DeepSeek 模型名称填完点保存然后在主界面把刚配的 DeepSeek 设为当前激活项。如果你希望 Claude Code 默认就走 DeepSeek在设置里勾选「设为默认」。3.4 Claude Code 的 settings 配置文件cc-switch 本质上是在帮你写 Claude Code 的配置文件。你也可以手动配置配置文件通常位于用户目录下的.claude/settings.json。一个可复制的配置片段如下{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com, ANTHROPIC_API_KEY: 你的DeepSeek密钥, ANTHROPIC_MODEL: 你的DeepSeek模型ID } }注意三个关键字段ANTHROPIC_BASE_URL指向模型服务的接口地址ANTHROPIC_API_KEY是你的密钥ANTHROPIC_MODEL指定用哪个模型。这三件套配齐Claude Code 才知道往哪发请求、用什么身份、调哪个模型。如果你用的是 TaoToken 这类聚合服务Base URL 填https://taotoken.net/apiKey 和 Model ID 从控制台获取。配置逻辑完全一样只是地址和密钥换成对应平台的。3.5 多模型切换的实际用法cc-switch 的价值在多模型场景下才体现出来。比如你日常编码用响应快的模型遇到复杂重构切到推理强的模型两个配置都存好点一下切换就行。切换后 Claude Code 下次启动就会读新的配置。这里有个细节切换配置后已经打开的 Claude Code 会话不会自动生效需要退出重进。我踩过的坑就是切了模型但当前会话还在用旧的排查半天以为是配置没写对。4. 验证请求从启动 Claude Code 到看到模型回复配置写好了不代表就能跑通得实际发一个请求验证。打开 Git Bash进入你的项目目录输入claude第一次启动可能会让你确认一些初始化选项按提示走就行。进入交互界面后直接问一个能暴露模型身份的问题你现在用的是什么模型如果它回答的模型名称和你配置的一致说明请求链路通了。如果它报连接错误或者返回的模型不对说明配置有问题往下看排查部分。再做一个更实际的验证让它读一个文件帮我看看当前目录下有哪些文件然后解释一下 package.json 的作用这个请求会触发 Claude Code 读取文件系统能验证它不只是能对话还能实际操作你的项目。如果它能列出文件并解释内容说明工具调用也正常。验证成功后你可以试试更复杂的指令比如让它创建一个简单的脚本文件、修改某个配置、或者解释一段代码的逻辑。这些才是 Claude Code 作为 AI 编程助手的日常用法。如果你在验证阶段想先确认模型本身是否可用可以到模型对话页面直接发一条消息测试排除是 Claude Code 配置问题还是模型服务问题。接入相关的文档里也有各平台的配置示例对照检查更快定位。5. 常见报错逐条排查401、连接失败、模型不存在怎么解5.1 401 认证失败报错信息通常是401 Unauthorized或authentication_error。原因基本是 API Key 有问题要么 Key 复制时带了空格要么 Key 已失效或被删除要么 Base URL 和 Key 不匹配比如把 A 平台的 Key 填到了 B 平台的地址上。排查方法重新复制 Key确认前后没有多余字符到模型平台控制台确认 Key 状态正常核对 Base URL 和 Key 是否属于同一平台。5.2 连接失败或超时报错可能是connection refused、ETIMEDOUT或local proxy failed。先检查 Base URL 是否拼写正确有没有多写或少写路径。然后确认你的网络能访问该地址可以在 Git Bash 里用curl测试curl -I https://api.deepseek.com如果返回 HTTP 状态码说明网络通问题在配置如果直接超时说明网络层有问题检查代理设置或换个网络环境。5.3 模型不存在报错类似model not found或invalid model。这是 Model ID 拼写错误或者你填的模型名称该平台不支持。回到模型平台的文档页确认可用的模型 ID 列表复制准确的名称填进去。注意大小写和连字符deepseek-v4-pro和deepseek-v4-Pro可能就不一样。5.4 Claude Code 命令找不到claude: command not found说明 npm 全局路径没在 PATH 里。运行npm config get prefix拿到全局安装路径把这个路径加到系统环境变量的 PATH 中重启 Git Bash 再试。5.5 cc-switch 切换后不生效切换配置后 Claude Code 还在用旧模型先退出当前 Claude Code 会话再重新启动。如果还是不生效检查 cc-switch 是否以管理员权限运行配置文件是否真的写入了。可以手动打开.claude/settings.json看内容有没有更新。5.6 OAuth 相关报错如果报错涉及OAuth或token refresh failed说明 Claude Code 在尝试走官方认证流程但你配置的是第三方通道。检查 settings 里是否正确设置了ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两个字段会覆盖默认的认证方式。配置对了就不会再走 OAuth。排查的核心思路就一条先确认网络能通再确认 Key 有效最后确认 Model ID 正确。这三样都没问题请求基本能跑通。6. 把配置固化下来长期使用 Claude Code 的建议跑通第一个请求之后建议把配置固化避免每次重装或换机器都要重新折腾。cc-switch 的配置可以导出备份Claude Code 的 settings.json 也可以直接复制到新机器的对应目录。如果你有多个项目用不同的模型可以在 cc-switch 里建多套配置按项目切换。对于长期编码和 Agent 场景可以考虑用 Coding Plan 这类方案把常用的模型通道和额度管理起来不用每次单独配 Key。日常验证模型是否可用用模型对话页面快速测一条消息就行。接入过程中遇到配置问题接入文档里有各平台的完整示例对照着改比盲试快得多。最后提醒一点配置文件里的 API Key 是敏感信息不要提交到 Git 仓库也不要截图发出去。可以在.gitignore里排除.claude/settings.json或者用环境变量注入的方式管理密钥。这些习惯在你后面配更多模型、接更多工具时会省很多麻烦。