1. Windows 上跑 Claude Code卡住的地方到底在哪Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯用命令行干活的开发者。它本身是 Node.js 写的 CLI 工具所以在 Windows 上安装并不复杂真正让人头疼的是后面那几步PowerShell 默认不让跑脚本、npm 全局路径没进 PATH、配置文件藏在用户目录里、API Key 和通道地址填错一个字符就 401。我见过太多人卡在claude命令找不到或者装完了却连不上模型反复重装 Node.js 也没用。这篇就把 Windows 下从零到能用的完整链路拆开讲Node.js/npm 环境准备、PowerShell 执行策略、Claude Code 安装、settings.json 骨架、统一 Key 与 API 通道配置最后用 PowerShell 命令验证调用链路真的通了。全程可复制照着做就行。需要说明的是Claude Code 默认走官方通道但很多国内开发者会选择用统一的 API 网关来管理 Key 和通道TaoToken 就是这类服务一个 Key 可以对接多种模型省去到处申请和切换的麻烦。下面配置里我会用 TaoToken 的地址做示例你换成自己的即可。2. 前置准备Node.js、npm 与 TaoToken 统一 Key2.1 装 Node.js别漏了 Add to PATHClaude Code 依赖 Node.js 18 以上版本建议直接上 LTS。去 nodejs.org 下载 Windows 的 LTS 安装包安装向导里有一个勾选项Add to PATH一定要勾上否则后面 npm 全局命令会找不到。装完打开 PowerShell 验证node --version npm --version正常会输出类似v20.11.0和10.2.4。如果提示「不是内部或外部命令」说明 PATH 没生效重启终端还不行就手动把 Node.js 安装目录加进系统环境变量。2.2 拿一个 TaoToken 统一 KeyTaoToken 的作用是把多个模型的调用收敛到一个入口你只需要一个 Key 和 一个 Base URL就能在 Claude Code 里切换使用。获取步骤打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key复制出来形如sk-xxxxxxxx。这个 Key 后面要填进配置文件别泄露。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite注意Base URL 只填域名部分不要带/v1这是最常见的 401 来源之一。3. 可复制配置PowerShell 装 Claude Code settings.json 骨架3.1 放开 PowerShell 执行策略Windows 默认的 Restricted 策略会拦住 npm 的脚本先给当前用户授权Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned执行后会问是否确认输入Y回车。这一步只影响当前用户不需要动系统级策略安全上更稳妥。3.2 安装 Claude Code用管理员身份打开 PowerShell右键开始菜单 → 终端(管理员)执行npm install -g anthropic-ai/claude-codelatest想锁定版本也行比如2.1.76。装完验证claude --version如果提示claude不是命令先查全局路径npm config get prefix通常输出C:\Users\用户名\AppData\Roaming\npm把这个路径加进系统 PATH重启终端再试。3.3 生成配置文件并写入统一 Key先进任意项目目录跑一次 Claude Code让它自动生成配置cd C:\你的项目路径 claude启动后按CtrlC退出此时C:\Users\用户名\.claude.json已经生成。用 VS Code 打开它插入env字段{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken Key, ANTHROPIC_BASE_URL: https://taotoken.net/api } }如果文件里已经有其他字段只把env这段插进去别删原有内容。JSON 对逗号和括号很敏感改完用 VS Code 的格式化检查一下。注意不要用系统环境变量的方式配这两个值在 Windows 上 Claude Code 读取不稳定直接写进.claude.json最可靠。4. 验证请求PowerShell 确认调用链路通了配置改完重新进项目目录启动cd C:\你的项目路径 claude首次运行会问是否信任这个 API Key选同意。然后随便输入一句让它干活比如帮我看看当前目录下有哪些文件并解释 package.json 的作用如果它能正常读取文件并返回解释说明 Key、Base URL、网络链路全通了。想更直接地验证通道可以用 PowerShell 发一个最小请求$headers { x-api-key sk-你的TaoToken Key anthropic-version 2023-06-01 content-type application/json } $body {model:claude-3-5-sonnet-20241022,max_tokens:32,messages:[{role:user,content:ping}]} Invoke-RestMethod -Uri https://taotoken.net/api/v1/messages -Method Post -Headers $headers -Body $body返回里带content字段就说明通道正常。注意这个验证 URL 带了/v1因为它是直接调 API而配置文件里的ANTHROPIC_BASE_URL不带/v1两者规则不同别搞混。想先在网页上试试模型对话可以走模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite5. 本篇常见错排查5.1 claude 命令找不到九成是 npm 全局路径没进 PATH。运行npm config get prefix拿到路径加进系统环境变量后重启终端。别只重开一个窗口要确保环境变量刷新。5.2 401 认证错误先检查 Key 有没有复制全前后有没有空格。再确认ANTHROPIC_BASE_URL没带/v1。如果还报错去控制台看 Key 是否被禁用或额度用尽。5.3 .claude.json 不存在这个文件是首次运行claude后自动生成的没跑过就不会有。先跑一次再退出文件就出现了。5.4 JSON 格式错误Claude Code 启动时如果配置文件解析失败会直接报错。用 VS Code 打开.claude.json看右下角有没有红色波浪线重点检查逗号和括号配对。5.5 npm 安装失败多半是权限问题用管理员身份重开终端再装。如果卡在下载检查网络或换 npm 镜像源。5.6 升级到最新版npm install -g anthropic-ai/claude-codelatest升级后配置不用重写.claude.json会保留。6. 长期编码与 Agent 场景怎么把链路用顺如果你只是偶尔用 Claude Code 改改脚本上面这套配置就够了。但如果你打算把它当成日常编码助手甚至跑 Agent 任务那 Key 的管理和额度规划就值得提前想清楚。TaoToken 的 Coding Plan 就是为这种长期编码场景准备的一个订阅覆盖多种模型调用不用每次换模型都去改配置。Coding Plan 入口https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档在这里遇到参数细节可以对照查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用的是 Claude Code 的 Anthropic 兼容模式这份说明也值得存一下https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite最后说个我踩过的坑改完.claude.json后一定要完全退出 Claude Code 再重进光在会话里改配置不生效。还有PowerShell 里路径带空格的项目目录要用引号包起来否则cd会失败。把这两点记住Windows 下这套链路基本就不会再折腾你了。