1. Windows 上装 Claude Code为什么总卡在第一步Claude Code 是 Anthropic 推出的命令行 AI 编程工具能直接在终端里读写项目文件、跑命令、改代码适合习惯用命令行干活的开发者。但它在 Windows 上的首次安装坑比 Mac 多得多Node.js 版本不对、npm 全局目录没权限、PowerShell 执行策略拦脚本、装完claude命令找不到……每一步都能让人卡半小时。这篇就按 Windows 真实环境走一遍从 Node.js 环境检查到 PowerShell 执行策略调整再到全局安装 Claude Code最后用 TaoToken 的统一 Key 接入并跑一条最小对话请求验证鉴权。全程命令可直接复制装完就能用。先说清楚适用人群你用的是 Windows 10/11没装过 Node.js 或者不确定版本想用 Claude Code 但不想折腾官方账号的地区限制。下面每一步我都会说明「为什么做」和「怎么验证做对了」避免你装完不知道成没成。2. 前置准备Node.js、npm 与 TaoToken 统一 Key2.1 检查 Node.js 和 npm 版本Claude Code 依赖 Node.js 运行环境官方要求 Node 18 以上。先打开 PowerShell普通权限即可后面装全局包时再提权输入node -v npm -v正常会输出类似v20.11.1和10.2.4。如果提示「不是内部或外部命令」说明没装 Node.js去 Node.js 官网下载 Windows 安装程序.msi一路下一步即可安装时勾选「Add to PATH」。版本低于 18 的话建议直接卸载重装新版别硬扛老版本 npm 装全局包经常报错。2.2 配置 npm 镜像加速国内直连 npm 官方源装全局包容易超时先换成国内镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令会回显镜像地址确认生效。这一步能省掉后面安装时一大半的等待和报错。2.3 拿到 TaoToken 的统一 KeyClaude Code 需要一个能鉴权的 API Key 才能调用模型。TaoToken 提供统一 Key 接入一个 Key 就能在 Claude Code 里用。注册后进控制台在 API Keys 页面新建一个令牌复制以sk-开头的字符串先存到记事本里后面配置要用。相关入口注册与主站https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注意Key 只显示一次页面关掉就看不到了务必先复制保存。额度按需设置个人开发设成不限额度也行。3. 可复制配置PowerShell 策略调整与全局安装3.1 调整 PowerShell 执行策略Windows 默认的执行策略会拦截 npm 生成的.ps1脚本导致claude命令报「无法加载文件因为在此系统上禁止运行脚本」。以管理员身份打开 PowerShell开始菜单搜 PowerShell右键「以管理员身份运行」执行Get-ExecutionPolicy Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedRemoteSigned表示本地脚本可运行、远程下载的脚本需签名安全性够用。执行完再Get-ExecutionPolicy确认返回RemoteSigned。3.2 全局安装 Claude Code回到普通 PowerShell 窗口执行全局安装npm install -g anthropic-ai/claude-code如果卡在下载加上镜像参数重试npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完验证claude --version能打印出版本号就说明命令已进 PATH。如果提示找不到命令多半是 npm 全局目录没在 PATH 里执行npm config get prefix看路径手动把该路径加进系统环境变量 Path重启终端再试。3.3 写 settings.json 骨架Claude Code 读取配置的方式有两种环境变量或项目/用户目录下的settings.json。推荐用settings.json一次配好长期生效。在用户目录下创建.claude文件夹里面放settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥 } }Windows 下用户目录一般是C:\Users\你的用户名\完整路径就是C:\Users\你的用户名\.claude\settings.json。把sk-你的TaoToken密钥替换成第 2.3 步复制的真实 Key。提示ANTHROPIC_BASE_URL填https://taotoken.net/api不要带多余斜杠或路径。Key 别提交到 Git建议把.claude加进全局 gitignore。4. 验证请求跑一条最小对话确认鉴权成功配置写完进任意项目目录启动cd D:\your-project claude首次启动会让你选主题、确认安全须知、选择默认终端配置、信任当前工作目录一路回车即可。进入交互界面后输入一句最小请求你好用一句话说明你是什么模型如果返回正常文本说明安装和鉴权都通了。想更省事也可以直接用非交互模式验证claude -p 输出当前目录的文件数量-p参数表示单次提问后退出适合脚本化验证。返回结果里能看到模型正常响应就代表 TaoToken 的 Key 已经生效。想先在网页端确认 Key 和模型是否可用可以打开模型对话页面测一句模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content网页端能正常对话说明 Key 本身没问题终端里再报错就是本地配置的事。5. 本篇常见报错排查5.1 claude 不是内部或外部命令npm 全局目录没进 PATH。执行npm config get prefix拿到路径比如C:\Users\你\AppData\Roaming\npm把它加到系统环境变量 Path关掉所有终端重开。5.2 禁止运行脚本回到 3.1 步用管理员 PowerShell 把执行策略改成RemoteSigned。改完新开窗口再跑claude。5.3 401 或鉴权失败九成是 Key 或 Base URL 写错。检查settings.json里ANTHROPIC_AUTH_TOKEN是否以sk-开头、有没有多余空格ANTHROPIC_BASE_URL是否为https://taotoken.net/api。改完保存重启终端。5.4 安装卡住或超时换镜像重装npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com。如果之前装了一半失败先npm uninstall -g anthropic-ai/claude-code清干净再装。5.5 启动后一直转圈无响应多半是网络到 API 地址不通。先用网页端模型对话确认 Key 可用再检查本地是否有防火墙拦截。终端里可以临时设环境变量覆盖配置测试$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKENsk-你的密钥 claude这样能快速判断是配置文件问题还是网络问题。6. 装完之后把 Claude Code 用顺手的几个建议安装只是起点。日常用 Claude Code 写代码、改 bug、跑 Agent 任务时Key 的调用频率会明显上升这时候可以看下 Coding Plan按长期编码场景做额度规划比单次调用更划算Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入细节和参数说明都在文档里遇到新报错先翻文档比搜帖子快接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句settings.json里的 Key 是明文别把.claude目录传到公开仓库。装完先跑通第 4 步的最小请求再进真实项目能少走很多弯路。