1. Windows 下 Claude Code 安装踩坑实录Node.js 环境准备与 PowerShell 权限报错怎么解Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接在命令行里读写项目文件、跑测试、改 bug适合习惯用终端和 VSCode 干活的开发者。它本身是个 npm 全局包所以第一道门槛不是 AI而是 Node.js 环境。我在 Windows 上装的时候前前后后卡了三次一次是 Node 版本太老一次是 PowerShell 执行策略拦住了脚本还有一次是 npm 全局路径没进 PATH敲claude直接提示找不到命令。这篇就把 Windows 下从零到首次跑通的完整流程写清楚包括 Node.js/npm 准备、PowerShell 与 VSCode 集成、以及通过 TaoToken 接入 API 通道的配置片段命令都能直接复制。先说清楚它适合谁如果你平时用 VSCode 写代码又愿意在终端里让 AI 帮你批量改文件、生成 commit、跑 lint那 Claude Code 很对路。它不是一个网页聊天窗口而是一个能动手的 agent。但前提是环境得先搭对否则你会在各种报错里打转。Windows 上最容易忽略的是 Git for Windows。Claude Code 内部有些操作依赖 Git 的 shell 环境没装的话某些命令会莫名其妙失败。所以第一步不是装 Claude Code而是把地基打好Node.js 18、Git for Windows、一个能正常用的 PowerShell。这三样齐了后面才顺。我建议 Node.js 用官方 LTS 安装包直接装Windows 下 nvm 虽然也能用但切换版本时偶尔和全局包路径打架新手容易懵。装完先验证版本再动 Claude Code。下面按顺序来。1.1 安装 Node.js 18 并验证 npm去 Node.js 官网下载 LTS 版本当前是 20.x 或 22.x 都行双击安装安装向导里记得勾选 Add to PATH。装完打开 PowerShell敲node -v npm -v正常会输出类似v20.11.1和10.2.4。如果node -v报不是内部或外部命令说明 PATH 没生效关掉 PowerShell 重开一次或者重启电脑。这一步别跳过版本低于 18 的话 Claude Code 装上了也跑不起来。1.2 安装 Git for Windows去 git-scm.com 下载 Windows 版一路默认下一步即可。装完验证git --version输出git version 2.4x.x就对了。Git 自带的 bash 环境对 Claude Code 执行某些 shell 命令有帮助尤其是涉及文件路径和管道操作时。1.3 全局安装 Claude Code环境齐了一条命令装npm install -g anthropic-ai/claude-code装完验证claude --version能打印出版本号就说明二进制已经就位。如果这里报claude : 无法将claude项识别为 cmdlet...八成是 npm 全局路径没进系统 PATH下一节专门讲这个。1.4 PowerShell 执行策略报错的处理在 VSCode 里用 Claude Code 之前得确认 PowerShell 允许执行脚本。先查get-ExecutionPolicy如果返回Restricted脚本会被拦。改成set-ExecutionPolicy RemoteSignedRemoteSigned的意思是本地脚本随便跑从网上下载的脚本需要签名安全性和可用性平衡得比较好。改完再查一次确认变成RemoteSigned。这一步不做后面在 VSCode 终端里调用 Claude Code 可能直接报无法加载文件因为在此系统上禁止运行脚本。1.5 把 npm 全局路径加进系统环境变量先查 npm 全局包装在哪npm config get prefix通常会输出C:\Users\你的用户名\AppData\Roaming\npm。复制这个路径然后右键此电脑 → 属性 → 高级系统设置 → 环境变量。在系统变量里找到Path双击编辑新建一条把刚才的路径粘进去保存。关掉所有终端重开再敲claude --version这次应该能认出来了。这一步是 Windows 上最高频的坑很多人装完 npm 包发现命令找不到就是 PATH 没配。2. TaoToken 前置准备API Key 获取与 Base URL 确认Claude Code 装好只是有了壳真正让它干活的是背后的模型通道。默认它连的是 Anthropic 官方但国内直连不稳定所以更实际的做法是接一个兼容 Anthropic 协议的 API 通道。TaoToken 提供的就是这种通道Base URL 和 Key 配好Claude Code 就能正常发请求。你需要准备两样东西一个 API Key一个 Base URL。Key 在控制台生成Base URL 用https://taotoken.net/api。注意这个地址后面配置时不要多加斜杠也不要带多余路径Claude Code 会自己在后面拼/v1/messages之类的端点。获取 Key 的入口在控制台的 API Keys 页面登录后新建一个复制出来存好。这个 Key 只显示一次丢了就得重建。建议直接放进环境变量别硬编码在配置文件里避免不小心提交到 Git。TaoToken 的定位是 API 通道不是编辑器插件所以它不替代 VSCode也不替代 Claude Code 本身。你仍然是在终端里用claude命令只是请求发往 TaoToken 的地址。理解这一点很重要很多人以为装个插件就行其实配置的是环境变量。模型 ID 这块Claude Code 默认会请求 Anthropic 的模型名比如claude-sonnet-4-5之类。TaoToken 侧兼容这些模型标识你不需要额外改模型名只要 Base URL 和 Key 对请求就能路由过去。如果你在别的工具里看到要填 Model ID填claude-sonnet-4-5或对应版本即可。配置方式有两种环境变量和 settings 文件。环境变量最直接适合先跑通settings 文件适合长期用能固化下来。下面两节分别给可复制的片段。2.1 用环境变量配置 Base URL 和 KeyPowerShell 里临时设置当前窗口有效$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的Key设完直接敲claude就能用。但这种方式关掉窗口就没了适合测试。要永久生效用系统环境变量[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://taotoken.net/api,User) [Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY,你的Key,User)设完重开终端。注意ANTHROPIC_API_KEY这个变量名是 Claude Code 认的别写成别的。2.2 用 settings.json 固化配置Claude Code 支持在用户目录下放 settings 文件。Windows 路径是C:\Users\你的用户名\.claude\settings.json。没有这个目录就手动建。内容{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的Key } }这个文件的好处是配置跟着用户走换终端、换 VSCode 窗口都生效。注意 JSON 不能有注释逗号也别多写。改完保存重开终端。如果你同时用多个工具比如 Cline、Codex 之类它们的配置文件名不一样但核心三件套是一样的Base URL、Key、Model ID。Claude Code 这里 Model ID 通常不用显式填走默认即可。2.3 确认配置生效配完先别急着写代码敲一条命令看能不能通claude --version版本能出来只说明二进制在。真正验证通道进一个空目录敲claude进入交互随便问一句你好看它能不能回。如果回你了说明 Base URL 和 Key 都对。如果报 401就是 Key 错了如果报连接失败就是 Base URL 或网络问题。下一节详细讲验证。3. 可复制配置片段settings.json 与 VSCode 集成这一节把配置片段集中放出来方便你直接抄。Claude Code 的配置分两层一层是 API 通道Base URL Key一层是编辑器集成VSCode 终端 PowerShell 策略。两层都配好体验才完整。先说 settings.json。上面给过一版这里补一个更完整的包含模型和权限相关字段。注意不同版本字段可能有差异以你装的那个版本为准不确定的字段先别加跑通基础版再说。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的Key }, permissions: { allow: [], deny: [] } }permissions这块控制 Claude Code 能自动执行哪些操作。默认它会问你比如要改文件、跑命令时会弹确认。你可以在allow里加规则让它自动做但新手建议先留空等熟悉了再放开避免它误改重要文件。VSCode 集成这块其实不需要装额外插件。Claude Code 是终端工具你在 VSCode 里按Ctrl打开集成终端直接敲claude就行。关键是这个终端得是 PowerShell而且执行策略得是RemoteSigned否则会报脚本被禁。如果你在 VSCode 终端里敲claude提示找不到先确认 VSCode 用的终端类型。点终端面板右上角的下拉选 PowerShell。如果还是不行检查 VSCode 是不是从旧的环境变量启动的彻底关掉 VSCode 重开一次。还有一个细节VSCode 的终端默认工作目录是当前打开的项目根目录Claude Code 会以这个目录为上下文。所以用之前先cd到你的项目里或者在 VSCode 里打开项目文件夹这样它读写文件都在正确的位置。3.1 完整 settings.json 路径与内容路径C:\Users\你的用户名\.claude\settings.json内容把 Key 换成你自己的{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-xxxxxxxx } }保存后在 PowerShell 里验证环境变量有没有被读到echo $env:ANTHROPIC_BASE_URL如果输出https://taotoken.net/api说明生效。如果为空检查文件路径和 JSON 格式JSON 解析失败的话 Claude Code 会静默忽略。3.2 VSCode 终端配置要点VSCode 里按CtrlShiftP输入 Terminal: Select Default Profile选 Windows PowerShell。然后Ctrl打开终端敲claude --version claude第二条进入交互界面。如果界面出来了说明集成成功。这时候你可以让它读当前项目比如输入看一下这个项目的结构它会调用工具列目录、读文件。3.3 三件套对照Base URL、Key、Model ID不管你用哪个工具接入兼容 Anthropic 的通道都绕不开这三个配置项值说明Base URLhttps://taotoken.net/api请求发往的地址API Key控制台生成身份凭证Model IDclaude-sonnet-4-5模型标识Claude Code 默认走这个Claude Code 里 Model ID 一般不用手填但如果你在别的工具比如 Cline、Codex里配就要显式写。三件套对齐了通道就通。4. 验证请求与成功结果从 claude --version 到首次对话配置写完得验证。验证分三层二进制在不在、通道通不通、能不能干活。一层层来出问题好定位。第一层claude --version。这个前面说过能出版本号就说明 npm 全局包装好了PATH 也对。如果这步就挂回去看第 1 节的 PATH 配置。第二层通道验证。进一个空目录敲claude进入交互后输入一句简单的话比如回复 ok。如果它回了说明 Base URL 和 Key 都对请求成功路由到 TaoToken 并返回了模型输出。这一步成功你就已经跑通了核心链路。第三层实际干活。在项目目录里启动claude输入列出当前目录的文件看它能不能调用工具。Claude Code 会执行ls或dir之类的命令把结果读回来。如果它能正确列出文件说明工具调用也通了。我实测下来第一次跑通大概需要 5 分钟主要时间花在装 Node 和配 PATH 上。通道配置本身很快两条环境变量的事。真正容易卡的是 PowerShell 策略和 PATH这两个搞定后面就顺。4.1 验证命令与预期输出claude --version # 预期1.x.x 之类的版本号 claude # 进入交互输入你好 # 预期模型返回一段中文回复如果claude命令进入交互后一直转圈最后报超时检查 Base URL 是不是写成了https://taotoken.net/api/多了斜杠或者网络能不能访问这个地址。可以在 PowerShell 里curl https://taotoken.net/api看有没有响应。4.2 首次对话成功的标志成功标志有三个一是交互界面正常显示没有报错刷屏二是你输入后模型有回复不是空响应三是它能调用工具比如你让它读文件它真的读了并返回内容。三个都满足说明安装和配置全部到位。如果模型回复了但工具调用失败比如报permission denied那是 Claude Code 的权限确认机制它在问你要不要允许执行某个命令。按提示确认即可或者在 settings.json 的permissions.allow里加规则。4.3 在 VSCode 里跑通的完整流程打开 VSCode打开你的项目文件夹Ctrl开终端确认是 PowerShell敲claude。进去后输入这个项目是做什么的它会读 README 和目录结构给你一个概述。这一步跑通你就能在日常开发里用它了。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth装 Claude Code 的过程里报错基本集中在几个地方。我把遇到的和我收集到的整理出来对照着查。401 UnauthorizedKey 错了或者没生效。先echo $env:ANTHROPIC_API_KEY看有没有值再看值是不是完整有没有多余空格。如果用的是 settings.json检查 JSON 格式解析失败会静默忽略。还有一种可能是 Key 被禁用或额度用完去控制台确认。local proxy failed / connection refusedBase URL 写错或者网络到不了。确认是https://taotoken.net/api不要带路径后缀。如果公司网络有代理可能需要额外配置但注意别用违规的网络工具正常企业代理走系统设置即可。reading choices / unexpected response这种通常是返回体格式不对多半是 Base URL 指到了不兼容的端点。Claude Code 期望 Anthropic 格式的响应如果通道不兼容就会解析失败。确认你用的是兼容 Anthropic 协议的地址。OAuth / authentication failedClaude Code 某些版本会尝试 OAuth 登录如果你已经用 API Key 配置了它可能还在走旧的登录态。清掉~/.claude下的缓存文件或者检查有没有残留的登录配置覆盖了环境变量。claude 不是内部或外部命令PATH 问题回第 1.5 节。npm 全局路径没进系统变量或者进了但没重开终端。无法加载文件因为在此系统上禁止运行脚本PowerShell 执行策略回第 1.4 节set-ExecutionPolicy RemoteSigned。装完在 VSCode 里找不到 claudeVSCode 终端类型不对或者 VSCode 是从旧环境启动的。切 PowerShell重启 VSCode。5.1 报错对照表报错原因处理401Key 错/失效检查环境变量和 Key 状态local proxy failedBase URL 错/网络不通确认地址检查网络reading choices响应格式不兼容换兼容 Anthropic 的端点OAuth failed登录态冲突清缓存用 Key 配置命令找不到PATH 没配加 npm 全局路径到系统变量脚本被禁执行策略 Restricted改 RemoteSigned5.2 排查顺序建议先看claude --version过不过不过就是安装/PATH 问题。过了再看通道进交互问一句不回就是 Key/Base URL 问题。回了但工具调用失败就是权限或环境问题。按这个顺序基本能定位到具体环节。6. 长期编码与 Agent 场景把 Claude Code 用顺手的几个配置跑通之后怎么用得舒服是另一回事。Claude Code 默认每次操作都问你安全但烦。你可以在 settings.json 里逐步放开常用操作的权限比如读文件、列目录这些无副作用的让它自动做。改文件、跑命令这种有副作用的建议保留确认或者只对特定目录放开。另一个是项目级配置。Claude Code 支持在项目根目录放.claude/settings.json覆盖用户级配置。这样不同项目可以用不同的权限和模型设置。比如前端项目放开 npm 命令后端项目放开测试命令。如果你要长期跑 agent 任务比如让它自动修 bug、跑测试循环那 API 通道的稳定性就很重要。TaoToken 的 Coding Plan 适合这种持续调用的场景比按次计费更划算。配置方式不变还是 Base URL Key只是套餐不同。最后提醒一句Claude Code 能改文件用之前确保项目有 Git 版本控制出问题能回滚。这是血的教训我第一次让它批量重构没提交就跑了结果改乱了一堆文件靠git checkout救回来。养成先 commit 再让它动手的习惯。配置入口我放这里按需取API Key 在控制台的 API Keys 页面生成接入文档在文档页有详细说明模型对话页可以快速验证通道Coding Plan 适合长期编码场景。装完跑通后建议先在个人小项目上练手熟悉它的行为模式再放到正式项目里用。