1. Windows 上跑 Claude Code 到底卡在哪从 PowerShell 报错到 Git Bash 落地如果你在 Windows 上第一次接触 Claude Code大概率会经历这么一幕照着官方文档敲命令PowerShell 直接甩你一脸报错或者装完了claude命令却提示找不到 Git Bash。这不是你操作有问题而是 Claude Code 这套工具链本身是围绕 Unix 风格终端设计的Windows 原生的 CMD 和 PowerShell 在路径处理、shell 调用上和它天然不对付。Claude Code 是什么简单说它是 Anthropic 推出的一个终端里的 AI 编程助手能读你的项目文件、执行命令、改代码交互方式就是在命令行里对话。适合谁适合已经在用终端干活、想让 AI 直接进到项目上下文里帮忙的开发者。它不是一个图形界面软件你得习惯在终端里跟它打交道。那 Windows 用户怎么绕过去官方给的方案是 WSL但 WSL 要装子系统、配环境对只是想快速试一下的人来说太重了。更轻的路子是 Git Bash——Git for Windows 自带的那个 bash 环境装完 Git 就有了Claude Code 能直接认它。所以整条链路是装 Node.jsClaude Code 的运行底座→ 装 Git拿到 Git Bash→ 用 npm 全局装 Claude Code → 用 cc-switch 把 API 通道切到统一 Key 上。这里有个关键点很多人会忽略Claude Code 默认连的是 Anthropic 官方通道但国内开发者更常用的是统一 Key 的 API 通道比如 TaoToken 这种把 Base URL 和 Key 统一管理的方案。你要做的不是改 Claude Code 源码而是通过配置文件或 cc-switch 这个工具把请求指向你自己的通道。cc-switch 是一个多模型 API 管理工具图形界面点点鼠标就能切换配置省得你手写settings.json。我试过在几台 Windows 机器上从零走一遍踩过的坑主要集中在三处Node 版本低于 18 导致 npm 装包失败、CLAUDE_CODE_GIT_BASH_PATH环境变量没配导致 claude 启动时报找不到 bash、以及 cc-switch 里 Base URL 和 Key 填错位置导致请求 401。下面我把每一步拆开命令和配置都能直接复制。这一节你先记住整体路径Node ≥ 18 → Git Bash → npm 全局装 Claude Code → 配环境变量 → cc-switch 填 Base URL Key Model ID → 跑一次真实对话验证。后面每一节对应其中一段最后给你排错对照表。2. 装 Claude Code 前的前置准备node.js 版本检查与 Git Bash 环境变量配置这一节解决的是「装之前要有什么」。Claude Code 依赖 Node.js而且版本有硬要求必须 ≥ 18。低于 18 的话npm 安装阶段就可能报错或者装完了运行时报语法不支持的错。所以第一步不是急着敲安装命令而是先确认 Node 版本。打开你的终端先别管是 CMD 还是 PowerShell检查版本够用输入node -v npm -v如果node -v输出的是v18.x.x及以上比如v20.11.0那就过关。如果输出v16.x.x或者干脆提示node 不是内部或外部命令那就得去 Node.js 官网下载安装包。下载地址是https://nodejs.org/zh-cn/download选 Windows 的 LTS 版本一路默认安装即可。安装完记得关掉终端重新开一个让环境变量生效再跑一次node -v确认。Node 装好后有个容易被忽略的优化npm 的全局缓存和依赖目录默认在 C 盘用户目录下时间长了会占不少空间。你可以在 Node 安装目录下手动建两个文件夹比如node_cache和node_global然后用这两条命令把 npm 的路径指过去npm config set prefix C:\Program Files\nodejs\node_global npm config set cache C:\Program Files\nodejs\node_cache路径按你实际的 Node 安装位置改。这一步不是必须的但能避免以后 C 盘爆满。接下来装 Git。去https://git-scm.com/download/win下载 Windows 版安装包双击.exe安装引导一路默认下一步就行建议装在 C 盘默认路径。装完后你会在开始菜单里看到「Git Bash」这就是我们要的 bash 环境。装完 Git 必须做一件事配置CLAUDE_CODE_GIT_BASH_PATH环境变量。因为 Claude Code 在 Windows 上启动时会去找 bash.exe你不告诉它路径它就报错。先找到 bash.exe 的实际位置通常在C:\Program Files\Git\bin\bash.exe然后设置环境变量。按Win R输入sysdm.cpl回车进「高级」→「环境变量」在「用户变量」里新建一条变量名变量值CLAUDE_CODE_GIT_BASH_PATHC:\Program Files\Git\bin\bash.exe变量值填你机器上 bash.exe 的真实路径。设完点确定然后一定要重开终端环境变量才会被读取。你可以用这条命令验证echo %CLAUDE_CODE_GIT_BASH_PATH%能打印出路径就说明配好了。这一步没做的话后面claude命令启动时会直接报找不到 Git Bash 的错很多人卡在这以为是安装失败其实是环境变量没生效。到这里前置准备就齐了Node ≥ 18、Git Bash 可用、环境变量指向 bash.exe。下一节开始真正装 Claude Code 并接入统一 Key 通道。3. 用 npm 装 Claude Code 并接入 TaoToken 统一 Keycc-switch 配置片段与 settings.json 写法现在开始装 Claude Code 本体。这里有个关键操作不要用 PowerShell 或 CMD 直接装用 Git Bash。因为 Claude Code 的安装脚本和后续运行都假设你在 bash 环境里。打开 Git Bash开始菜单搜「Git Bash」在里面执行npm install -g anthropic-ai/claude-code如果这一步报权限错误比如EACCES或EPERM说明当前用户对全局目录没写权限。解决办法是以管理员身份运行开始菜单搜「cmd」右键「以管理员身份运行」然后在管理员 CMD 里再跑一次上面那条命令。装完后回到普通 Git Bash 验证claude --version能打印出版本号就说明装成功了。第一次直接敲claude会进入一个欢迎界面但此时还不能用因为它还没连上任何 API 通道——默认它想连 Anthropic 官方你需要把它指到自己的统一 Key 通道上。这里就要用到 cc-switch。它是一个图形化的多模型 API 管理工具作用是帮你管理不同供应商的 Base URL、Key、Model ID一键切换不用手改配置文件。去它的 GitHub 仓库https://github.com/farion1231/cc-switch下载 Windows 版安装包装完打开。在 cc-switch 里新增一个配置需要填三样东西这就是所谓的「三件套」配置项填什么说明Base URLhttps://taotoken.net/api统一 API 通道地址API Key你的sk-xxxx令牌在 TaoToken 控制台生成Model ID比如claude-sonnet-4-5按你实际要用的模型填Base URL 这里注意填https://taotoken.net/api不要多加路径后缀。Key 去 TaoToken 控制台的 API Keys 页面生成地址是https://taotoken.net/console/api-keys。生成后复制那串sk-开头的令牌粘到 cc-switch 的 Key 字段里。如果你不想用 cc-switch也可以直接手写 Claude Code 的配置文件。配置文件在用户主目录下的.claude文件夹里。在 Git Bash 里这样进cd ~ cd .claude ls你会看到settings.json之类的文件。用编辑器打开settings.json写入类似这样的内容{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的令牌, ANTHROPIC_MODEL: claude-sonnet-4-5 } }这个 JSON 片段就是 Claude Code 读取环境变量的地方。ANTHROPIC_BASE_URL指向统一通道ANTHROPIC_API_KEY是你的令牌ANTHROPIC_MODEL指定默认模型。三个字段缺一不可尤其是 Model ID填错了会报模型不存在的错。有个细节如果你 C 盘空间紧张想把.claude目录挪到 D 盘可以用符号链接「骗」一下应用。先把整个.claude文件夹移到D:\ClaudeData\.claude然后以管理员身份打开 CMD执行mklink /J C:\Users\你的用户名\.claude D:\ClaudeData\.claude这样 Claude Code 以为文件还在 C 盘原位置实际读写的是 D 盘。路径里的用户名换成你自己的。配置写完后cc-switch 里点一下「应用」或「切换」它会帮你把配置同步到 Claude Code 读取的位置。到这里安装和通道配置就完成了下一节跑一次真实请求验证。4. 验证 Claude Code 是否接通一次真实对话请求与成功结果判断配置写完不代表通了必须跑一次真实请求。回到 Git Bash在任意目录下敲claude第一次启动可能会让你确认一些初始化选项比如是否信任当前目录按提示走。进入交互界面后直接输入一句话测试比如你好帮我用一句话解释什么是递归如果通道配对了你会看到它开始流式输出回答。这就是成功的结果有内容返回且不是报错。如果它返回的是 401、403 或者「invalid api key」之类的错误说明 Key 或 Base URL 有问题去下一节对照排查。你也可以用非交互模式快速验证不用进界面claude -p 用一句话解释什么是递归-p是 print 模式直接把结果打到终端。这个方式适合脚本里调用也适合快速确认通道是否通。实测下来只要 Base URL、Key、Model ID 三件套填对这条命令几秒内就能返回结果。再进一步你可以让它读一个文件来验证上下文能力。在项目目录下建个测试文件echo def add(a, b): return a b test.py claude -p 读一下 test.py告诉我这个函数做什么如果它能正确读出文件内容并解释说明不仅通道通了文件读取权限也正常。这一步能帮你排除「通道通了但工具权限没开」的情况。验证成功的标志有三个命令不报错、有模型返回内容、能读取项目文件。三个都满足你的 Claude Code 就算在 Windows 上完整跑通了。接下来可以正常用它写代码、改 bug、解释项目。如果你还想验证其他模型或者对比不同通道的效果可以到模型对话页面直接试https://taotoken.net/models。那里能快速切换模型发消息适合在正式配进 Claude Code 之前先确认某个 Model ID 是否可用。5. Claude Code 在 Windows 上的常见报错排查401、local proxy failed、reading choices、OAuth 对照这一节把最常见的几类报错列出来对照着查。这些错我都实际遇到过按顺序排查基本能解决。报错一401 Unauthorized / invalid api key这是最高频的。原因通常是 Key 填错、Key 过期、或者 Base URL 和 Key 不匹配。排查步骤先去 TaoToken 控制台确认 Key 还在、没被删然后检查settings.json或 cc-switch 里的 Key 有没有多余空格复制粘贴时很容易带上再确认 Base URL 是https://taotoken.net/api没有多写或少写路径。三件套里任何一个错位都会导致 401。报错二local proxy failed / connection refused这个错通常出现在你本地配了某种转发但没启动或者 Base URL 指向了一个本地地址。检查你的ANTHROPIC_BASE_URL是不是被改成了http://localhost:xxxx之类的本地地址。如果你没用本地转发就应该直接填https://taotoken.net/api。另外检查系统里有没有残留的代理环境变量比如HTTP_PROXY、HTTPS_PROXY有的话清掉再试。报错三reading choices of undefined这个错一般出现在返回体结构不符合预期时常见原因是 Model ID 填错了或者通道返回的不是标准格式。先确认ANTHROPIC_MODEL填的是有效模型名比如claude-sonnet-4-5别自己编。如果 Model ID 没问题检查 Base URL 是不是漏了/api或者多加了/v1之类的后缀。路径不对会导致请求打到错误端点返回体自然解析不了。报错四OAuth / authentication failedClaude Code 有时会尝试走 OAuth 登录流程如果你用的是 API Key 通道不需要 OAuth。出现这个错说明它没读到你的 API Key 配置。检查settings.json里的env字段是否正确嵌套JSON 格式有没有语法错误比如多了个逗号。可以用在线 JSON 校验工具过一遍。另外确认你改的是用户目录下的.claude/settings.json不是项目里的其他配置文件。报错五找不到 Git Bash / bash.exe not found回到第 2 节检查CLAUDE_CODE_GIT_BASH_PATH环境变量是否设置、路径是否指向真实的bash.exe、设置后是否重开了终端。这三个里任何一个没做到都会报这个错。报错六npm 安装时 EACCES / EPERM权限问题用管理员身份运行 CMD 再装或者按第 2 节配置 npm 的 prefix 到有写权限的目录。排查时有个通用思路先确认三件套Base URL Key Model ID完全正确再确认环境变量生效最后确认终端是 Git Bash 而不是 PowerShell。大部分问题都出在这三层里。如果还搞不定去接入文档页面查更细的说明https://taotoken.net/doc。6. 跑通之后怎么用把 Claude Code 接进日常编码与长期 Agent 工作流第一个对话跑通只是起点。Claude Code 真正的价值在于它能进到你的项目里读文件、改代码、跑命令。日常用法上你可以在项目根目录直接启动claude它会以当前目录为工作区你让它改哪个文件它就改哪个。比如「帮我把 utils.py 里的重复逻辑抽成一个函数」它会读文件、给出修改、你确认后落盘。如果你要长期用它做编码或者搭 Agent 工作流建议了解一下 Coding Plan 这类方案地址是https://taotoken.net/coding-plan。它适合需要稳定、持续调用模型的场景比按次调用更划算配置方式也是同一套 Base URL Key Model ID换汤不换药。对于更复杂的自动化比如让 Claude Code 在 CI 里跑、或者接进你自己的工具链可以用 API 方式直接调https://taotoken.net/api。这时候你需要的还是那三件套只是调用方从 Claude Code 变成了你自己的脚本。文档在https://taotoken.net/doc里面有各语言的调用示例。回到 Windows 这个场景最后给你几个实用建议。第一把 Git Bash 固定到任务栏以后启动 Claude Code 都从它进别用 PowerShell。第二settings.json改完后养成用 JSON 校验工具过一遍的习惯能省掉大量格式错误。第三cc-switch 里可以存多套配置比如一套日常用、一套测试用切换比手改文件快。第四如果项目多可以在每个项目目录下放独立的.claude配置Claude Code 会优先读项目级的。这套流程我在多台 Windows 机器上走过从 Node 到 Git Bash 到 cc-switch 到验证顺利的话二十分钟内能全部搞定。卡住的地方基本都在环境变量和三件套的细节上对照第 5 节排查就行。跑通之后你就有了一个能在终端里直接对话、直接改代码的 AI 助手接下来就是把它用进你真实的项目里。