1. Windows 上跑 Claude Code为什么总在第一步卡住Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、执行命令、跑测试适合习惯用 CLI 干活的开发者。它本身是 Node.js 写的理论上 Windows 也能装但真正上手你会发现装是装上了跑起来却各种报错。核心原因有两个——一是 Claude Code 内部依赖 Git Bash 来执行 shell 命令Windows 原生 CMD/PowerShell 的语法和它预期的不一样二是官方 API 对国内网络和新用户注册都有限制登录环节经常直接卡死。这篇就把 Windows 下从零安装 Claude Code 的全流程拆开讲包括 Node.js 和 Git Bash 的准备、三种安装方式的取舍、settings.json 的骨架写法以及怎么用 TaoToken 的统一 Key 把 API 通道接进来。最后附一份我实际踩过的报错清单和对应排查命令照着走能省掉大半天折腾。适合谁看Windows 10/11 用户、想用 Claude Code 但被环境问题劝退的人、以及需要给团队统一配置 API 通道的开发者。先说清楚一件事Claude Code 的安装本身不复杂复杂的是环境依赖和网络通道。把这两块理顺后面就是改一个配置文件的事。2. 前置准备Node.js、Git Bash 与 TaoToken 统一 Key2.1 Node.js 版本要求Claude Code 要求 Node.js 18 以上。装之前先确认版本别用系统里躺了三年的老版本。node -v npm -v如果版本低于 18去 Node.js 官网下 LTS 版重装。装完记得重开终端否则 PATH 不刷新。2.2 Git Bash 是硬依赖这是 Windows 上最容易忽略的一步。Claude Code 在 Windows 下会去找bash.exe找不到就直接报Claude Code on Windows requires git-bash。所以 Git for Windows 必须装而且安装时有个关键选项在安装向导的 Adjusting your PATH environment 这一步务必选Git from the command line and also from 3rd-party software。选错的话bash命令不会进 PATHClaude Code 就找不到它。装完验证bash --version git --version两条都能输出版本号说明 Git Bash 就绪。如果你把 Git 装到了 D 盘比如D:\git\Git记住这个路径后面配环境变量要用。2.3 TaoToken 统一 Key 的作用Claude Code 默认走 Anthropic 官方 API国内直连基本不通而且新用户注册经常被限制。TaoToken 提供的是统一 Key 和 API 通道你只需要在配置里把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址再用 TaoToken 生成的 Key 做鉴权Claude Code 就能正常发请求了。这样一套 Key 可以同时给多个工具用团队里统一管理也方便。先去 TaoToken 官网注册账号然后在控制台创建 API Key。地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台里生成 Key复制出来备用。Key 只在创建时完整显示一次记得存好。3. 安装 Claude Code 与 settings.json 配置骨架3.1 三种安装方式怎么选npm 安装是最稳的推荐优先用npm install -g anthropic-ai/claude-codewinget 方式适合喜欢用包管理器的winget install Anthropic.ClaudeCode官方 PowerShell 脚本方式irm https://claude.ai/install.ps1 | iex实测下来PowerShell 脚本方式最容易出Checksum verification failed因为下载过程中脚本可能不完整。如果你遇到这个报错直接换 npm 方式别在脚本上耗时间。3.2 验证安装与 PATH 检查装完先看命令能不能找到claude --version如果报claude 不是内部或外部命令说明 npm 全局路径没进 PATH。查一下全局路径npm config get prefix把这个路径比如D:\program\GlobalNpm加到系统环境变量 PATH 里重开终端再试。3.3 settings.json 骨架Claude Code 的配置放在用户目录下的.claude/settings.json。Windows 上路径是C:\Users\你的用户名\.claude\settings.json。如果目录不存在就手动建。一个可用的骨架长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken_API_Key, CLAUDE_CODE_GIT_BASH_PATH: D:\\git\\Git\\bin\\bash.exe }, permissions: { allow: [], deny: [] } }几个要点说明ANTHROPIC_BASE_URL填 TaoToken 的 API 地址https://taotoken.net/api注意这里不加 UTM 参数就是纯 API 端点。ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台生成的 Key。CLAUDE_CODE_GIT_BASH_PATH填你实际的bash.exe完整路径。Windows 路径里的反斜杠在 JSON 里要写成双反斜杠\\否则解析会出错。如果你 Git 装在默认的 C 盘这条可以省略Claude Code 会自己找。3.4 环境变量的两种设置方式除了写进 settings.json你也可以用系统环境变量。临时设置当前终端会话有效set ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKEN你的Key set CLAUDE_CODE_GIT_BASH_PATHD:\git\Git\bin\bash.exe claude永久设置走「系统属性 → 环境变量 → 新建用户变量」把上面三个变量名和值分别加进去。settings.json 和环境变量同时存在时settings.json 优先级更高建议统一放 settings.json 里管理换机器时复制一个文件就行。4. 验证请求确认通道真的通了配置写完别急着开干先验证 API 通道是否正常。最直接的方式是启动 Claude Code 后发一条测试请求。cd D:\你的项目路径 claude首次启动如果配置正确不会再弹浏览器登录而是直接进入交互界面。输入一句简单的话测试你好帮我看看当前目录下有哪些文件如果它能正常调用工具列出文件说明 Git Bash 和 API 通道都通了。如果卡在连接阶段看下一节的排查清单。另一种验证方式是直接用 curl 打 TaoToken 的 API确认 Key 本身有效curl https://taotoken.net/api/v1/messages \ -H x-api-key: 你的Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:50,messages:[{role:user,content:ping}]}返回里有正常的 JSON 响应说明 Key 和通道都没问题那问题就出在 Claude Code 的本地配置上。这个区分方法很实用能帮你快速定位是通道问题还是环境问题。成功启动后建议在项目里跑一次初始化/init它会生成.claude/CLAUDE.md文件你可以编辑这个文件写项目规范、技术栈说明、代码风格要求Claude Code 每次启动会读它相当于给 AI 一份项目说明书。5. 本篇常见报错排查清单把我在 Windows 上实际遇到的坑整理成表对照现象找原因报错现象根本原因解决方式claude 不是内部或外部命令npm 全局路径不在 PATHnpm config get prefix查路径加进系统 PATHChecksum verification failedPowerShell 脚本下载不完整改用npm install -g anthropic-ai/claude-codeClaude Code on Windows requires git-bashGit 未装或路径未设设CLAUDE_CODE_GIT_BASH_PATH指向 bash.exeGit 装在 D 盘找不到默认路径假设在 C 盘手动指定完整路径注意 JSON 里用双反斜杠Unable to connect to Anthropic servicesBASE_URL 没指向 TaoToken检查 settings.json 里ANTHROPIC_BASE_URL登录时提示新用户不可用走了官方登录流程改用 API Key 方式配ANTHROPIC_AUTH_TOKENJSON 解析报错路径反斜杠没转义Windows 路径写成D:\\git\\Git\\bin\\bash.exe几个排查技巧补充查 Git 实际安装位置在开始菜单搜 Git Bash右键打开文件位置就能看到真实路径。或者右键任意文件夹看有没有 Open Git Bash here。确认环境变量有没有生效新开一个终端跑echo %ANTHROPIC_BASE_URL%能打印出你设的值就说明生效了。如果打印的是%ANTHROPIC_BASE_URL%本身说明变量没设上。settings.json 改完一定要重启 Claude Code它只在启动时读配置运行中改文件不生效。如果所有配置都对但还是连不上先用第 4 节的 curl 命令单独测 Key把通道问题和环境问题分开排查别混在一起猜。6. 后续怎么用模型对话、Coding Plan 与接入文档环境通了之后日常使用主要围绕几个入口。想快速验证模型响应、测试不同 prompt 效果可以直接用模型对话功能地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在网页里就能试不用每次开终端。如果你打算长期用 Claude Code 做编码或者搭 Agent 工作流建议看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频编码场景做了额度优化比按量付费更划算。Key 的管理和新建在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以给不同项目建不同的 Key方便追踪用量。API Key 的具体创建步骤看 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。完整的接入参数说明和更多客户端配置示例在接入文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到配置项不确定的可以对照查。最后提一个实际经验Windows 下这套配置最脆弱的环节是 Git Bash 路径。换电脑或者重装 Git 后第一件事就是确认CLAUDE_CODE_GIT_BASH_PATH还指向正确的位置。把这个路径记在项目 README 或者团队文档里下次部署能少走很多弯路。