1. Windows 下 Claude Code 安装到底卡在哪Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接读写你本地的代码文件、执行命令、跑测试适合习惯在命令行里干活的开发者。但它在 Windows 上的安装体验和 macOS/Linux 差别不小——不是npm install一条命令就完事中间会卡在 Node.js 版本、Git Bash 路径、环境变量、settings.json 格式这几个地方。我自己第一次装的时候claude命令敲下去直接报找不到 bash.exe折腾了半小时才发现是CLAUDE_CODE_GIT_BASH_PATH没配。后来帮同事装又遇到 settings.json 存成了.txt后缀导致配置完全不生效。这些坑其实都不难只是没人一次性讲清楚。这篇就按 Windows 的实际操作顺序走一遍装 Node.js、装 Git Bash、装 Claude Code、配环境变量、写 settings.json、启动验证。每一步都给可复制的命令和配置最后说明怎么通过 TaoToken 统一 Key 和 API 通道接入避免在多个供应商之间来回切换。全程在 Git Bash 里操作PowerShell 和 CMD 只用来验证版本号。2. 装 Claude Code 之前先把 Node.js 和 Git Bash 备好Claude Code 依赖 Node.js版本必须大于等于 18。Windows 上直接去 Node.js 官网下载 LTS 版本的.msi安装包一路默认选项装到 C 盘就行。装完打开 PowerShell 或 CMD 验证node --version npm --version正常会返回类似v24.11.1和11.6.2的版本号。如果node命令找不到大概率是安装时没勾选“Add to PATH”重新跑一遍安装程序勾上即可。Git Bash 是 Windows 上跑 Claude Code 的必备环境。去 Git 官网下载最新版.exe同样默认安装到 C 盘。装完在开始菜单搜 “Git Bash”能打开一个黑色命令行窗口就说明好了。记住你的bash.exe路径默认是C:\Program Files\Git\bin\bash.exe后面配环境变量要用。注意Windows 上 Claude Code 强烈建议在 Git Bash 里运行不要用 PowerShell 或 CMD。很多命令行为差异和路径问题都源于终端选错了。Node.js 和 Git Bash 都就绪后在 Git Bash 里装 Claude Code。推荐先装 pnpm它在 Windows 下的依赖解析更稳npm install -g pnpm pnpm setuppnpm setup执行完如果提示命令未生效关掉 Git Bash 重新开一个。然后全局安装 Claude Codepnpm install -g anthropic-ai/claude-code网络慢的话加国内镜像pnpm install -g anthropic-ai/claude-code --registry https://registry.npmmirror.com装完验证claude --version能输出类似2.1.85 (Claude Code)就说明安装成功。如果提示claude: command not found先确认是不是没重开终端pnpm 的全局 bin 目录需要新终端才能刷新到 PATH。3. settings.json 骨架配置与 TaoToken 接入Claude Code 的配置核心是settings.jsonWindows 下的路径是C:\Users\[你的用户名]\.claude\settings.json如果.claude目录不存在就手动建一个。这个文件控制 API 地址、认证 Token、超时时间、权限策略等。下面是一份可直接复制的骨架配置{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_BASE_URL: https://taotoken.net/api, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, API_TIMEOUT_MS: 600000 }, permissions: { allow: [], deny: [] } }逐条说明这几个字段的作用。ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台创建的 API Key格式一般是sk-开头。ANTHROPIC_BASE_URL指向 TaoToken 的 API 通道https://taotoken.net/api这样 Claude Code 的所有请求都走统一入口不用改代码就能切换底层模型。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1 可以关掉非必要的遥测请求减少干扰。API_TIMEOUT_MS设成 60000010 分钟网络波动时不容易超时报错。permissions里的allow和deny是工具权限白名单和黑名单第一次配置留空即可跑通后再按需收紧。比如你不想让 Claude Code 执行 Bash 命令可以在deny里加Bash。保存文件时务必确认扩展名是.json不是.json.txt。Windows 默认隐藏已知扩展名很容易存错。可以在文件资源管理器里勾选“文件扩展名”显示确认无误。提示TaoToken 的 API Key 在控制台的 API Keys 页面创建模型对话入口可以先用网页版试一下通道是否通再配到 Claude Code 里。4. 环境变量配置与首次启动验证Windows 上 Claude Code 需要额外配一个环境变量CLAUDE_CODE_GIT_BASH_PATH告诉它 bash.exe 在哪。操作路径右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在“系统变量”里新建。变量名填CLAUDE_CODE_GIT_BASH_PATH变量值填你的实际路径默认是C:\Program Files\Git\bin\bash.exe如果你 Git 装到了别的盘改成对应路径。配完关掉所有终端重新开一个 Git Bash让环境变量生效。然后启动 Claude Codeclaude首次启动会提示选主题、确认是否使用配置文件里的 API Key选“是”。接着会问是否信任当前文件夹选Yes, I trust this folder。进入交互界面后输入一句话测试帮我看看当前目录下有哪些文件如果 Claude Code 能列出文件并正常回复说明从环境到 API 通道整条链路都通了。这一步验证的是 Node.js 版本、Git Bash 路径、settings.json 格式、TaoToken Key 和 API 地址五个环节任何一个出问题都会在这里暴露。想验证模型通道是否真的走通了可以打开 TaoToken 的模型对话页面发一条消息对比响应确认 Key 和额度正常。长期在项目里用 Claude Code 做编码和 Agent 任务的话Coding Plan 的额度模型更适合高频调用比按次计费省心。5. 本篇常见报错排查报错一claude: command not found先重开终端。pnpm 全局安装后 bin 目录需要新终端才进 PATH。还不行就检查pnpm setup是否执行过或者用npm install -g anthropic-ai/claude-code换 npm 装一遍对比。报错二启动时提示找不到 bash.exeCLAUDE_CODE_GIT_BASH_PATH没配或路径写错。确认 Git 实际安装位置路径里的bash.exe要精确到文件。配完必须重开终端。报错三settings.json 不生效九成是扩展名问题。Windows 隐藏扩展名时你以为存的是settings.json实际是settings.json.txt。在资源管理器里开启扩展名显示确认文件名。另外 JSON 格式要严格多一个逗号都会导致解析失败可以用在线 JSON 校验工具过一遍。报错四请求超时或连接失败先确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api不要多加斜杠或路径。然后检查 API Key 是否有效、额度是否充足。API_TIMEOUT_MS设大一些能缓解网络波动但如果是 Key 本身的问题调多大都没用。报错五pnpm: command not foundpnpm setup没执行或没重开终端。重新跑npm install -g pnpm pnpm setup然后关掉 Git Bash 再开。报错六Node.js 版本过低node --version低于 18 就会报错。去官网下最新 LTS 覆盖安装装完重开终端确认版本号。6. 接入之后怎么继续用环境搭好、settings.json 配好、首次对话跑通之后Claude Code 的日常使用就是在这个终端里跟它协作。项目根目录跑一次/init生成CLAUDE.md把项目规范写进去后续每次启动它都会读取这份记忆。长会话用/compact压缩上下文切换任务用/clear硬重置成本用/cost盯着。TaoToken 在这里的角色是统一 Key 和 API 通道——你不需要为每个模型单独配一套认证改ANTHROPIC_BASE_URL和 Key 就能切换底层通道。接入文档里有完整的参数说明和示例排障时对照检查比盲猜快得多。API Keys 页面管理你的密钥模型对话页面可以快速验证通道连通性Coding Plan 适合把 Claude Code 当日常编码主力的情况。装完之后如果claude --version能出版本号、claude能进交互界面、发一句话能正常回复这三步都过了后面就是用它干活的事了。