1. Windows 下装 Claude Code 到底卡在哪npm 全局安装与鉴权链路拆解Claude Code 是 Anthropic 推出的终端 AI 编码代理能在 PowerShell 里直接读写项目文件、跑命令、改代码。它适合谁适合已经习惯命令行、想让 AI 直接动工程目录而不是只聊天的开发者。但很多人第一次装就卡住npm install -g报权限错、装完claude命令找不到、启动后一直转圈连不上、或者提示401却不知道 Key 该塞哪。我实测下来问题基本集中在三处Node.js 版本不够、npm 全局路径没进 PATH、以及鉴权配置写错了位置。Claude Code 读的是环境变量和settings.json不是随便设个系统变量就认。这篇就按「五步速装」的节奏走装 Node.js、装 CLI、拿统一 Key、写配置、跑一次对话验证。每一步都给可复制命令和配置片段Windows PowerShell 环境为主Mac/Linux 差异会单独标出来。先说清楚一个概念避免后面绕晕。Claude Code 本身是个客户端它需要一个「模型服务入口」来真正干活。默认它连 Anthropic 官方但国内直连不稳定所以常见做法是把ANTHROPIC_BASE_URL指向一个兼容 Anthropic 协议的统一通道再用一个 Key 走完所有模型调用。TaoToken 就是干这个的一个 Key 同时覆盖对话、编码、Agent 场景省得你在多个平台之间来回切。下面所有配置都围绕这个思路展开。装之前确认两件事你的 PowerShell 能正常联网以及你有管理员权限或者至少能改用户目录下的文件。不需要额外装什么代理工具配置里改 endpoint 就够了。2. 前置准备Node.js 18 与 TaoToken 统一 Key 获取2.1 装 Node.js 并验证版本Claude Code 基于 Node.js官方要求 18 以上推荐 20.x LTS。去 Node.js 官网下 Windows Installer.msiLTS 版双击一路默认记得勾选 “Add to PATH”。装完开一个新的 PowerShell重要旧窗口不会刷新 PATH敲node -v npm -v能打印出类似v20.11.1和10.2.4就对了。如果node提示不是内部命令说明 PATH 没生效重开终端或重启一次。Git 是可选项但部分功能比如 diff、仓库操作依赖它建议一起装。装完验证git --version2.2 拿 TaoToken 统一 Key打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后进控制台左侧找 API 令牌点添加令牌起个名字比如claude-code创建后复制那串sk-开头的 Key。这个 Key 就是你后面所有配置里要填的ANTHROPIC_AUTH_TOKEN。同时记下 Base URLhttps://taotoken.net/api。注意这个地址不带任何查询参数配置里原样写。注意Key 只显示一次复制后先存到记事本或密码管理器别等关了页面再找。到这里前置就齐了。Node.js 负责跑 CLITaoToken Key 负责让 CLI 有模型可用。接下来装 CLI。3. 五步速装npm 全局安装 Claude Code 与 settings.json 配置片段3.1 第一步切 npm 镜像可选但推荐国内直连 npm 官方源偶尔慢切到镜像能快不少npm config set registry https://registry.npmmirror.com想切回去用npm config set registry https://registry.npmjs.org。3.2 第二步全局安装 Claude Code CLInpm install -g anthropic-ai/claude-code如果报EACCES或权限错误用管理员身份开 PowerShell 再跑一次。装完验证claude --version打印版本号即成功。如果提示claude不是内部命令说明 npm 全局 bin 目录没进 PATH。查一下路径npm config get prefix把输出的路径通常是C:\Users\你的用户名\AppData\Roaming\npm加进系统环境变量 Path重开终端。3.3 第三步创建 settings.jsonWindows 路径是C:\Users\你的用户名\.claude\settings.jsonMac/Linux 是~/.claude/settings.json。目录不存在就先建。文件内容{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, API_TIMEOUT_MS: 3000000, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, ANTHROPIC_MODEL: claude-opus-4-6, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-5-20250929, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-haiku-4-5-20251001 } }三件套对照Base URL 填https://taotoken.net/apiKey 填你复制的sk-串Model ID 按上面填。环境变量ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL优先级高于配置文件所以如果你之前设过系统变量记得清掉或改成一致否则会互相打架。3.4 第四步新增 .claude.json 跳过引导Windows 路径C:\Users\你的用户名\.claude.jsonMac/Linux 是~/.claude.json。内容{ hasCompletedOnboarding: true }这个参数让 CLI 跳过首次启动的交互式引导直接进对话。3.5 第五步启动并验证claude第一次跑会读配置、连 endpoint。如果一切正常你会看到交互提示符直接输入问题即可。想非交互式跑一次claude -p 用一句话解释什么是闭包能返回内容就说明整条链路通了。4. 验证请求一次对话与生成文件确认闭环配置写完不算完得真跑一次确认。开 PowerShell进一个空目录mkdir claude-test cd claude-test claude启动后输入帮我写一个 hello.js打印当前时间Claude Code 会分析意图、生成文件、甚至问你要不要执行。确认后目录里会出现hello.js。用node hello.js跑一下能输出时间就说明模型调用、文件写入都正常。再验证一次纯对话确认不是只有文件操作能用claude -p 把下面这句话翻译成英文今天天气不错返回英文翻译即成功。这一步同时验证了ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL两个模型都能被正确路由。如果你在配置里用了ANTHROPIC_DEFAULT_SONNET_MODEL这类映射可以显式指定模型再测一次claude -p 11等于几 --model claude-sonnet-4-5-20250929能返回2就说明模型 ID 映射生效。实测下来最容易出问题的是 Key 前后带了空格或者 Base URL 多写了斜杠。复制时留意。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth401 UnauthorizedKey 错了或没生效。检查settings.json里ANTHROPIC_AUTH_TOKEN是不是完整的sk-串有没有多余空格。如果你之前设过系统环境变量ANTHROPIC_AUTH_TOKEN它会覆盖配置文件用echo $env:ANTHROPIC_AUTH_TOKEN查一下不一致就删掉系统变量。local proxy failed / connection refusedBase URL 写错或网络不通。确认是https://taotoken.net/api不要带尾部斜杠也不要在末尾加/v1。改完重启终端。reading choices 相关报错通常是返回体不是预期 JSON多半是 endpoint 指到了网页而不是 API。核对 Base URL 是否精确。OAuth 报错 / 一直要求登录.claude.json里hasCompletedOnboarding没写或写错位置。确认文件在用户目录根下不是.claude文件夹里。claude 命令找不到npm 全局 bin 没进 PATH按 3.2 的方法加。版本过旧更新命令npm update -g anthropic-ai/claude-code排查顺序建议先claude --version确认装上了再claude -p test确认能连最后才查配置细节。大部分问题在第二步就能暴露。6. 装完之后把 TaoToken 用顺的几个入口装好只是开始。日常用 Claude Code 跑编码任务Key 和 endpoint 稳定是关键。TaoToken 这边几个入口按场景分想先试试模型对话效果去模型对话页https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期跑编码、Agent 任务看 Coding Planhttps://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite管理 Key、看用量进控制台https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite需要新建或轮换 Key去 API Keys 页https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite配置细节和协议说明查接入文档https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你还用 Claude Code 的 Anthropic 兼容模式接其他工具参考https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后给个实用技巧把settings.json备份一份换机器时直接拷过去改 Key 就行。模型 ID 如果官方更新了改配置里的映射字段即可不用重装 CLI。