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，需要 Git（Claude 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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。
第一步，注册并登录。打开官网，完成账号注册，进入控制台。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，登录后你能看到自己的账户概览和用量。
第二步，创建 API Key。在控制台里找到 API Keys 页面，地址是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，点创建，复制生成的 Key。这个 Key 通常以sk-开头，只显示一次，复制后先存到记事本里，后面配置要用。注意别把它提交到 Git 仓库，也别贴在公开聊天里。
第三步，确认你要用的模型 ID。Claude Code 默认走的是 Anthropic 的模型，在 TaoToken 里你需要知道对应的模型标识。可以在模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 里先试一下对话，确认模型可用，再回到 Claude Code 配置。如果你打算长期用 Claude Code 做编码和 Agent 任务，可以看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，了解套餐和额度。
到这里你手上有三样东西：Base URL（https://taotoken.net/api）、API Key（sk-开头那串）、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，推荐用 nvm：
curl -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或者用 npm：
npm 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 里则写进~/.bashrc：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-你的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 Code：
cd C:\Users\你的用户名\projects\my-project claude第一次启动会问你是否认证，如果你已经用环境变量配了 API Key，它会直接走 Key 这条路。敲/status确认状态，看 Auth 那一行是不是走的 API Key，Model 是不是你配的模型。
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 里验证更简单，直接用 curl：
curl -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_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 确认这个 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_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 先确认这个模型能正常对话，再回 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\bin，npm 装到C:\Users\你的用户名\AppData\Roaming\npm。按 Win+R 输入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_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 对照最新的配置说明，或者用模型对话页面先确认 Key 本身可用。
6. 装完之后：把 TaoToken 接入长期用起来
装好、验证通、排查完，接下来就是把它用起来。这一节说几个实际使用中的配置建议，帮你少走弯路。
第一，把三件套固定下来。Base URL、API Key、Model ID 这三样，建议写进~/.claude/settings.json而不是只靠环境变量。环境变量在换终端、换 shell 的时候容易丢，配置文件更稳。Windows 上路径是C:\Users\你的用户名\.claude\settings.json，WSL2 里是~/.claude/settings.json。写进去之后，无论从哪个终端启动 Claude Code，配置都在。
第二，如果你同时用多个 AI 编码工具，比如 Claude Code 和别的 CLI，TaoToken 的统一 Key 能让你只维护一份凭证。不用每个工具配一套 Key，换模型的时候也只需要改 Model ID。这对需要对比不同模型效果的人特别省事。想了解套餐和额度，可以看 Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。
第三，养成敲/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_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 查最新的说明，或者在模型对话页面先确认 Key 和模型本身可用，把问题范围缩小到 Claude Code 这一层再排查。装好之后，Claude Code 配合 TaoToken 的统一接入，日常编码、读项目、改代码这些事就能顺起来了。
