1. VS Code 里 Claude Code 报 git-bash 链接失败到底卡在哪一层你在 VS Code 里敲下claude终端弹出一行红字Error: Claude Code on Windows requires git-bash。你明明装了 Gitgit --version也能跑甚至按网上说的把CLAUDE_CODE_GIT_BASH_PATH指向了bash.exe重启 VS Code 后还是同样的报错。这个场景我遇到过不止一次问题往往不在「有没有装 Git」而在 VS Code 这个宿主进程到底把哪个 shell 当成了默认终端、环境变量有没有被扩展进程继承、以及 Claude Code 走的那条 API 通道有没有真正连通。先把这件事拆成三层来看后面所有排查都围绕这三层展开。第一层是终端路径层VS Code 的集成终端默认可能是 PowerShell而 Claude Code 在 Windows 上需要 git-bash 提供的 POSIX 环境它内部会调用cygpath、bash这类工具。第二层是环境变量层你在系统设置里改了Path但已经开着的 VS Code 窗口、以及它拉起的扩展宿主进程读到的还是旧的环境块所以「改了没用」。第三层是 API 通道层shell 通了之后Claude Code 还要把请求发到一个兼容 Anthropic 协议的端点如果 Base URL、Key、Model ID 三者对不上你会看到 401 或者reading choices之类的报错这时候报错信息看起来像「链接问题」其实是鉴权或路由问题。这三层经常被混在一起。比如有人看到cygpath: command not found以为是 Git 没装好其实是usr\bin没进Path有人看到 401以为是 git-bash 又挂了其实是 Key 没配对。所以正确的做法是分层验证一层通了再进下一层别一上来就删环境变量、重装 Git那样只会把变量越搞越乱。这篇面向的是在 Windows VS Code 里用 Claude Code 做日常编码的人尤其是刚接入、还没跑通第一条请求的。我会给出可复制的settings.json、TaoToken 统一 Key 的接入步骤、用echo验证 shell 路径、用curl验证 API 连通性的具体命令以及几类真实报错的对照排查。你跟着做基本能在十几分钟内定位到是哪一层出的问题。需要先明确一个前提Claude Code 在 Windows 上对 git-bash 的依赖是硬性的这不是配置能绕过的所以终端路径这层必须先过。过了之后API 通道这层才是决定你能不能真正用起来的关键。下面从环境准备开始。2. 接入前的环境准备TaoToken 统一 Key 与 git-bash 路径确认在动 VS Code 配置之前先把两样东西准备好一个能用的 API Key以及一个确认可执行的 git-bash。这两样缺一个后面都会以「链接失败」的形式表现出来所以先在这里排掉。2.1 获取 TaoToken 统一 Key 并确认 Base URLTaoToken 提供的是兼容 Anthropic 协议的统一接入通道Claude Code 这类工具可以直接把 Base URL 指过来。你需要先在控制台创建一个 API Key然后记下两个值Base URL 用https://taotoken.net/apiKey 就是控制台生成的那串。模型 ID 按你实际要用的填比如claude-sonnet-4-5这类具体以文档里的模型列表为准。创建 Key 的入口在控制台的 API Keys 页面模型对话页面可以用来单独验证某个模型是否可用。这两个入口后面 CTA 会再给一次这里你先拿到 Key 就行。注意 Key 只在创建时完整显示一次复制好再关页面。2.2 确认 git-bash 的真实路径打开 PowerShell先确认 Git 装在哪、bash 能不能直接跑where.exe git where.exe bash如果where.exe bash没有输出说明bash.exe不在Path里这时候 Claude Code 找不到 shell 是正常的。Git 的 bash 通常在两个位置之一用户级安装%USERPROFILE%\AppData\Local\Programs\Git\bin\bash.exe 全局安装 C:\Program Files\Git\bin\bash.exe你可以直接用完整路径验证它能不能跑 $env:USERPROFILE\AppData\Local\Programs\Git\bin\bash.exe --version能打印出版本号说明 bash 本身没问题问题在「怎么让 Claude Code 找到它」。这里有个常见的坑很多人把CLAUDE_CODE_GIT_BASH_PATH指向Git\bin\bash.exe但 Claude Code 内部还会调用cygpath而cygpath.exe在Git\usr\bin下。所以只配 bash 路径往往不够usr\bin也得进Path。2.3 把 Git 的 cmd 与 usr\bin 加进用户 Path在「系统属性 → 环境变量 → 用户变量」里编辑Path加入两条按你的安装位置选%USERPROFILE%\AppData\Local\Programs\Git\cmd %USERPROFILE%\AppData\Local\Programs\Git\usr\bincmd目录里有git.exeusr\bin里有cygpath.exe、bash.exe依赖的一堆工具。加完之后完全关闭 VS Code不是关窗口是退出进程任务栏里也不能留再重新打开。因为 VS Code 的扩展宿主进程在启动时读取环境块不重启它读不到新变量。这里顺便说一个反直觉的点如果你之前手动设过CLAUDE_CODE_GIT_BASH_PATH而它指向的路径不对或者带了引号反而会覆盖自动探测导致明明Path里有 bash 却还是报错。所以排查时可以先把这个变量删掉让 Claude Code 走Path自动探测通了之后再决定要不要显式指定。环境准备好之后进入 VS Code 的配置环节。3. VS Code settings.json 可复制配置与 Claude Code 接入这一节是核心操作。VS Code 的终端配置和 Claude Code 的接入配置要分开写前者管 shell后者管 API 通道。很多人把两者混在一个文件里改乱了之后更难排查。3.1 配置 VS Code 集成终端默认使用 git-bash打开命令面板CtrlShiftP输入Preferences: Open User Settings (JSON)在settings.json里加入终端配置。下面这段可以直接复制路径按你的实际安装位置调整{ terminal.integrated.defaultProfile.windows: Git Bash, terminal.integrated.profiles.windows: { Git Bash: { path: C:\\Program Files\\Git\\bin\\bash.exe, args: [--login, -i] }, PowerShell: { source: PowerShell, icon: terminal-powershell } }, terminal.integrated.env.windows: { CLAUDE_CODE_GIT_BASH_PATH: C:\\Program Files\\Git\\bin\\bash.exe } }如果你的是用户级安装把C:\\Program Files\\Git换成C:\\Users\\你的用户名\\AppData\\Local\\Programs\\Git。注意 JSON 里反斜杠要双写转义。--login -i这两个参数让 bash 以登录交互模式启动能加载/etc/profilecygpath这类工具才在PATH里。配好之后在 VS Code 里新开一个终端CtrlShift看终端标题是不是Git Bash。如果是 PowerShell说明defaultProfile.windows 没生效检查 JSON 有没有语法错误VS Code 会在右下角提示。3.2 用 echo 验证 shell 路径是否真的生效新开的 Git Bash 终端里跑这几条echo $SHELL which bash which cygpath echo $PATH | tr : \n | grep -i git预期结果是$SHELL指向 bashwhich bash和which cygpath都能打印出路径PATH里能看到 Git 的cmd和usr\bin。如果which cygpath没输出说明usr\bin没进PATH回到 2.3 补上再重启 VS Code。这一步很关键因为 Claude Code 报的git-bash错误本质就是它在这个终端环境里找不到 bash 或 cygpath。echo验证通过说明终端路径层已经通了可以进 API 通道层。3.3 配置 Claude Code 的 API 通道Base URL Key Model IDClaude Code 的配置有两种常见方式环境变量或者项目/用户级的配置文件。推荐用环境变量跨项目通用。在 Git Bash 里你可以写进~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的TaoToken Key export ANTHROPIC_MODELclaude-sonnet-4-5如果你用的是 Claude Code 的 settings 文件方式可以在~/.claude/settings.json里写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-5 } }三件套必须齐全Base URL 指向https://taotoken.net/apiKey 用控制台生成的Model ID 按文档填。少任何一个请求都会失败而且报错信息不一定直白。写完之后source ~/.bashrc或者重开终端让变量生效。如果你同时用 Cline、Codex 这类工具它们的配置逻辑类似都是 Base URL Key Model ID 三件套只是字段名不同。Cline 的 MCP 配置里 Base URL 和 Key 分开填Codex 的auth.json里则是另一套结构。核心不变端点、凭证、模型三者对齐。配置写完下一步就是验证请求能不能真正发出去。4. 验证请求用 curl 打通 API 连通性并跑通第一条 Claude Code 请求配置写完不代表通了必须实际发一次请求。这一节先用curl单独验证 API 通道再回到 Claude Code 里跑真实请求这样出问题能快速定位是通道问题还是工具问题。4.1 用 curl 验证 TaoToken API 连通性在 Git Bash 里执行下面这条把 Key 换成你自己的curl -sS https://taotoken.net/api/v1/messages \ -H x-api-key: $ANTHROPIC_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [ {role: user, content: 只回复两个字通了} ] }预期返回是一段 JSON里面有content字段文本是「通了」之类。如果返回 401说明 Key 不对或没带上如果返回 404检查 Base URL 是不是写成了https://taotoken.net/api后面多加了/v1之类如果连接超时检查网络和端点拼写。这一步通了说明 API 通道层没问题问题如果还在就只可能在 Claude Code 工具本身。4.2 在 VS Code 终端里跑通第一条 Claude Code 请求回到 VS Code 的 Git Bash 终端确认环境变量已经加载echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_MODEL两个都有输出之后直接启动claude第一次启动会让你做一些初始化选择按提示走。进入交互界面后输入一个简单问题比如「用一句话说明这个项目是做什么的」。如果能看到流式返回说明整条链路通了VS Code → git-bash → Claude Code → TaoToken → 模型。如果这一步报错先别急着改配置把报错原文记下来对照下一节的排查表。很多「链接失败」其实是 401 或模型 ID 写错报错文案容易误导。4.3 验证成功的标志成功的标志有三个终端里 Claude Code 正常进入交互、输入问题后有流式输出、没有git-bash或cygpath相关报错。三个都满足说明终端路径层和 API 通道层都通了。这时候你可以把配置固化下来比如把环境变量写进~/.bashrc把 VS Code 的settings.json提交到自己的 dotfiles 里换机器时直接复用。如果只通了 curl 但 Claude Code 还是报错重点查 Claude Code 读的是哪份配置——它可能读的是~/.claude/settings.json而不是 shell 环境变量两者优先级不同。这个在下一节会展开。5. 常见报错对照排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照。你遇到的报错文案可能和标题里的「git-bash 链接问题」不完全一样但根因往往落在下面几类里。5.1 401 与鉴权失败报错里出现401、unauthorized、invalid api key基本是 Key 的问题。检查三件事Key 有没有复制完整前后不能有空格、请求头字段对不对Anthropic 协议用x-api-key不是Authorization: Bearer、环境变量有没有真的加载echo $ANTHROPIC_API_KEY看输出。如果 Key 是在 TaoToken 控制台刚创建的确认没有误删。401 和 git-bash 无关别去动终端配置。5.2 local proxy failed 与网络层报错里出现local proxy failed、ECONNREFUSED、ETIMEDOUT说明请求根本没到端点。先确认 Base URL 拼写再确认本机网络能访问https://taotoken.net/api。用 4.1 的 curl 命令单独测一次curl 通了说明网络没问题那就是 Claude Code 的配置没读到 Base URL检查~/.claude/settings.json和环境变量的优先级。5.3 reading choices 与响应解析报错里出现reading choices、cannot read property通常是返回体不是预期的 JSON 结构常见原因是 Base URL 指错了路径或者模型 ID 不存在导致端点返回了错误页。用 curl 看原始返回体如果返回的是 HTML 或错误 JSON就能确认是端点或模型的问题。把 Model ID 换成文档里确认存在的再试。5.4 OAuth 与登录态冲突报错里出现OAuth、token expired、please login说明 Claude Code 在尝试走它自己的登录流程而不是用你配的 API Key。这种情况要确认 Claude Code 的配置里没有残留的登录态或者显式指定用 API Key 模式。检查~/.claude/下有没有旧的凭证文件必要时清掉重新配。OAuth 报错和 git-bash 也无关别混为一谈。5.5 cygpath: command not found 与 git-bash 路径这个才是真正的终端路径层报错。cygpath在Git\usr\bin下把这个目录加进用户Path完全重启 VS Code。如果加了还不行检查Path里有没有重复项或错误项导致解析失败可以用echo $PATH | tr : \n逐行看。另外确认CLAUDE_CODE_GIT_BASH_PATH没有指向一个带空格的错误路径。5.6 排查顺序建议遇到报错先分类带cygpath、git-bash字样的走 5.5带401、OAuth的走 5.1 和 5.4带proxy、timeout的走 5.2带reading、parse的走 5.3。分类之后只动对应那一层的配置别一次改一堆否则改好了也不知道是哪条生效。6. 把配置固化下来长期编码与 Agent 场景的接入建议跑通之后建议把配置固化避免每次换终端或换机器重来。VS Code 的settings.json可以放进你的 dotfiles 仓库Git Bash 的环境变量写进~/.bashrcClaude Code 的~/.claude/settings.json单独备份。三份配置各管一层职责清晰出问题也好定位。如果你打算长期用 Claude Code 做编码或者跑 Agent 任务可以考虑 TaoToken 的 Coding Plan它在用量和模型切换上更适合持续性的开发场景。单独验证某个模型是否可用时用模型对话页面快速测一下就行。接入过程中卡在鉴权或端点配置直接看接入文档里面有各工具的字段对照。最后给一个实用习惯每次改完配置先用echo确认 shell 路径再用curl确认 API 连通最后才启动 Claude Code。三步都过基本不会遇到「改了没用」的情况。这套顺序我用了很久比反复重启 VS Code 高效得多。