1. Windows 上跑 ClaudeCode卡住新手的三个地方ClaudeCode 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、执行命令、跑测试适合习惯用 CLI 干活的开发者。它本身是个 Node.js 包理论上npm install -g就能装好但 Windows 用户第一次上手十有八九会卡在三个地方Node.js 版本不对导致安装报错、PowerShell 执行策略拦住了脚本、以及 API 通道没配好导致启动后一直转圈或直接 401。我试过在一台干净的 Windows 11 机器上从零走一遍发现真正花时间的不是敲命令而是搞清楚「环境变量到底设在哪一层」「settings.json 和系统环境变量谁优先」这类细节。这篇就把整个流程拆开从装 Node.js 到写出可复制的 settings.json再到用 PowerShell 验证请求真的通了一步步来。你跟着做大概二十分钟能跑起来。核心检索词先摆出来ClaudeCode 在 Windows 下的安装依赖 Node.js 18通过 npm 全局安装用 PowerShell 配置 API 通道最终靠 settings.json 或环境变量把请求指向统一 API 网关。适合谁适合想在 Windows 本地用命令行 AI 编程、又不想折腾多套 Key 的开发者。2. 前置准备Node.js 环境与 TaoToken 通道2.1 Node.js 装哪个版本、怎么装ClaudeCode 要求 Node.js 18 或更高。我建议直接上 LTS 版本别追最新奇数版。两种装法官网下载.msi安装包双击一路默认安装向导会自动把node和npm加进 PATH。装完必须重开一个 PowerShell 窗口否则 PATH 不刷新敲node -v会提示找不到命令。如果你装了 Chocolatey 或 Scoop命令行更省事# Chocolatey choco install nodejs-lts -y # 或者 Scoop scoop install nodejs-lts装完验证两个命令都要有版本号输出node --version npm --version预期类似v20.11.1和10.2.4。如果node有输出但npm报错多半是安装时没勾选 npm 组件重装一遍即可。2.2 为什么用 TaoToken 统一通道ClaudeCode 默认要连 Anthropic 官方端点但很多人的实际需求是一个 Key 走多个模型、方便切换、集中看用量。TaoToken 提供统一的 API 通道把 ClaudeCode 的请求指向https://taotoken.net/api即可Key 在控制台生成模型对话、编码计划、API Keys 都在同一套体系里管理。这里要拿两样东西一个 API Key以及确认接入端点。Key 的生成入口在控制台的 API Keys 页面接入文档里有完整的端点说明。先把这两个地址记下来后面配置要用官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 端点https://taotoken.net/api注意Key 只在生成时完整显示一次复制后先存到临时文本里别关页面就找不到了。3. 可复制配置settings.json 骨架与 PowerShell 权限3.1 先解决 PowerShell 执行策略Windows 默认的执行策略是Restricted会拦住 npm 生成的.ps1脚本表现就是装 ClaudeCode 时报「无法加载文件因为在此系统上禁止运行脚本」。用一条命令放开当前用户级别Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned的意思是本地脚本可跑、远程下载的脚本需签名对开发场景够用也比Unrestricted安全。执行后输入Y确认。验证Get-ExecutionPolicy -Scope CurrentUser输出RemoteSigned就对了。3.2 全局安装 ClaudeCodenpm install -g anthropic-ai/claude-code如果这一步报permission denied或EACCES别急着用管理员权限硬刚更稳的做法是把 npm 全局目录改到用户目录下npm config set prefix $env:APPDATA\npm然后把%APPDATA%\npm加进用户 PATH重开 PowerShell 再装。装完验证claude --version有版本号输出即安装成功。3.3 settings.json 骨架配置ClaudeCode 读取配置的优先级大致是项目级.claude/settings.json 用户级~/.claude/settings.json 系统环境变量。推荐用用户级 settings.json一次配好全局生效。文件路径在C:\Users\你的用户名\.claude\settings.json没有就新建。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 在这里填你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 }, permissions: { allow: [ Read, Write, Bash(git status), Bash(npm run test) ] } }几个字段说明ANTHROPIC_BASE_URL指向统一通道端点注意结尾不要多加/v1之类的路径ClaudeCode 会自己拼ANTHROPIC_AUTH_TOKEN填控制台生成的 KeyANTHROPIC_MODEL指定默认模型不写则用内置默认。permissions.allow是白名单把常用只读命令和测试命令放进去减少每次弹确认。如果你更习惯用环境变量而不是 settings.jsonPowerShell 用户级永久设置这样写[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, [System.EnvironmentVariableTarget]::User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, 你的TaoToken密钥, [System.EnvironmentVariableTarget]::User)设完必须重开 PowerShell当前窗口读不到新变量。验证echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN两条都要有值输出为空说明没设上。4. 验证请求确认 ClaudeCode 真的连上了配置写完不算完得确认请求真的通。分三步验证。第一步检查环境变量或 settings.json 是否被读到。在 PowerShell 里claude --version echo $env:ANTHROPIC_BASE_URL如果ANTHROPIC_BASE_URL为空但你明明写了 settings.json说明 ClaudeCode 还没加载到该文件检查路径和文件名拼写。第二步进一个测试项目目录启动cd C:\path\to\your\project claude启动后界面会显示当前模型和会话状态。输入一句简单指令比如「列出当前目录的文件」观察是否正常返回。如果卡住不动或报 401多半是 Key 无效或端点写错。第三步用一条最小请求直接打端点排除 ClaudeCode 本身的干扰$headers { Authorization Bearer $env:ANTHROPIC_AUTH_TOKEN Content-Type application/json } $body {model:claude-sonnet-4-5,max_tokens:50,messages:[{role:user,content:say hi}]} Invoke-RestMethod -Uri https://taotoken.net/api/v1/messages -Method Post -Headers $headers -Body $body返回里带content字段和文本内容说明 Key 和端点都没问题。这一步能通、ClaudeCode 却报错那问题就在 ClaudeCode 的配置读取上回头查 settings.json 的 JSON 格式有没有多余逗号。成功结果长这样ClaudeCode 启动后能正常对话执行claude后输入指令有响应/model命令能切换模型。到这一步Windows 环境就算搭完了。5. 本篇常见报错排查报错一claude : 无法将claude项识别为 cmdlet说明 npm 全局目录不在 PATH 里。检查npm config get prefix的输出路径把该路径加进用户环境变量 PATH重开 PowerShell。报错二无法加载文件 ... 因为在此系统上禁止运行脚本执行策略没放开。回到 3.1 节跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。报错三启动后一直转圈或返回 401Key 无效或端点写错。先用第 4 节的Invoke-RestMethod单独测端点确认 Key 本身可用再检查 settings.json 里ANTHROPIC_BASE_URL是否误加了/v1后缀。报错四settings.json 改了不生效JSON 格式错误会被静默忽略。用编辑器校验括号和逗号或者把配置临时改成环境变量方式对比测试。另外注意项目级.claude/settings.json会覆盖用户级检查项目目录里有没有同名文件。报错五杀毒软件拦截 npm 脚本部分安全软件会误报 npm 的.ps1脚本。把%APPDATA%\npm目录加进白名单或临时关闭实时防护再装。报错六npm install -g卡在 idealTree 不动多半是网络或缓存问题。先npm cache clean --force再重试仍不行就换用npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com走镜像源。6. 配好之后Key 管理与长期使用环境搭好后日常最常打交道的两个入口一个是 API Keys 页面用来生成、轮换、吊销 Key另一个是接入文档端点变更或新增模型时会更新在这里。如果你打算长期用 ClaudeCode 做编码和 Agent 任务可以了解下 Coding Plan它把编码场景的用量和模型调度打包管理比单次按量更省心。想先验证模型效果直接进模型对话页面发几条指令试试确认返回质量再决定用哪个模型做默认。一个实用习惯把ANTHROPIC_MODEL设成你常用的那个项目里再按需用/model临时切换。Key 不要硬编码进项目文件提交到仓库settings.json 放在用户目录下、加进.gitignore的全局忽略规则里更稳妥。