1. Windows11 上跑 Claude Code卡住的多半不是模型而是环境Claude Code 是 Anthropic 出的命令行编程助手能在终端里直接读你的项目、改文件、跑命令适合习惯用 PowerShell 或 VS Code 写代码的人。它本身是个 npm 包装起来就一行命令但在 Windows11 上真正让人卡住的往往不是模型能力而是三件事Node 和 Git 没装对、全局包路径没进 PATH、以及网络通道没配好导致一执行就报连接失败。我自己在 Windows11 上从零装过好几轮踩过的坑集中在「claude 不是内部或外部命令」和「执行 claude 后一直转圈或直接报错」这两类。这篇就按从零到跑通的顺序走一遍先确认 Node、Git、npm 三件套再装 Claude Code 本体然后用 TaoToken 的统一 Key 和 API 通道完成配置最后给你一份可复制的 settings.json 骨架和分步验证动作。目标是一次跑通并且留下一份以后换机器能直接复用的配置。需要说明的是Claude Code 只是客户端它需要一个能接收 Anthropic 协议请求的入口。TaoToken 在这里扮演的就是这个统一入口你拿一个 Key配好 base_url客户端就能正常发请求不用在每台机器上折腾不同的通道。下面所有命令都可以直接复制到 PowerShell 里执行。2. 前置准备Node、Git、npm 三件套怎么确认Claude Code 依赖 Node 运行时同时它内部会调用 Git 来做版本相关操作所以这两个必须先到位。npm 是随 Node 一起装的一般不用单独处理。2.1 检查 Node 是否安装打开 PowerShell 或 CMD运行node --version正常会返回类似v22.14.0的版本号。如果提示「不是内部或外部命令」说明没装或没进 PATH。去 Node 官网下载 Windows 安装包安装时全部选默认参数即可安装器会自动把 Node 和 npm 加进 PATH。装完关掉当前终端重新开一个再验证。2.2 检查 Git 是否安装git --version正常返回类似git version 2.46.2.windows.1。没有的话去 Git 官网下载 Windows 安装包一路默认下一步即可。装完同样重开终端验证。2.3 检查 npm 并处理下载慢npm --versionnpm 随 Node 一起装好能返回版本号就说明三件套齐了。如果后面npm install下载很慢可以切国内镜像npm config set registry https://registry.npmmirror.com这条只是换下载源不影响功能。切完可以用npm config get registry确认当前源。3. 安装 Claude Code 本体并解决命令找不到三件套确认后安装本体就一行npm install -g anthropic-ai/claude-code-g表示全局安装。装完先验证claude --version3.1 「不是内部或外部命令」怎么定位如果这里报claude 不是内部或外部命令也不是可运行的程序或批处理文件别急着重装先找文件到底装哪了。全局包的落地目录可以用这条查npm config get prefix假设返回C:\Program Files\nodejs\node_global那claude.cmd大概率就在这个目录下。你可以直接去看一眼dir C:\Program Files\nodejs\node_global\claude.cmd文件在、但命令用不了就是 PATH 没包含这个目录。3.2 把全局目录加进 PATH按Win R输入sysdm.cpl回车切到「高级」选项卡点「环境变量」。优先改「用户变量」里的Path不需要管理员权限选中 Path → 编辑 → 新建 → 粘贴C:\Program Files\nodejs\node_global\→ 一路确定。改完必须重开终端PATH 才会生效。再跑一次claude --version返回类似2.1.62 (Claude Code)就说明本体装好了。这一步是整个流程里最容易漏的很多人以为装失败其实只是路径没配。4. 用 TaoToken 统一 Key 完成配置本体装好后直接执行claude通常会失败因为客户端还不知道往哪发请求、用什么身份。这里需要配两样东西认证 Token 和 API 入口地址。TaoToken 提供统一 Key 和 API 通道你只需要在配置里填一次。先去控制台创建 API Key访问 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 登录后新建一个 Key 并复制保存。API 入口地址用 https://taotoken.net/api 。4.1 可复制的 settings.json 骨架Claude Code 会读取用户目录下的配置文件。创建或编辑C:\Users\你的用户名\.claude\settings.json填入{ env: { ANTHROPIC_AUTH_TOKEN: 替换为你的 TaoToken API Key, ANTHROPIC_BASE_URL: https://taotoken.net/api }, permissions: { allow: [], deny: [] } }注意两点ANTHROPIC_AUTH_TOKEN填你刚复制的 KeyANTHROPIC_BASE_URL填 TaoToken 的 API 地址不要带多余斜杠。permissions先留空后面按需放开。4.2 用批处理一次性写环境变量除了 settings.json也可以把 Token 和地址写进系统环境变量双保险。新建一个.bat文件内容如下echo off echo echo Claude Code Environment Setup echo echo. set /p API_KEYPlease enter your API Key: if %API_KEY% ( echo Error: API Key cannot be empty! pause exit /b 1 ) echo. echo Setting environment variables... setx ANTHROPIC_AUTH_TOKEN %API_KEY% setx ANTHROPIC_BASE_URL https://taotoken.net/api echo. echo echo Setup Complete! echo echo. echo Please restart your terminal for changes to take effect. echo. pause双击运行粘贴你的 Key回车即可。setx写入的是持久环境变量写完要重开终端才生效。settings.json 和环境变量同时配好能避免某些场景下只读其中一处导致的认证失败。5. 分步验证从版本检查到连通性测试配置完成后不要直接开干按下面顺序验证出问题好定位。第一步确认版本claude --version第二步确认环境变量已写入当前会话重开终端后执行echo $env:ANTHROPIC_BASE_URL应返回https://taotoken.net/api。如果为空说明环境变量没生效检查是否重开了终端。第三步直接启动claude首次启动会进入交互界面。如果配置正确你能正常对话并让它读文件、改代码。想先单独验证模型通道是否通可以打开模型对话页面发一条测试消息 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 能正常返回就说明 Key 和通道没问题问题只可能在客户端配置。第四步在项目里实测。进入任意代码目录执行claude让它读一个文件比如「读一下 package.json 并告诉我依赖」。能正常读取并回答说明整条链路通了。如果你打算长期用它做编码或接 Agent 工作流可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 按用量规划更省心。6. 本篇常见报错排查报错一claude 不是内部或外部命令回到 3.1 和 3.2用npm config get prefix找到全局目录确认claude.cmd存在再把该目录加进用户 Path重开终端。报错二执行 claude 后一直转圈或超时多半是 base_url 或 Token 不对。检查 settings.json 里ANTHROPIC_BASE_URL是否为https://taotoken.net/apiToken 是否复制完整前后无空格。改完保存重开终端再试。报错三认证失败 / 401Key 失效或填错。去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 重新生成一个替换 settings.json 和环境变量里的值。注意两处都要改只改一处可能仍读到旧值。报错四npm 安装卡住不动切镜像npm config set registry https://registry.npmmirror.com然后重跑安装命令。报错五VS Code 里插件一直转圈先确认终端里claude能正常跑。终端通了插件一般就通插件侧如果仍异常检查 VS Code 是否继承了系统环境变量必要时重启 VS Code 甚至重启系统让环境变量彻底生效。接入相关的完整说明可以对照文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 里面有各客户端的配置示例遇到字段不确定时翻一下比猜快。整套流程走下来真正花时间的不是安装命令而是 PATH 和配置这两处。把 settings.json 骨架存好下次换机器直接复制改个 Key 就能用。