1. Windows 上装 Claude Code 到底卡在哪：git、node.js、npm 与 PowerShell 的完整链路
很多人第一次在 Windows 上折腾 Claude Code，卡住的地方往往不是模型本身，而是环境链路。你搜「claude 保姆级安装教程」，大概率会看到一堆让你先装 git、再装 node.js、然后 npm 全局安装、最后还要改 PowerShell 权限的步骤，但每一步为什么做、报错了怎么办，很少有人讲清楚。我先把这条链路拆开说：Claude Code 是一个跑在终端里的命令行工具，它依赖 Node.js 运行时，npm 是 Node.js 自带的包管理器，git 用来做版本控制以及某些依赖的拉取，PowerShell 则是 Windows 上你敲命令的窗口。四者缺一个，安装就会在某个环节断掉。
这篇文章面向的是第一次在 Windows 上配置 Claude 的开发者，目标很明确：从零把 git、node.js、npm、PowerShell 这条链路打通，然后把 API 通道切到 TaoToken，最后跑通一次真实对话请求，确认安装真的可用，而不是「装完了但一跑就报错」。我会给出可以直接复制的环境检查命令、npm 全局安装步骤、PowerShell 执行策略设置，以及切换 API 通道的配置片段。你跟着做，遇到报错就翻到第 5 节的排查对照表。
先说清楚 Claude Code 能做什么：它是一个终端里的 AI 编码助手，可以在你的项目目录里读文件、改代码、跑命令，适合习惯命令行工作流的开发者。它不适合只想在网页里聊天的人，也不适合完全没碰过终端的小白——但如果你愿意跟着敲几条命令，这篇就是为你写的。整个安装过程大概 15 到 30 分钟，取决于你的网络下载速度。
我建议你按顺序来：先检查系统里已经有什么，再补缺的，最后配置 API 通道。不要跳步，尤其是 PowerShell 权限那一步，很多人跳过之后 npm 全局安装直接失败，然后又回头找原因，反而更慢。下面从环境检查开始。
2. 装 Claude Code 前先把 TaoToken 通道准备好：API Key 与 Base URL 怎么拿
在动手装 Claude Code 之前，先把「通道」准备好，这样装完就能直接验证，不用装到一半再回头找 Key。TaoToken 在这里扮演的角色是 API 通道：Claude Code 默认会去连官方端点，但你可以通过环境变量把请求指向 TaoToken 的兼容端点，用同一个工具、同一套命令，只是请求走不同的通道。对国内开发者来说，这样能省掉不少网络层面的折腾。
你需要准备两样东西：一个 API Key，和一个 Base URL。Base URL 是https://taotoken.net/api，注意这个地址不带任何查询参数，直接填就行。API Key 需要你登录后在控制台里创建。具体路径是：先打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册登录，然后进控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 创建密钥，在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 可以生成和管理你的 Key。生成后先复制存好，后面配置环境变量要用。
这里有个细节要注意：Claude Code 读取的是环境变量，不是配置文件里的明文。所以你要做的是把 Key 和 Base URL 写进环境变量，而不是改某个 JSON。Windows 上设置环境变量有两种方式，一种是临时在当前 PowerShell 会话里设，关掉窗口就失效；另一种是写进系统环境变量，永久生效。我建议先用临时方式验证，跑通了再写永久，这样出错了好回退。
另外，如果你后面要用到 Coding Plan 这类长期编码或 Agent 场景，可以在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 了解套餐；只是想先验证模型能不能通，用模型对话页面 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 也能快速试。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，遇到参数不确定就翻文档。把这两样准备好，我们再进安装环节。
3. 可复制配置：git、node.js、npm 全局安装与 PowerShell 权限设置
这一节是全文的核心操作区，每一步都给可复制的命令。先装 git。打开 https://git-scm.com/download/win 下载 Windows 版安装包，双击后一路 Next 即可，默认选项对绝大多数人够用。装完打开 PowerShell（Win+X 然后选 Windows PowerShell，或者搜 PowerShell），输入下面这条验证：
git --version正常会输出类似git version 2.4x.x.windows.1。如果提示「无法将 git 项识别为 cmdlet」，说明安装没进 PATH，重装一次并确认安装时勾选了「Git from the command line」。
接着装 Node.js。打开 https://nodejs.org 下载 LTS 版，建议 20.x LTS，双击安装，全部 Next 默认即可。装完回到 PowerShell 验证：
node -v npm -vnode -v应输出v20.x.x，npm -v输出10.x.x左右。npm 是随 Node.js 一起装的，不用单独装。如果npm -v报错，多半是 Node.js 没装好，重装即可。
然后是 PowerShell 执行策略。npm 全局安装脚本在默认策略下可能被拦，先看一眼当前策略：
Get-ExecutionPolicy如果返回Restricted，改成允许本地脚本：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned执行时会问你是否确认，输入Y回车。这一步只影响当前用户，比较安全。改完再确认一次Get-ExecutionPolicy返回RemoteSigned就行。
现在装 Claude Code：
npm install -g @anthropic-ai/claude-code等待下载完成，出现added x packages之类提示即成功。验证：
claude --version能输出版本号就说明命令可用。接下来配置 API 通道。临时方式（当前窗口有效）：
$env:ANTHROPIC_BASE_URL="https://taotoken.net/api" $env:ANTHROPIC_API_KEY="你的Key"如果你希望永久生效，用setx：
setx ANTHROPIC_BASE_URL "https://taotoken.net/api" setx ANTHROPIC_API_KEY "你的Key"注意setx写入后要新开一个 PowerShell 窗口才生效。这里三件套要记全：Base URL 是https://taotoken.net/api，Key 是你创建的密钥，Model ID 在对话时指定，比如claude-sonnet-4-5这类，具体以文档为准。配置片段写成 JSON 形式对照如下，方便你核对字段：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key" }, "model": "claude-sonnet-4-5" }如果你用的是 Claude Code 的 settings 文件，路径通常在用户目录下的.claude/settings.json，把上面的env段填进去即可。填完保存，回到 PowerShell 继续下一节验证。
4. 验证请求：跑通一次对话，确认 Claude Code 真的连上了
配置写完不代表能用，必须跑一次真实请求。最直接的方式是进一个空目录，启动 Claude Code：
mkdir claude-test cd claude-test claude第一次启动可能会让你确认一些初始化选项，按提示走。进入交互界面后，输入一句简单的话，比如「用一句话解释什么是递归」。如果通道配置正确，你会看到模型返回内容，这就说明请求真的发出去了，而且走的是 TaoToken 的端点。
如果不想进交互界面，也可以用一次性命令验证：
claude -p "用一句话解释什么是递归"-p是 prompt 模式，直接输出结果不进入对话。实测下来，这条命令能最快判断通道是否通。返回正常文本，说明 Base URL、Key、Model ID 三件套都对上了。
再进一步，验证它能不能读文件。在claude-test目录里建一个hello.py：
def add(a, b): return a + b然后运行：
claude -p "解释 hello.py 里的函数做了什么"如果它能读出文件内容并解释，说明工具的文件访问也正常。这一步很关键，因为 Claude Code 的核心价值就是在项目里干活，只会聊天不算装好。
成功的结果长这样：命令返回一段中文解释，提到add函数接收两个参数并返回它们的和。没有报错、没有卡住、没有让你反复登录。到这一步，你的安装链路就算真正打通了。如果这里失败，别急着重装，先看下一节的报错对照，大部分问题都能对上号。
5. 本篇常见错排查：401、local proxy failed、reading choices 与 OAuth 报错
装 Claude Code 最容易撞上的几类报错，我按真实情况列出来，你对号入座。
第一类是 401。报错里出现401 Unauthorized或authentication_error，基本是 Key 的问题。检查三件事：Key 有没有复制完整（前后别带空格）、环境变量名是不是ANTHROPIC_API_KEY、当前 PowerShell 窗口是不是在设置之后新开的。用setx设的变量，旧窗口读不到，必须新开。临时用$env:设的，关窗口就没了，下次要重设。
第二类是local proxy failed或连接超时。这类通常和 Base URL 有关。确认你填的是https://taotoken.net/api，不要多加斜杠或路径。如果公司网络有额外限制，先换手机热点试一次，排除本地网络因素。注意不要用任何来路不明的网络工具，保持环境干净。
第三类是reading choices相关报错，比如解析响应时读不到choices字段。这多半是端点或模型名不匹配。检查 Model ID 是否写对，参考接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里的模型列表。模型名写错时，服务端返回的结构和预期不一致，就会在解析阶段报错。
第四类是 OAuth 或登录循环。Claude Code 某些版本会引导你走登录流程，如果你已经用环境变量配了 Key，就不需要再走 OAuth。遇到反复让你登录，先确认环境变量生效：在 PowerShell 里执行echo $env:ANTHROPIC_API_KEY，能打印出 Key 就说明读到了。读不到就回到第 3 节重设。
还有一类是npm install -g报权限错误，比如EACCES或EPERM。这通常是 PowerShell 执行策略没改，回到第 3 节执行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。如果还不行，用管理员身份开一次 PowerShell 再装。
排查顺序建议：先claude --version确认命令在，再echo $env:ANTHROPIC_BASE_URL和echo $env:ANTHROPIC_API_KEY确认变量在，最后claude -p "test"确认请求通。三步定位，比盲目重装快得多。
6. 装完之后怎么继续用：从验证到日常编码的下一步
安装跑通只是起点。接下来你大概率会想把 Claude Code 用进日常项目，这里给几个实用方向。如果你主要做长期编码或者想让 Agent 帮你处理多步任务，可以看看 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite，它更适合持续使用的场景。只是想快速验证某个模型的表现，模型对话页面 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 更轻量。
日常使用中，我建议把常用项目的目录固定下来，每次cd进去再启动claude，这样它能读到正确的上下文。另外，环境变量建议用setx写成永久的，省得每次开窗口重设。Key 要保管好，不要提交到 git 仓库里，也不要在截图里暴露。
如果你后面要接其他工具，比如 Cline MCP 或 Codex 的auth.json，记住三件套始终是 Base URL、Key、Model ID，缺一不可。Base URL 统一用https://taotoken.net/api，Key 在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 管理，Model ID 以文档为准。接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里有各工具的配置示例，遇到不确定的字段直接对照。
最后提醒一句：装环境这件事，慢就是快。每一步验证过再往下走，比一口气装完再回头找错要省时间。你现在应该已经能跑通一次对话了，接下来就是把它用起来。
