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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建密钥在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 可以生成和管理你的 Key。生成后先复制存好后面配置环境变量要用。这里有个细节要注意Claude Code 读取的是环境变量不是配置文件里的明文。所以你要做的是把 Key 和 Base URL 写进环境变量而不是改某个 JSON。Windows 上设置环境变量有两种方式一种是临时在当前 PowerShell 会话里设关掉窗口就失效另一种是写进系统环境变量永久生效。我建议先用临时方式验证跑通了再写永久这样出错了好回退。另外如果你后面要用到 Coding Plan 这类长期编码或 Agent 场景可以在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 了解套餐只是想先验证模型能不能通用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 也能快速试。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite遇到参数不确定就翻文档。把这两样准备好我们再进安装环节。3. 可复制配置git、node.js、npm 全局安装与 PowerShell 权限设置这一节是全文的核心操作区每一步都给可复制的命令。先装 git。打开 https://git-scm.com/download/win 下载 Windows 版安装包双击后一路 Next 即可默认选项对绝大多数人够用。装完打开 PowerShellWinX 然后选 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.xnpm -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 Codenpm install -g anthropic-ai/claude-code等待下载完成出现added x packages之类提示即成功。验证claude --version能输出版本号就说明命令可用。接下来配置 API 通道。临时方式当前窗口有效$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的Key如果你希望永久生效用setxsetx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_API_KEY 你的Key注意setx写入后要新开一个 PowerShell 窗口才生效。这里三件套要记全Base URL 是https://taotoken.net/apiKey 是你创建的密钥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 Codemkdir claude-test cd claude-test claude第一次启动可能会让你确认一些初始化选项按提示走。进入交互界面后输入一句简单的话比如「用一句话解释什么是递归」。如果通道配置正确你会看到模型返回内容这就说明请求真的发出去了而且走的是 TaoToken 的端点。如果不想进交互界面也可以用一次性命令验证claude -p 用一句话解释什么是递归-p是 prompt 模式直接输出结果不进入对话。实测下来这条命令能最快判断通道是否通。返回正常文本说明 Base URL、Key、Model ID 三件套都对上了。再进一步验证它能不能读文件。在claude-test目录里建一个hello.pydef 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_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里的模型列表。模型名写错时服务端返回的结构和预期不一致就会在解析阶段报错。第四类是 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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite它更适合持续使用的场景。只是想快速验证某个模型的表现模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 更轻量。日常使用中我建议把常用项目的目录固定下来每次cd进去再启动claude这样它能读到正确的上下文。另外环境变量建议用setx写成永久的省得每次开窗口重设。Key 要保管好不要提交到 git 仓库里也不要在截图里暴露。如果你后面要接其他工具比如 Cline MCP 或 Codex 的auth.json记住三件套始终是 Base URL、Key、Model ID缺一不可。Base URL 统一用https://taotoken.net/apiKey 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 管理Model ID 以文档为准。接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有各工具的配置示例遇到不确定的字段直接对照。最后提醒一句装环境这件事慢就是快。每一步验证过再往下走比一口气装完再回头找错要省时间。你现在应该已经能跑通一次对话了接下来就是把它用起来。
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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建密钥在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 可以生成和管理你的 Key。生成后先复制存好后面配置环境变量要用。这里有个细节要注意Claude Code 读取的是环境变量不是配置文件里的明文。所以你要做的是把 Key 和 Base URL 写进环境变量而不是改某个 JSON。Windows 上设置环境变量有两种方式一种是临时在当前 PowerShell 会话里设关掉窗口就失效另一种是写进系统环境变量永久生效。我建议先用临时方式验证跑通了再写永久这样出错了好回退。另外如果你后面要用到 Coding Plan 这类长期编码或 Agent 场景可以在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 了解套餐只是想先验证模型能不能通用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 也能快速试。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite遇到参数不确定就翻文档。把这两样准备好我们再进安装环节。3. 可复制配置git、node.js、npm 全局安装与 PowerShell 权限设置这一节是全文的核心操作区每一步都给可复制的命令。先装 git。打开 https://git-scm.com/download/win 下载 Windows 版安装包双击后一路 Next 即可默认选项对绝大多数人够用。装完打开 PowerShellWinX 然后选 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.xnpm -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 Codenpm install -g anthropic-ai/claude-code等待下载完成出现added x packages之类提示即成功。验证claude --version能输出版本号就说明命令可用。接下来配置 API 通道。临时方式当前窗口有效$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的Key如果你希望永久生效用setxsetx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_API_KEY 你的Key注意setx写入后要新开一个 PowerShell 窗口才生效。这里三件套要记全Base URL 是https://taotoken.net/apiKey 是你创建的密钥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 Codemkdir claude-test cd claude-test claude第一次启动可能会让你确认一些初始化选项按提示走。进入交互界面后输入一句简单的话比如「用一句话解释什么是递归」。如果通道配置正确你会看到模型返回内容这就说明请求真的发出去了而且走的是 TaoToken 的端点。如果不想进交互界面也可以用一次性命令验证claude -p 用一句话解释什么是递归-p是 prompt 模式直接输出结果不进入对话。实测下来这条命令能最快判断通道是否通。返回正常文本说明 Base URL、Key、Model ID 三件套都对上了。再进一步验证它能不能读文件。在claude-test目录里建一个hello.pydef 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_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里的模型列表。模型名写错时服务端返回的结构和预期不一致就会在解析阶段报错。第四类是 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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite它更适合持续使用的场景。只是想快速验证某个模型的表现模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 更轻量。日常使用中我建议把常用项目的目录固定下来每次cd进去再启动claude这样它能读到正确的上下文。另外环境变量建议用setx写成永久的省得每次开窗口重设。Key 要保管好不要提交到 git 仓库里也不要在截图里暴露。如果你后面要接其他工具比如 Cline MCP 或 Codex 的auth.json记住三件套始终是 Base URL、Key、Model ID缺一不可。Base URL 统一用https://taotoken.net/apiKey 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 管理Model ID 以文档为准。接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有各工具的配置示例遇到不确定的字段直接对照。最后提醒一句装环境这件事慢就是快。每一步验证过再往下走比一口气装完再回头找错要省时间。你现在应该已经能跑通一次对话了接下来就是把它用起来。
