1. Windows 下 VS Code 集成 Claude Code 的 git-bash 路径问题Claude Code 是 Anthropic 推出的命令行 AI 编程助手能直接在终端里读写文件、跑命令、改代码。很多同学一开始是在 PowerShell 或 CMD 里用它用顺手之后想搬到 VS Code 插件里结果一进插件就撞上 Git 报错。这个报错在 Windows 上非常典型核心信息就是一句Claude Code on Windows requires git-bash并且提示你设置CLAUDE_CODE_GIT_BASH_PATH指向bash.exe。问题在于很多人明明已经装了 Git命令行里跑 Claude Code 也完全正常偏偏 VS Code 插件里就是不行。我自己也踩过这个坑命令行里git --version有输出where git也能找到路径但 VS Code 里的 Claude Code 就是反复弹这个错。后来翻了不少资料包括 GitHub issue 里的讨论才把根因和修复步骤理清楚。这篇就把整个排查过程、可复制的settings.json配置骨架以及重启终端后的验证动作完整写一遍适合刚在 Windows 上把 Claude Code 接进 VS Code 的同学照着做。需要先说明一点这个问题的本质不是 Claude Code 本身坏了而是 VS Code 插件启动子进程时继承的环境变量和你手动开的终端不是同一套。你在系统里配了变量不代表 VS Code 已经拿到。所以修复思路分两层一是把CLAUDE_CODE_GIT_BASH_PATH明确写进 VS Code 的配置二是确保 Git 的几个关键目录进了系统Path让插件能真正找到bash.exe。2. 前置准备TaoToken 接入与 Claude Code 环境在动手改路径之前先把 Claude Code 的模型接入搞定否则你修完 Git 问题下一步还是会卡在鉴权上。Claude Code 支持通过兼容 Anthropic 协议的中转服务来调用模型TaoToken 就是这类服务官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要先拿到一个 API Key。登录后进入控制台在 API Keys 页面创建一个新 Key复制出来备用。这个 Key 后面会写进环境变量Claude Code 启动时会读取它去请求模型。接入方式有两种按你的使用习惯选第一种是直接在终端里设环境变量。Windows 下可以用 PowerShell 临时设置也可以写进系统环境变量长期生效。关键变量是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY前者指向 TaoToken 的 API 地址后者填你刚创建的 Key。第二种是如果你打算长期在 VS Code 里用建议把这两个变量写进系统环境变量这样 VS Code 插件启动时也能继承到。注意这里说的系统环境变量和后面要配的CLAUDE_CODE_GIT_BASH_PATH是两回事前者管模型鉴权后者管 Git 路径别混在一起。如果你还没决定用哪种模型可以先到模型对话页面试试手感确认模型响应正常再往 Claude Code 里接。对于长期编码和 Agent 场景Coding Plan 会更划算适合每天都要跑大量代码生成和文件操作的同学。3. 可复制配置settings.json 与系统 Path 双管齐下这一步是核心。很多人只改了系统环境变量没改 VS Code 的settings.json结果插件还是读不到。正确的做法是两边都配确保万无一失。先打开 VS Code 的设置文件。按Ctrl Shift P输入Open User Settings (JSON)回车就会打开settings.json。在里面加入下面这段配置骨架{ terminal.integrated.env.windows: { CLAUDE_CODE_GIT_BASH_PATH: D:\\Program Files\\Git\\bin\\bash.exe }, claude-code.environmentVariables: { CLAUDE_CODE_GIT_BASH_PATH: D:\\Program Files\\Git\\bin\\bash.exe } }注意路径里的反斜杠要写成双反斜杠\\这是 JSON 的转义要求。D:\\Program Files\\Git\\bin\\bash.exe只是示例你要换成自己机器上 Git 的实际安装路径。怎么确认在 PowerShell 里跑where.exe bash如果输出里有D:\Program Files\Git\bin\bash.exe这样的路径就照抄。如果没有输出说明 Git 的 bin 目录没进 Path先解决这个。接下来是系统环境变量。右键「此电脑」→「属性」→「高级系统设置」→「环境变量」在「系统变量」里找到Path编辑加入下面三个路径Git 路径按你实际安装位置改D:\Program Files\Git\cmd D:\Program Files\Git\bin C:\Windows\System32cmd目录里有git.exebin目录里有bash.exeSystem32是很多系统命令的所在地Claude Code 调 Git 时会间接用到。三个都加上能避免很多「找不到命令」的连锁报错。配完之后还有一个容易漏的点如果你之前已经在 VS Code 里开过终端那些终端进程还持有旧的环境变量。必须把所有终端关掉最好直接退出 VS Code 再重开让新配置生效。4. 验证请求重启终端后确认 git 与 Claude Code 都正常配置改完不是就结束了得验证。先关掉 VS Code 所有窗口重新打开。然后按Ctrl 开一个新终端依次跑下面几条命令。第一条确认 Git 本身可用git --version正常会输出类似git version 2.43.0.windows.1的版本号。如果报「不是内部或外部命令」说明 Path 没配好回去检查那三个路径。第二条确认 bash 能被找到where bash应该输出bash.exe的完整路径。如果找不到说明Git\bin没进 Path。第三条确认 Claude Code 能读到 Git 路径。在终端里启动 Claude Code然后让它执行一个简单的 Git 操作比如claude进入交互后输入「帮我看看当前目录的 git 状态」如果它能正常调用git status并返回结果说明路径问题已经解决。如果还是弹 git-bash 的错检查settings.json里的CLAUDE_CODE_GIT_BASH_PATH路径是否写对特别是双反斜杠和实际安装位置。第四条验证模型接入是否正常。在 Claude Code 里问一个简单问题比如「用一句话解释什么是递归」如果能有正常回复说明ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY也生效了。这一步能同时验证 Git 和模型两条链路。实测下来只要settings.json和系统 Path 都配对重启 VS Code 后基本一次通过。如果还不行往下看排查部分。5. 本篇常见错排查报错一设置完还是提示 requires git-bash。最常见的原因是settings.json里的路径写错了。检查三点反斜杠是否写成双反斜杠、路径是否指向bash.exe而不是git.exe、Git 是否真的装在这个位置。可以在文件资源管理器里直接粘贴路径看能不能打开。报错二where bash有输出但 Claude Code 还是找不到。这说明系统 Path 没问题但 VS Code 插件没继承到。重点检查settings.json里的terminal.integrated.env.windows和claude-code.environmentVariables两段是否都写了。有些版本的插件只读后者有些只读前者两个都配最稳。报错三改了环境变量但没生效。Windows 的环境变量修改后已经运行的进程不会自动更新。必须完全退出 VS Code包括托盘里的后台进程再重新打开。如果还不行重启一次电脑这是最彻底的刷新方式。报错四Git 命令能跑但 Claude Code 调用时报权限错误。检查C:\Windows\System32是否在 Path 里。有些 Git 操作会间接调用系统命令缺这个路径会导致奇怪的权限或找不到命令的报错。报错五模型请求 401 或 403。这跟 Git 路径无关是 API Key 或 Base URL 的问题。确认ANTHROPIC_BASE_URL填的是 https://taotoken.net/api ANTHROPIC_API_KEY填的是控制台里创建的 Key没有多余空格。如果 Key 泄露或过期去控制台重新生成一个。报错六VS Code 里终端正常但 Claude Code 面板里不行。这种情况通常是插件用了独立的环境变量读取逻辑。除了settings.json还要确认系统环境变量里也设了CLAUDE_CODE_GIT_BASH_PATH。两边都设覆盖所有读取路径。6. 接入与排障后的下一步Git 路径问题解决后Claude Code 在 VS Code 里基本就能顺畅跑起来了。接下来如果你要长期用它写代码、跑 Agent 任务建议把 API Key 和 Base URL 固化到系统环境变量避免每次开终端都要重设。需要管理多个 Key 或查看用量可以到 API Keys 页面操作接入过程中遇到协议或参数问题接入文档里有完整的字段说明。模型选择上如果你只是偶尔问问代码模型对话够用如果每天都要跑大量文件读写和命令执行Coding Plan 的额度更适合长期编码场景。把 Git 路径和模型接入这两步都走通Windows 下的 Claude Code 体验就和命令行里一样顺了。