1. Windows11 升级 Claude Code 后为什么 PowerShell 里总是跑不通Claude Code 是 Anthropic 推出的终端 AI 编码工具能在 PowerShell 里直接读写项目文件、执行命令、跑测试。Windows11 用户升级它时最容易卡在三个地方npm 全局目录不统一导致装了新版却调用旧版、PowerShell 缓存了旧的 claude.ps1 路径、以及 API Key 没有正确写进配置文件。这篇就按「升级 → 统一 npm 目录 → 配置 Key → 验证 → 排错」的顺序把每一步的命令和文件骨架都给全目标是让你在 Windows11 的 PowerShell 里一次性跑通升级后的 Claude Code。适合谁看已经在 Windows11 上用 npm 装过 Claude Code、现在想升级到最新版并接入统一 Key 的本地开发者或者刚换机器、准备从零把终端 AI 编码环境搭起来的人。全程只需要 PowerShell 和 Node.js 环境不需要额外装别的工具。我试过在一台 npm 全局目录被改过两次的机器上升级结果claude --version一直显示旧版本排查了半小时才发现是 prefix 指向了另一个目录。所以下面第 3 步的目录统一建议你不要跳过。2. 前置准备TaoToken 统一 Key 与 Claude Code 的关系Claude Code 本身是一个客户端它需要向模型服务发请求。默认情况下它走 Anthropic 官方端点但在国内网络环境下直接连官方端点经常超时。TaoToken 提供的是兼容 Anthropic 接口协议的统一 Key你拿到一个 Key 之后把它填进 Claude Code 的配置里客户端就会把请求发到 TaoToken 的端点由它转发到对应模型。这样做的好处是你不需要在每台机器、每个工具里分别维护不同的 Key一个统一 Key 就能覆盖 Claude Code、以及其它支持 Anthropic 协议的工具。对本地开发者来说配置一次后面升级 Claude Code 时只要 Key 不变配置文件基本不用动。你需要提前准备两样东西一是 Node.js建议 18 以上node -v能输出版本号即可二是 TaoToken 的 API Key。Key 在控制台的 API Keys 页面创建创建后复制保存后面要填进配置文件。注意Key 属于敏感信息不要提交到 Git 仓库也不要在截图里暴露完整字符串。建议放在用户目录下的配置文件里而不是项目目录里。TaoToken 的接入文档里有完整的端点地址和参数说明配置前可以先扫一眼确认当前推荐的 base URL 写法。文档入口在文末 CTA 里给了。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 在 Windows 下的配置分两层一层是 Claude Code 自己的 settings.json另一层是它读取的模型接入配置。不同版本对配置文件的读取位置略有差异下面给的是当前主流版本可用的骨架你按自己实际安装版本微调路径即可。先看 settings.json。它一般放在用户目录下的.claude文件夹里Windows 路径是C:\Users\你的用户名\.claude\settings.json。如果文件夹不存在手动建一个。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken统一Key }, permissions: { allow: [], deny: [] } }这里两个字段是关键ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_API_KEY填你创建的统一 Key。注意 base URL 后面不要多加/v1之类的后缀按文档给的写法来多写反而会 404。再看 config.toml。部分版本的 Claude Code 或配套工具会读取 TOML 格式的配置骨架如下放在同一目录或工具指定目录[api] base_url https://taotoken.net/api api_key sk-你的TaoToken统一Key model claude-sonnet-4-5 [behavior] auto_approve false max_tokens 8192model字段填你实际要用的模型名不确定就先留默认跑通后再改。auto_approve建议先设 false避免工具自动执行你没确认的命令。配置写完后PowerShell 里可以用下面命令确认文件确实存在、内容没写错Get-Content $env:USERPROFILE\.claude\settings.json如果输出是乱码或报错多半是编码问题用 UTF-8 无 BOM 保存即可。4. 升级与验证npm 目录统一 PowerShell 实测请求配置就绪后先处理 npm 全局目录这是升级后版本不生效的头号原因。三步走npm config get prefix npm config set prefix C:\Users\你的用户名\npm-global npm config get prefix第一条看当前 prefix 指向哪第二条统一到用户目录下的 npm-global第三条确认改成功。改完后把C:\Users\你的用户名\npm-global加进系统 PATH否则新装的命令找不到。接着卸载旧版、装新版npm uninstall -g anthropic-ai/claude-code npm install -g anthropic-ai/claude-codelatest npm list -g anthropic-ai/claude-code如果下载慢可以临时加镜像源加速但装完建议换回默认源避免后续包版本对不上。装完后关键一步关掉当前 PowerShell重新开一个窗口。Windows PowerShell 会缓存命令路径不重启终端你调用的可能还是旧的 claude.ps1。重启后验证claude --version Get-Command claudeGet-Command会输出真实执行路径正常应该指向你刚统一的 npm-global 目录下的 claude.ps1。如果路径不对说明 PATH 里还有旧目录排在前面去系统环境变量里把它挪走或删掉。最后验证请求是否真的走通。在项目目录下启动claude进入交互界面后随便问一句比如让它读一下当前目录的文件列表。如果返回正常内容说明 Key 和 base URL 都生效了。如果报 401是 Key 填错或没生效报连接超时检查 base URL 是否写成了带多余后缀的地址。5. 本篇常见报错排查升级后版本没变化是最常见的。原因通常是 npm 全局目录不一致、PowerShell 用了旧的 claude.ps1、或者机器上存在多个 Node/npm 环境。排查命令就两条Get-Command claude npm config get prefix对比两者指向的目录是否一致。不一致就回到第 4 步重新统一 prefix并检查 PATH 顺序。where claude查不到这也是正常的。PowerShell 里 Claude Code 通常以 claude.ps1 形式存在不是传统 exe所以where可能找不到。改用Get-Command claude看真实路径就行。想看 npm 上最新版本号用npm view anthropic-ai/claude-code version对比本地claude --version就知道自己是不是真的升到了最新。还有一种情况配置写对了但启动后仍提示未授权。先确认 settings.json 的编码是 UTF-8再确认 Key 字符串前后没有多余空格或换行。PowerShell 里可以用下面命令检查 Key 是否被正确读取$env:ANTHROPIC_API_KEY如果输出为空说明环境变量没设上回到配置文件检查字段名拼写。提示如果你在 CI/CD 里用 Claude Code不要把版本写成 latest固定成具体版本号比如anthropic-ai/claude-code2.1.92避免本地和流水线版本不一致导致行为波动。6. 跑通之后把 Key 和配置固定下来升级这件事本身不复杂复杂的是环境里残留的旧目录和旧缓存。把 npm 全局目录统一、PATH 顺序理清、配置文件编码确认好后面每次升级基本就是卸载重装加重启终端三步。统一 Key 的价值在于你换机器、换工具时不用重新申请和记忆多套凭证一个 Key 填进对应配置文件即可。Claude Code 的接入配置和文档入口我放在下面配置过程中遇到字段不确定的直接对照文档改。接入文档与 API Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先在网页里验证模型是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期在终端里做编码和 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite最后留一个实用习惯每次升级完先跑Get-Command claude和claude --version两条命令确认路径和版本都对再进项目干活。这两条命令花不了十秒能省掉后面半小时的排查。
