1. Windows 上装 Claude Code CLI 到底卡在哪PowerShell 环境依赖与报错场景Claude Code CLI 是 Anthropic 官方推出的终端编程助手能在命令行里直接读项目、改代码、跑测试适合习惯用 PowerShell 或终端工作流的开发者。它本身是一个 npm 全局包理论上一条npm install -g就能装完但 Windows 上的实际体验往往没这么顺——我第一次在 Windows 11 上装的时候就先后撞上了 Node.js 版本过低、Git Bash 路径找不到、环境变量没生效三个坑前后折腾了快一个小时。问题的根源在于 Claude Code CLI 并不是纯 Node 程序。它在运行时会调用一个 shell 来执行命令在 macOS/Linux 上默认用系统自带的 bash而在 Windows 上它需要找到一个可用的 Git Bash。如果你只装了 Node.js 没装 Git或者 Git 装了但没把bash.exe的路径暴露给 CLI启动时就会直接报No suitable shell found连主界面都进不去。这个报错在搜索引擎里出现频率很高但很多教程只写「装 Git」三个字没讲清楚路径该怎么配。另一个高频卡点是环境变量。Claude Code CLI 需要知道两件事请求发到哪个 API 地址Base URL以及用什么凭证API Key / Auth Token。Windows 的环境变量分「用户变量」和「系统变量」还分「当前会话」和「持久化」改完之后不重启终端就不生效这是新手最容易忽略的地方。我见过不少人配完变量直接在当前窗口敲claude结果还是提示未授权以为配置写错了其实只是没重开 PowerShell。这篇教程面向的是从零开始的 Windows 用户假设你机器上还没装任何相关工具。我会按「依赖检查 → 安装 Node.js 和 Git → 装 CLI → 配环境变量 → 验证请求」的顺序走一遍每一步都给可复制的 PowerShell 命令和预期输出。API 通道部分用 TaoToken 的统一 Key 接入这样你不需要单独去申请 Anthropic 官方账号一个 Key 就能把 Base URL 和凭证都配好。系统要求方面Windows 10 版本 1809build 17763及以上都可以Windows 11 全系没问题。需要提前说明的是Claude Code CLI 的安装包来自 npm 官方源网络能正常访问 npm 即可不需要任何额外网络工具。如果你所在的环境访问 npm 慢可以换国内镜像源这个后面会讲。整篇教程的核心检索词就是 Windows、Claude Code CLI、PowerShell、Node.js、Git 这几个跟着做基本能一次跑通。2. 装 CLI 之前先把 TaoToken 的 Key 和通道准备好在动手装 Claude Code CLI 之前建议先把 API 通道的事情理清楚否则装完 CLI 还要回头补配置容易乱。TaoToken 在这里扮演的角色是一个统一的 API 接入层你从它那里拿到一个 Key然后把 Claude Code CLI 的 Base URL 指向 TaoToken 的接口地址CLI 发出的请求就会经过这个通道转发到模型侧。对使用者来说好处是不用分别管理多个平台的凭证一个 Key 覆盖对话、编码等场景。具体操作上先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号登录后进入控制台。控制台里能找到 API Keys 管理页面路径是 https://taotoken.net/console/api-keys 在这里创建一个新的 Key。创建时建议给它起个能认出来的名字比如claude-code-win方便以后区分不同用途的凭证。Key 生成后只显示一次复制下来先存到记事本里后面配环境变量要用。拿到 Key 之后你需要记住两个地址。一个是 Base URLClaude Code CLI 要填的接口根地址是https://taotoken.net/api注意这个地址后面不加任何 UTM 参数就是干净的 API 端点。另一个是文档地址 https://taotoken.net/doc 里面有各客户端的接入说明遇到不确定的字段可以回去查。如果你还想先在网页上试试模型对话效果可以打开 https://taotoken.net/models 直接聊两句确认 Key 是通的再去配 CLI这样能把「Key 本身有问题」和「CLI 配置有问题」两类故障分开。关于凭证字段Claude Code CLI 认两个环境变量ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN。在 TaoToken 的接入方式里这两个都填你刚创建的那个 Key 就行不用纠结区别。Base URL 则填ANTHROPIC_BASE_URLhttps://taotoken.net/api。这三个变量是后面配置的核心先记下来。如果你后续打算长期用 Claude Code 做项目开发或者想跑 Agent 类的自动化任务可以了解一下 Coding Plan 方案地址是 https://taotoken.net/coding-plan 它在用量和场景上更适合高频编码。不过对于这篇教程的验证目标来说先用按量 Key 跑通流程就够了不必一上来就上套餐。准备工作到这里就结束了接下来进入实际的安装环节。3. 可复制的 PowerShell 配置Node.js、Git 与 settings 片段这一节是整篇教程的操作核心所有命令都在 Windows PowerShell 里执行。先确认你打开的是 PowerShell 而不是 CMD——按 Win 键搜索「PowerShell」选蓝色图标那个普通权限即可不需要管理员除非你后面要改系统级环境变量。第一步是检查依赖把下面两行贴进去回车node -v npm -v如果两条都输出版本号比如v20.11.1和10.2.4说明 Node.js 已经装好可以跳到 Git 检查。如果提示「无法将 node 识别为 cmdlet」说明没装 Node.js。去 https://nodejs.org/zh-cn/download 下载 LTS 版本安装时一路下一步不要改路径。装完必须关掉当前 PowerShell 重新开一个否则 PATH 不刷新还是找不到命令。Node.js 版本建议 18 以上Claude Code CLI 对低版本支持不好。Git 的检查命令是git --version正常输出类似git version 2.43.0.windows.1。如果没装去 https://git-scm.com/downloads/win 下载安装同样一路下一步保持默认路径C:\Program Files\Git。这里有个关键点Claude Code CLI 需要的是 Git 自带的 bash路径通常是C:\Program Files\Git\bin\bash.exe。如果安装时改了路径后面环境变量里的CLAUDE_CODE_GIT_BASH_PATH就要跟着改。依赖齐了之后先卸载可能存在的旧版本再装官方包npm uninstall -g anthropic-ai/claude-code npm install -g anthropic-ai/claude-code第一条如果提示没装过忽略即可。第二条会从 npm 源拉包网络正常的话一两分钟完成。装完可以用claude --version看版本号但此时还没配环境变量直接跑claude会报未授权这是正常的。接下来配环境变量。推荐用 PowerShell 的setx命令写用户级变量这样持久生效不用手动点控制面板setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_API_KEY 你的Key setx ANTHROPIC_AUTH_TOKEN 你的Key setx CLAUDE_CODE_GIT_BASH_PATH C:\Program Files\Git\bin\bash.exe把你的Key替换成第 2 节创建的那串。setx写入的是用户变量对当前用户所有新开的终端生效。注意它不会影响已经打开的窗口所以四条执行完必须关掉 PowerShell 重开。如果你更习惯用配置文件的方式Claude Code CLI 也支持在项目或用户目录放 settings 文件。用户级配置在C:\Users\你的用户名\.claude\settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的Key, ANTHROPIC_AUTH_TOKEN: 你的Key, CLAUDE_CODE_GIT_BASH_PATH: C:\\Program Files\\Git\\bin\\bash.exe } }注意 JSON 里反斜杠要写成双反斜杠转义。这个文件的好处是配置跟着用户走换终端不用重设。两种方式选一种即可同时用的话环境变量优先级更高。配完重开 PowerShell进入验证环节。4. 验证请求claude --version 与一次真实对话确认通道生效配置写完重开一个 PowerShell 窗口先做最基础的版本检查claude --version预期输出是一行版本号比如1.0.xx (Claude Code)。如果这一步就报「无法识别」说明 npm 全局包的 bin 目录没进 PATH可以执行npm config get prefix看全局路径通常是C:\Users\你的用户名\AppData\Roaming\npm确认这个路径在系统 PATH 里。改完 PATH 同样要重开终端。版本能出来接着验证 API 通道。找一个空目录当测试项目执行cd $env:USERPROFILE\Desktop mkdir claude-test cd claude-test claude第一次启动会进入交互界面可能会问你是否信任当前目录选 yes。然后直接输入一句测试请求比如「用一句话说明这个目录里有什么」。如果通道配对了模型会返回内容如果 Base URL 或 Key 有问题这里会报错具体错误对照下一节。想更直接地验证通道可以用非交互模式跑一条命令claude -p 回复通道正常-p是 print 模式执行完直接输出结果并退出适合脚本化验证。正常返回类似「通道正常」的文本说明从 PowerShell 到 TaoToken 再到模型的整条链路是通的。这一步成功基本可以确认安装和配置都没问题。再补一个检查环境变量是否真的生效的动作echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY第一条应该输出https://taotoken.net/api第二条输出你的 Key会明文显示注意别截图外发。如果输出为空说明变量没写进去或者当前窗口是旧的重开终端再试。确认无误后你就可以在任何项目目录里cd进去然后敲claude开始用了。实测下来从零到跑通大概 15 分钟主要时间花在下载 Node.js 和 Git 安装包上。5. 本篇常见报错排查401、No suitable shell found 与 reading choices装 Claude Code CLI 的过程中报错基本集中在几个固定位置这一节按真实错误信息对照排查。报错一No suitable shell found。这是 Windows 上最高频的问题出现在启动claude时。原因是 CLI 找不到 Git Bash。解决方法是确认 Git 装在了默认路径然后设置CLAUDE_CODE_GIT_BASH_PATH环境变量指向C:\Program Files\Git\bin\bash.exe。如果你装 Git 时改了路径去那个路径下找bin\bash.exe把实际路径填进去。设完重开 PowerShell。如果还不行重装 Git 并保持默认路径再重开终端。报错二401 Unauthorized或invalid api key。这说明请求发出去了但凭证不对。先检查ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN是否都填了值是不是第 2 节创建的那个 Key有没有多复制空格或换行。然后确认ANTHROPIC_BASE_URL是https://taotoken.net/api末尾不要多加斜杠或路径。改完变量必须重开终端。如果还报 401去控制台 https://taotoken.net/console/api-keys 确认 Key 没被删除或禁用。报错三local proxy failed或连接超时。这类错误通常是网络层的问题请求没到达接口。先确认本机网络能正常访问外网然后检查有没有其他程序占用了代理设置。Claude Code CLI 会读取系统代理如果之前配过代理但代理已失效就会连不上。可以在 PowerShell 里临时清掉代理变量再试$env:HTTP_PROXY $env:HTTPS_PROXY claude -p 测试报错四reading choices相关解析错误。这个一般出现在模型返回内容格式异常时可能是 Base URL 指向了不兼容的端点。确认你填的是https://taotoken.net/api而不是某个具体的对话路径。如果问题持续用claude -p hi做最小化测试排除是项目上下文导致的。报错五OAuth相关提示。Claude Code CLI 某些版本会尝试走 OAuth 登录流程如果你用的是 Key 接入不需要走这个。确保环境变量里 Key 已设置CLI 会优先用 Key 而不是 OAuth。如果它仍然弹登录检查是不是装了多个版本用npm list -g anthropic-ai/claude-code确认全局只有一个。排查的通用思路是先看报错关键词401 类查凭证shell 类查 Git 路径超时类查网络解析类查 Base URL。每次改完环境变量都重开终端这一步别省。6. 装完之后怎么用把 Claude Code 接进日常编码流跑通验证之后Claude Code CLI 的日常用法就是进项目目录敲claude。它会以当前目录为工作区能读文件、改代码、执行命令。第一次在某个项目里用建议先让它「读一下项目结构说明这是个什么项目」确认它理解对了再让它动手改代码。对于长期编码场景可以了解 Coding Plan地址 https://taotoken.net/coding-plan 在用量和并发上更适合天天用的开发者。如果你同时用多个 AI 编码工具TaoToken 的统一 Key 优势就体现出来了同一个 Key 配到不同客户端不用分别管理。接入文档在 https://taotoken.net/doc 里面有各工具的配置示例。想先在网页上对比模型效果用 https://taotoken.net/models 直接对话即可。最后提醒两个实操细节。一是 PowerShell 的执行策略如果运行 npm 脚本时报「禁止运行脚本」用Set-ExecutionPolicy -Scope CurrentUser RemoteSigned放开当前用户别用管理员全局放开。二是 Key 的安全环境变量里的 Key 对本机所有进程可见不要把配好 Key 的终端截图发出去也不要把 Key 写进会提交到 Git 的配置文件里。settings.json 如果放在项目目录记得加进.gitignore。按这套流程走完Windows 上的 Claude Code CLI 就能稳定用了。