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 Key

2.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.exe

Claude 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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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_URL="https://taotoken.net/api" $env:CLAUDE_CODE_GIT_BASH_PATH="C:\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 通道。