1. Windows 上跑 Claude Code为什么总卡在第一步Claude Code 是 Anthropic 推出的命令行 AI 编程工具能直接在终端里读写项目文件、执行命令、跑测试适合习惯用命令行干活的开发者。最新版已经原生支持 Windows但很多人第一次装完就撞墙要么claude命令没反应要么报No suitable shell found要么连不上服务端一直转圈。这些问题的根子通常不在 Claude Code 本身而在 Node 环境、Git Bash 路径、以及 API 通道三件事没对齐。这篇教程聚焦一个最小闭环在 Windows 上把 Claude Code 接到 TaoToken 的统一 Key/API 通道用一份可复制的settings.json骨架 环境变量检查清单 一条验证命令让你从安装到跑通不绕路。适合已经装好 Node、想用统一入口管理 Anthropic 系模型的 AI 编程工具用户。下面按顺序来每一步都有可复制的命令和预期结果。2. 前置准备Node、Git Bash 与 TaoToken Key2.1 确认 Node 与 npm 可用Claude Code 依赖 Node 环境先开 PowerShell 或 CMD 验证node -v npm -v两条都输出版本号才算过关。如果node -v没反应说明 Node 没装好或环境变量没配去 Node 官网下 LTS 的.msi重装一遍安装时勾选 “Add to PATH”。Windows 11 一般装完就能用老版本系统可能需要手动把 Node 安装目录加进系统变量。2.2 装 Git for Windows拿到 bash.exeClaude Code 在 Windows 上需要一个 POSIX shell官方推荐 Git Bash。去 Git for Windows 下载页拿 x64 安装包一路默认下一步即可。装完后确认bash.exe的位置常见路径是C:\Program Files\Git\bin\bash.exe如果不确定在 Git Bash 里执行where bash把输出的路径记下来后面配CLAUDE_CODE_GIT_BASH_PATH要用。这一步是解决No suitable shell found的关键路径写错就会一直报这个错。2.3 安装 Claude Code打开 Git Bash进任意目录执行全局安装npm install -g anthropic-ai/claude-code如果下载慢可以先切镜像源再装npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code装完验证claude --version能打印版本号就说明 CLI 本体没问题。如果卡在安装不动多半是网络或镜像源问题换源重试即可。2.4 在 TaoToken 拿统一 Key访问 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进控制台创建 API Key。这个 Key 就是你后面填进ANTHROPIC_AUTH_TOKEN的凭证一个 Key 走统一通道不用为每个模型单独配。创建时建议选长期有效避免对话中途失效。拿到 Key 后先放一边下一步直接写进配置。3. 可复制的 settings.json 骨架与环境变量3.1 settings.json 放哪、写什么Claude Code 在 Windows 上读取用户级配置的位置是C:\Users\你的用户名\.claude\settings.json如果.claude目录不存在就手动建一个。下面是一份可直接改用的骨架把你的TaoTokenKey和 Git Bash 路径替换成你自己的{ env: { ANTHROPIC_AUTH_TOKEN: 你的TaoTokenKey, ANTHROPIC_BASE_URL: https://taotoken.net/api, CLAUDE_CODE_GIT_BASH_PATH: C:\\Program Files\\Git\\bin\\bash.exe }, permissions: { allow: [], deny: [] } }几个要点ANTHROPIC_BASE_URL填https://taotoken.net/api不要带多余斜杠Windows 路径里的反斜杠在 JSON 中要写成双反斜杠\\否则解析会出错permissions先留空等跑通后再按需加白名单。3.2 环境变量检查清单除了settings.json也可以用系统环境变量兜底。在 PowerShell 里临时设置当前窗口有效$env:ANTHROPIC_AUTH_TOKEN你的TaoTokenKey $env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:CLAUDE_CODE_GIT_BASH_PATHC:\Program Files\Git\bin\bash.exe想永久生效就进“系统属性 → 环境变量”逐条添加。检查是否生效echo $env:ANTHROPIC_BASE_URL输出https://taotoken.net/api就对了。注意settings.json和系统环境变量同时存在时以settings.json为准别两处填了不同的 Key 导致混乱。3.3 启动并选择配置在 Git Bash 里进你的项目目录直接敲claude首次启动会问主题、是否信任当前目录等一路回车。遇到“是否使用 API Key”选 Yes。如果它提示找不到 shell回头检查CLAUDE_CODE_GIT_BASH_PATH是否指向真实的bash.exe。启动成功后你会看到 Claude Code 的交互界面这时还没发请求下一步验证连通性。4. 一条命令验证连通性4.1 用最小请求确认通道打通在 Claude Code 交互界面里直接输入一句简单指令比如帮我看一下当前目录有哪些文件如果配置正确它会调用工具列出文件并返回结果。想更直接地验证 API 通道可以在 Git Bash 里用 curl 打一次接口curl https://taotoken.net/api/v1/messages \ -H x-api-key: 你的TaoTokenKey \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:64,messages:[{role:user,content:ping}]}返回里带content字段和文本内容说明 Key 和通道都正常。如果返回 401是 Key 填错返回 404检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api。4.2 成功结果长什么样正常返回类似{ id: msg_xxx, type: message, role: assistant, content: [{type: text, text: pong}], model: claude-sonnet-4-20250514 }看到content里有文本就代表从 Windows 本地到 TaoToken 通道的整条链路通了。此时回到 Claude Code 界面让它读一个真实文件、改一行代码确认工具调用也正常。到这一步最小闭环完成。5. 本篇常见报错排查5.1 No suitable shell found这是 Windows 上最高频的报错原因是 Claude Code 找不到 POSIX shell。解决动作确认 Git for Windows 已安装where bash能输出路径然后把该路径写进CLAUDE_CODE_GIT_BASH_PATH。注意路径要用双反斜杠且指向bash.exe而不是git-bash.exe的快捷方式。5.2 无法连接到 Claude Code / 一直转圈先查ANTHROPIC_BASE_URL是否为https://taotoken.net/api多一个斜杠或少一段都会失败。再查 Key 是否复制完整有没有多余空格。如果公司网络有代理限制确认能正常访问该域名。用上面的 curl 命令单独测一次能快速定位是配置问题还是网络问题。5.3 claude 命令找不到claude --version报“不是内部或外部命令”说明 npm 全局目录没进 PATH。执行npm config get prefix拿到全局目录把它加进系统环境变量 Path重开终端再试。或者直接用npx anthropic-ai/claude-code临时跑。5.4 对话超限或额度报错如果频繁提示额度问题去 TaoToken 控制台确认 Key 的额度状态。创建 Key 时选长期有效、额度充足的类型避免对话中途被截断。需要管理多个 Key 时在控制台的 API Keys 页面统一维护。6. 后续怎么用得更顺跑通之后建议把常用项目的权限白名单加到settings.json的permissions.allow里减少每次确认。需要长期在多个项目里用 Claude Code 做编码和 Agent 任务可以了解 Coding Plan把额度集中管理。想先对比不同模型的表现直接进模型对话页面试几句确认哪个模型适合你的场景再写进配置。接入文档里有完整的参数说明和更多示例遇到新报错先翻文档再排查。配置这件事一次写对后面就省心。把settings.json骨架存一份模板换机器时改 Key 和路径就能复用。真正跑起来之后你会发现 Claude Code 在 Windows 上的体验和 macOS 差别不大关键就是那三样Node、Git Bash 路径、统一 API 通道。