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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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.exe，bin目录里有bash.exe，System32是很多系统命令的所在地，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 体验就和命令行里一样顺了。
