★ FEATURED ARTICLE 1. Windows 上跑 Claude Code 到底卡在哪从 Git 依赖到 PATH 的完整链路Claude Code 是 Anthropic 推出的命令行 AI 编程助手能在终端里直接读写项目文件、执行命令、跑测试适合习惯用 PowerShell 或 CMD 干活的 Windows 开发者。它本身是个 Node 生态之外的原生可执行文件但官方安装脚本在 Windows 上依赖 Git Bash 提供类 Unix 环境所以「装不上」「命令找不到」「报 requires git-bash」这三类问题几乎都出在依赖链和 PATH 上。我见过太多人卡在同一个地方PowerShell 里敲claude提示「不是内部或外部命令」回头检查发现安装其实成功了只是.local\bin没进 PATH或者进了 PATH 但没重开终端。还有人系统是 64 位却用了 32 位 PowerShell直接撞上does not support 32-bit的报错。这篇教程把 Git 安装、PowerShell 适配、PATH 配置、API Key 接入和报错排查串成一条可复制的链路每一步都给出命令和预期输出你照着敲就能在本地跑通并确认版本可用。需要先明确一点Claude Code 的安装脚本从官方地址拉取网络连通性由你自己的环境决定本文只讲本地配置不涉及任何网络工具。整个流程大约 10 到 15 分钟前提是系统为 64 位 Windows 10/11内存 4GB 以上磁盘留出 2 到 4GB。先看整体依赖关系心里有个图环节作用缺失后果Git for Windows提供 Git BashClaude Code 运行依赖报 requires git-bashPowerShell管理员执行安装脚本权限不足安装中断PATH 环境变量让系统找到 claude 命令claude 不是内部或外部命令API Key / 接入配置让 Claude Code 能调用模型启动后无法对话这张表就是后面所有排错的索引。下面按顺序走每一步都别跳。2. 前置准备Git for Windows 安装与 PowerShell 终端适配Claude Code 在 Windows 上不是纯原生跑它需要 Git Bash 作为底层 shell。所以第一步永远是装 Git而且安装时要确保 PATH 选项选对否则后面git --version都过不了。2.1 下载并安装 Git for Windows打开 Git 官网下载页https://git-scm.com/downloads/win下载最新的 64 位安装包文件名类似Git-2.51.2-64-bit.exe。双击运行安装向导里大部分步骤直接 Next但有一个关键节点必须确认在「Adjusting your PATH environment」这一步选择Git from the command line and also from 3rd-party software默认选项。这个选项会把 Git 的可执行目录写进系统 PATHClaude Code 和 PowerShell 才能直接调用git。其余选项保持默认即可点 Install 等待完成最后 Finish。2.2 验证 Git 是否可用按Win R输入cmd回车在命令提示符里敲git --version预期输出类似git version 2.51.2.windows.1如果显示版本号说明 Git 装好了。如果提示git 不是内部或外部命令说明 PATH 没写进去回到安装向导重装一次或者手动把C:\Program Files\Git\cmd加到 PATH。2.3 PowerShell 版本与位数确认Claude Code 只支持 64 位环境。先确认你用的是 64 位 PowerShell。按Win R输入%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe这个路径下的才是 64 位 PowerShell。如果你从开始菜单打开的是 32 位版本路径里带 SysWOW64后面会直接报Claude Code does not support 32-bit Windows。确认系统位数按Win Pause/Break在「系统类型」里看是「64 位操作系统」还是「32 位」。32 位系统无法安装 Claude Code这是硬性限制。2.4 以管理员身份打开 PowerShell按Win键输入powershell在「Windows PowerShell」上右键选择「以管理员身份运行」。安装脚本需要写文件到用户目录并可能修改执行策略管理员权限能避免中途被拦。打开后先确认当前用户目录后面 PATH 要用到echo $env:USERNAME记下这个用户名PATH 路径里的你的用户名要替换成它。3. 可复制配置安装 Claude Code 并写入 PATH 环境变量这一步是核心分安装和 PATH 配置两段。安装脚本会从官方地址拉取PATH 配置决定你以后能不能在任何目录直接敲claude。3.1 执行安装脚本在管理员 PowerShell 里运行irm https://claude.ai/install.ps1 | iexirm是Invoke-RestMethod的别名负责下载脚本内容iex是Invoke-Expression负责执行。等待进度走完成功后会显示类似Installation complete! Version: 2.0.34 Location: C:\Users\你的用户名\.local\bin\claude.exe记住这个 Location它就是待会要加进 PATH 的目录。3.2 配置 PATH图形界面方式新手推荐图形界面不容易敲错。按Win R输入sysdm.cpl回车依次点「高级」→「环境变量」。在「用户变量」区域窗口上半部分找到Path双击打开点「新建」输入C:\Users\你的用户名\.local\bin把你的用户名换成 2.4 步里确认的实际用户名。然后一路「确定」关闭所有窗口。3.3 配置 PATHPowerShell 命令方式如果你更喜欢命令行在管理员 PowerShell 里运行[Environment]::SetEnvironmentVariable(Path, $env:Path ;C:\Users\$env:USERNAME\.local\bin, User)这行把.local\bin追加到当前用户级 PATH 的末尾。注意它用的是$env:USERNAME自动取当前用户名省去手填。3.4 用 settings 片段固化接入配置Claude Code 的接入信息可以写进配置文件避免每次手动设。在用户目录下创建或编辑C:\Users\你的用户名\.claude\settings.json写入下面这段 JSON路径与文件名保持这个结构{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的APIKey, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }三件套对应关系要记牢Base URL 填https://taotoken.net/apiAPI Key 填你在控制台生成的密钥Model ID 填你要用的模型标识。这三项缺一不可后面验证请求时会用到。如果你用的是 Cline MCP 或 Codex 的auth.json体系同样遵循 Base URL Key Model ID 三件套的填法只是文件位置不同。Claude Code 这边认的是settings.json里的env字段。3.5 关于执行策略如果安装或运行时报「无法加载文件因为在此系统上禁止运行脚本」在管理员 PowerShell 里放开当前用户的执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned允许本地脚本运行远程下载的脚本需要签名是安全性和可用性的平衡点。4. 验证请求确认版本、命令与模型调用都通配置写完不代表生效必须重启终端并做三层验证命令能找到、版本能打印、模型能对话。4.1 重启 PowerShellPATH 修改只对新开的终端生效。关掉所有 PowerShell 窗口重新打开一个普通权限即可验证不需要管理员。4.2 验证 claude 命令在新窗口里敲claude --version预期输出2.0.34如果显示版本号说明 PATH 生效、命令可用。如果还是「不是内部或外部命令」跳到第 5 节排查。4.3 用完整路径兜底测试万一 PATH 没生效可以先用完整路径确认程序本身没问题C:\Users\你的用户名\.local\bin\claude.exe --version能打印版本就说明安装成功问题纯粹在 PATH。4.4 验证模型调用进入你的项目目录启动 Claude Codecd C:\Users\你的用户名\Documents\my-project claude首次启动会读取settings.json里的接入配置。如果 Base URL、Key、Model ID 都填对了会进入交互界面你可以输入一句自然语言测试比如「列出当前目录的文件并解释项目结构」。能正常返回内容说明整条链路打通。也可以用命令行方式快速验证配置是否被读到claude config list它会打印当前生效的配置项检查ANTHROPIC_BASE_URL和ANTHROPIC_MODEL是否和你写的一致。4.5 常用命令速查跑通之后这几个命令日常会用到claude --help claude --model claude-sonnet-4-20250514 claude config list--model可以临时指定模型启动config list用来核对配置。命令名是claude不是claude-code这一点很多人第一次会敲错。5. 本篇常见报错排查401、local proxy failed、reading choices 与 OAuth下面这些报错都是真实会撞上的按症状对号入座。5.1 claude 不是内部或外部命令原因PATH 没配或终端没重启。解决确认.local\bin已加入用户 PATH然后关闭所有 PowerShell 窗口重开。用 4.3 的完整路径测试能区分是 PATH 问题还是安装问题。5.2 requires git-bash原因Git 没装或 Git Bash 不可用。解决重装 Git for Windows安装时确认 PATH 选项选的是「Git from the command line and also from 3rd-party software」。装完重启终端。5.3 Claude Code does not support 32-bit Windows原因用了 32 位 PowerShell 或系统本身是 32 位。解决用%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe打开 64 位 PowerShell如果系统是 32 位无法安装只能换 64 位系统。5.4 401 报错症状启动后请求返回 401 Unauthorized。原因API Key 错误、过期或 Base URL 和 Key 不匹配。解决检查settings.json里ANTHROPIC_API_KEY是否完整复制、有没有多余空格确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api。Key 可以在控制台重新生成后替换。5.5 local proxy failed症状提示本地代理失败。原因环境里残留了HTTP_PROXY/HTTPS_PROXY之类的变量指向了一个不可用的地址。解决在 PowerShell 里检查并清掉echo $env:HTTP_PROXY echo $env:HTTPS_PROXY如果有值且你不需要用Remove-Item Env:HTTP_PROXY临时清除或去系统环境变量里删掉。5.6 reading choices 相关报错症状返回内容解析失败提示读取 choices 出错。原因Base URL 指向的接口返回格式和 Claude Code 预期的不一致通常是 Base URL 写错或少了路径。解决确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要多加斜杠或后缀。5.7 OAuth 登录失败症状选择订阅方式登录时卡住或报错。原因浏览器回调被拦或网络环境问题。解决改用 API Key 方式接入在settings.json里配好三件套绕开 OAuth 流程。对多数开发者来说 API Key 方式更可控。5.8 权限错误禁止运行脚本症状无法加载文件因为在此系统上禁止运行脚本。解决管理员 PowerShell 里运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。把这张对照表存下来下次报错直接查报错根因动作claude 不是内部或外部命令PATH 未生效加 PATH 重启终端requires git-bashGit 缺失重装 Gitdoes not support 32-bit位数不对换 64 位 PowerShell401Key/URL 错核对三件套local proxy failed代理变量残留清 HTTP_PROXYreading choicesBase URL 错改为 /apiOAuth 失败回调受阻改用 API Key6. 跑通之后把 Claude Code 接进日常编码流安装只是起点真正省时间的是把它接进你的项目工作流。我试过在几个中型项目里用它做代码重构和测试补全体感最顺的用法是进项目目录直接claude然后用自然语言描述任务比如「给这个模块补单元测试」「解释这个函数的边界条件」「把这段回调改成 async/await」。它会读文件、改代码、跑命令你只需要 review 结果。如果你要长期在多个项目里用建议把接入配置固化到settings.jsonKey 和 Model ID 一次配好之后每个项目目录启动都直接生效。需要生成或轮换 Key 的时候去控制台操作想先试试模型对话效果可以用模型对话页面快速验证如果是团队协作或 Agent 类长期编码任务Coding Plan 会更合适。接入文档里有各端的详细参数说明遇到配置项不确定就翻文档。最后留一个实用习惯每次改完 PATH 或settings.json先跑claude --version和claude config list两条命令确认环境再进项目干活。这两条命令花不了五秒能挡掉八成「昨天还好好的今天怎么不行了」的问题。命令名记住是claudePATH 记住要重启终端Git 记住先装——这三条守住Windows 上的 Claude Code 就不会再折腾你。
阅读完成 · 觉得有帮助？
