1. Windows 装 Claude Code 到底卡在哪从 PowerShell 报错说起如果你在 Windows 上搜「Claude Code 安装」大概率会看到两种声音一种说一条命令就装好了另一种说折腾一下午全是报错。这两种都是真的区别只在于你有没有提前把环境理顺。Claude Code 是一个跑在终端里的 AI 编码助手能读你的项目、改代码、跑命令适合已经会用命令行、或者愿意花十分钟学命令行的 Windows 10/11 用户。它本身是 Linux-first 的工具在 Windows 上要么借 PowerShell 跑要么借 WSL2 跑路径不同踩的坑也不同。我自己第一次装的时候卡在irm : 无法加载文件……因为在此系统上禁止运行脚本这个报错上当时以为是网络问题折腾了半天才发现是 PowerShell 执行策略在拦。后来帮同事装又遇到claude : 无法识别和Requires Either Git for Windows两个经典问题。这些坑的共同点是它们跟 Claude Code 本身没关系全是 Windows 环境配置的锅。这篇教程的目标很明确带你在 Windows 上把 Claude Code 装好并且把 API 端点统一指向 TaoToken用一条最小请求验证连通性。我会覆盖 PowerShell 和 WSL2 两条路径给出可直接复制的命令和环境变量配置片段。装完之后你的 Claude Code 请求会走 TaoToken 的统一 Key而不是默认的官方端点——这对需要统一管理多个模型 Key 的人来说省事很多。先说清楚前置条件。你需要 Windows 10 版本 1809 以上或 Windows 11需要 GitClaude Code 在 Windows 上依赖 Git Bash 执行 shell 命令如果用 npm 方式装还需要 Node.js 18 以上。这三样检查一遍后面会顺很多。打开 PowerShell开始菜单搜「PowerShell」点第一个依次敲[System.Environment]::OSVersion.Version git --version node --version第一条预期看到 Major 是 10 或以上第二条预期git version 2.30.0或更高没有就去 git-scm.com 下载安装一路 Next 即可第三条预期v18.0.0以上推荐 v22.x没有就去 nodejs.org 下 LTS 版。如果你打算用官方原生安装器Node.js 其实可以不装这是我最推荐的方式。环境检查完接下来就是安装。安装方式有好几种但真正值得你花时间的就两条路PowerShell 原生安装器最省事和 WSL2体验最好。下面先讲怎么把 TaoToken 的接入准备好再讲两条安装路径的具体命令。2. TaoToken 前置准备拿到统一 Key 和 Base URL在装 Claude Code 之前先把 TaoToken 这边的接入信息准备好这样装完就能直接配不用来回切窗口。TaoToken 做的事情是把模型调用统一到一个入口你拿一个 Key、一个 Base URL就能在 Claude Code 里用。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。第一步注册并登录。打开官网完成账号注册进入控制台。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后你能看到自己的账户概览和用量。第二步创建 API Key。在控制台里找到 API Keys 页面地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 点创建复制生成的 Key。这个 Key 通常以sk-开头只显示一次复制后先存到记事本里后面配置要用。注意别把它提交到 Git 仓库也别贴在公开聊天里。第三步确认你要用的模型 ID。Claude Code 默认走的是 Anthropic 的模型在 TaoToken 里你需要知道对应的模型标识。可以在模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 里先试一下对话确认模型可用再回到 Claude Code 配置。如果你打算长期用 Claude Code 做编码和 Agent 任务可以看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 了解套餐和额度。到这里你手上有三样东西Base URLhttps://taotoken.net/api、API Keysk-开头那串、Model ID比如某个 Claude 模型标识。这三件套是后面所有配置的核心缺一不可。很多人配完发现请求失败回头一查就是 Model ID 写错了或者 Base URL 多加了斜杠。关于 Base URL 有个细节要提醒Claude Code 走的是 Anthropic 兼容协议环境变量名是ANTHROPIC_BASE_URL值填https://taotoken.net/api不要在后面加/v1或者别的路径除非文档明确要求。我见过有人填成https://taotoken.net/api/v1结果一直 404排查半天。准备好这三样接下来分两条路装 Claude Code。如果你只想快点跑起来直接看 PowerShell 原生安装器那节如果你追求更顺的体验、愿意多花十分钟看 WSL2 那节。两条路最后都会汇到同一套环境变量配置上。3. 可复制配置PowerShell 与 WSL2 两条安装路径这一节是全文的核心给你可以直接复制的命令和配置片段。先讲 PowerShell 原生安装器再讲 WSL2最后给出统一的环境变量配置。3.1 PowerShell 原生安装器最省事打开 PowerShell注意不是 CMD。先放宽当前用户的脚本执行策略否则安装脚本会被拦Set-ExecutionPolicy RemoteSigned -Scope CurrentUser系统会问你是否更改执行策略输入 Y 回车。这一步只影响当前用户是安全的做法不要用 Unrestricted也别改系统级策略。然后跑安装命令irm https://claude.ai/install.ps1 | iex你会看到进度条跑几秒然后提示安装完成。装完后关掉当前 PowerShell 窗口重新开一个新的验证claude --version预期显示类似Claude Code v2.x.x的版本号。如果提示claude : 无法识别说明安装目录没进 PATH跳到第 5 节排查。3.2 WSL2 路径体验最好如果你愿意多花十分钟WSL2 是 Windows 上跑 Claude Code 的最佳方式因为它是 Linux 原生环境文件搜索快、权限问题少。以管理员身份打开 PowerShell执行wsl --install这会装 WSL2 加 Ubuntu装完重启电脑。重启后打开 Ubuntu开始菜单搜「Ubuntu」首次进入会让你创建用户名和密码。然后装 Node.js推荐用 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node --version预期v22.x.x。接着装 Claude Code用原生安装器curl -fsSL https://claude.ai/install.sh | bash或者用 npmnpm install -g anthropic-ai/claude-code有个重要提醒项目不要放在/mnt/c/下面也就是别放在 Windows 的 C 盘里通过 WSL 访问跨文件系统读取很慢还会导致文件搜索漏文件。把项目放在/home/你的用户名/projects/这类 Linux 文件系统路径下。3.3 统一环境变量配置两条路都适用装完之后把 API 端点指向 TaoToken。PowerShell 里这样设置用户级环境变量[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, sk-你的TaoToken密钥, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, 你的模型ID, [EnvironmentVariableTarget]::User)设置完关掉终端重新打开验证echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY echo $env:ANTHROPIC_MODELWSL2 里则写进~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_MODEL你的模型ID然后source ~/.bashrc生效。如果你更习惯用配置文件Claude Code 支持~/.claude/settings.json可以这样写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: 你的模型ID } }这个文件在 Windows 上的路径是C:\Users\你的用户名\.claude\settings.json在 WSL2 里是~/.claude/settings.json。三件套 Base URL、Key、Model ID 一个都不能少写错任何一个都会导致请求失败。配置完进入你的项目目录启动 Claude Codecd C:\Users\你的用户名\projects\my-project claude第一次启动会问你是否认证如果你已经用环境变量配了 API Key它会直接走 Key 这条路。敲/status确认状态看 Auth 那一行是不是走的 API KeyModel 是不是你配的模型。4. 验证请求一条最小请求确认连通性配置写完不代表通了得实际发一条请求验证。这一步很多人跳过结果用的时候才发现报错回头排查更费劲。验证分两层先确认 Claude Code 能启动并识别配置再发一条最小请求看返回。第一层启动后敲/status。你会看到类似这样的输出Account: (API Key) Auth: API Key Model: 你的模型ID Base URL: https://taotoken.net/api重点看 Auth 和 Base URL 两行。如果 Auth 显示的是订阅账号而不是 API Key说明你之前登录过订阅API Key 的优先级虽然更高但最好确认一下。Base URL 必须是你配的 TaoToken 地址如果显示的是默认官方地址说明环境变量没生效回去检查是不是没重开终端。第二层发一条最小请求。在 Claude Code 里直接输入一句简单的话比如帮我看看当前目录下有哪些文件预期它会调用工具列出文件并给出说明。如果这一步能正常返回说明从 Claude Code 到 TaoToken 的链路是通的。如果报错看第 5 节的排查对照。如果你想更直接地验证 API 端点可以用 curl 发一条最小请求。PowerShell 里这样写curl.exe -X POST https://taotoken.net/api/v1/messages -H x-api-key: sk-你的TaoToken密钥 -H anthropic-version: 2023-06-01 -H content-type: application/json -d {\model\:\你的模型ID\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\说一句你好\}]}注意 PowerShell 里 curl 是Invoke-WebRequest的别名所以要写curl.exe才能用真正的 curl。预期返回一段 JSON里面有content字段和模型回复的文本。如果返回 401是 Key 的问题返回 404是路径或模型 ID 的问题返回 400多半是请求体格式问题。WSL2 里验证更简单直接用 curlcurl -X POST https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:你的模型ID,max_tokens:64,messages:[{role:user,content:说一句你好}]}看到正常返回就说明连通性没问题了。这时候回到 Claude Code就可以正常干活了。建议装完第一件事是敲/init它会分析你的项目生成CLAUDE.md告诉 Claude Code 你的项目结构和技术栈后面所有操作都会更准。这个动作只要 30 秒但能省你后面很多来回解释的时间。5. 常见报错排查401、local proxy failed、reading choices这一节把 Windows 上装 Claude Code 配 TaoToken 最常见的几个报错列出来对照着排查。每个报错我都写清楚现象、原因和解决动作。报错一401 Unauthorized 或 invalid api key现象是请求返回 401或者 Claude Code 提示认证失败。原因通常是 API Key 写错、Key 已失效、或者环境变量没生效。排查顺序先echo $env:ANTHROPIC_API_KEY确认 Key 确实被读到了注意有没有多余空格或引号再去 TaoToken 控制台的 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 确认这个 Key 还在、没被删最后确认你复制的是完整的 Key没有截断。如果都正常还是 401换一个新 Key 试试。报错二local proxy failed 或 connection refused现象是 Claude Code 报连接失败或者提示本地代理错误。这个报错在 Windows 上常见于两种情况一是你之前配过系统代理环境变量里残留了HTTP_PROXY或HTTPS_PROXY指向一个已经关掉的本地端口二是防火墙拦了请求。排查echo $env:HTTPS_PROXY看看有没有值如果有但你没在用代理清掉它[Environment]::SetEnvironmentVariable(HTTPS_PROXY, $null, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(HTTP_PROXY, $null, [EnvironmentVariableTarget]::User)然后重开终端再试。如果确实是公司网络需要代理那就把代理地址配对别留一个失效的。报错三reading choices 或 unexpected response format现象是 Claude Code 报解析响应失败提示 reading choices 之类。这个报错通常意味着请求发出去了但返回的格式不是 Claude Code 预期的。原因多半是 Base URL 或 Model ID 配错导致请求打到了不兼容的端点。排查确认ANTHROPIC_BASE_URL是https://taotoken.net/api没有多余路径确认ANTHROPIC_MODEL是 TaoToken 支持的模型 ID不是随便写的字符串。可以去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 先确认这个模型能正常对话再回 Claude Code 配。报错四OAuth 相关报错或登录循环现象是启动时反复要求登录或者 OAuth 回调失败。如果你用的是 API Key 方式本来就不该走 OAuth。排查确认环境变量里ANTHROPIC_API_KEY有值且ANTHROPIC_BASE_URL指向 TaoToken。如果之前登录过订阅账号Claude Code 可能缓存了登录态可以删掉~/.claude下的认证缓存文件再试。API Key 的优先级高于订阅登录配了 Key 就会走 Key。报错五claude 命令找不到现象是claude : 无法识别。原因是安装目录没进 PATH。PowerShell 原生安装器一般装到C:\Users\你的用户名\.local\binnpm 装到C:\Users\你的用户名\AppData\Roaming\npm。按 WinR 输入sysdm.cpl高级、环境变量在用户变量的 Path 里新建一条填对应路径确定后关掉所有终端重开。PATH 不会自动更新到已打开的窗口这步必须做。报错六Requires Either Git for Windows现象是安装或启动时报找不到 Git Bash。Claude Code 在 Windows 上需要 Git Bash 执行 shell 命令。先git --version确认 Git 装了如果装了还报错在~/.claude/settings.json里手动指定路径{ env: { CLAUDE_CODE_GIT_BASH_PATH: C:\\Program Files\\Git\\bin\\bash.exe } }路径按你实际安装位置调整不确定就用where.exe git查Git Bash 在同级目录的bin\bash.exe。排查完这些基本能覆盖 Windows 上 90% 的安装问题。如果还是不通去接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 对照最新的配置说明或者用模型对话页面先确认 Key 本身可用。6. 装完之后把 TaoToken 接入长期用起来装好、验证通、排查完接下来就是把它用起来。这一节说几个实际使用中的配置建议帮你少走弯路。第一把三件套固定下来。Base URL、API Key、Model ID 这三样建议写进~/.claude/settings.json而不是只靠环境变量。环境变量在换终端、换 shell 的时候容易丢配置文件更稳。Windows 上路径是C:\Users\你的用户名\.claude\settings.jsonWSL2 里是~/.claude/settings.json。写进去之后无论从哪个终端启动 Claude Code配置都在。第二如果你同时用多个 AI 编码工具比如 Claude Code 和别的 CLITaoToken 的统一 Key 能让你只维护一份凭证。不用每个工具配一套 Key换模型的时候也只需要改 Model ID。这对需要对比不同模型效果的人特别省事。想了解套餐和额度可以看 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。第三养成敲/status的习惯。每次换项目、换终端、或者感觉响应不对的时候先敲一下/status确认 Auth 和 Base URL 是对的。很多「Claude Code 不好用」的抱怨其实是配置漂了请求根本没走对端点。第四项目放对位置。WSL2 用户尤其注意项目放 Linux 文件系统里别放/mnt/c/。PowerShell 用户则注意项目路径别带中文和空格虽然现在支持得不错但偶尔还是会有工具处理路径出问题。第五装完先/init。这个前面提过再强调一次因为它真的能省时间。CLAUDE.md生成后你可以手动补充一些项目约定比如代码风格、测试命令、目录结构说明Claude Code 后续会参考这些。最后说一个实际经验Windows 上装 Claude Code最耗时间的从来不是安装本身而是环境变量的生效和 PATH 的配置。装完发现命令找不到、Key 读不到八成是终端没重开。记住一个原则改完环境变量或 PATH关掉所有终端窗口重新开再验证。这个动作能解决大部分「明明配了却没用」的问题。如果你在配置过程中遇到本文没覆盖的报错可以去接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 查最新的说明或者在模型对话页面先确认 Key 和模型本身可用把问题范围缩小到 Claude Code 这一层再排查。装好之后Claude Code 配合 TaoToken 的统一接入日常编码、读项目、改代码这些事就能顺起来了。