全网最全 Claude Code 安装教程（Windows版）：用 TaoToken 统一 Key 十五分钟跑通

1. Windows 上跑 Claude Code卡住你的到底是什么Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯用命令行干活的开发者。但它在 Windows 上的安装链路比在 macOS 和 Linux 上要绕一些Node 版本、npm 全局目录权限、PowerShell 执行策略、环境变量作用域任何一环出问题都会让你卡在claude命令敲下去没反应或者连上之后报地区不支持。我这次把整条链路拆开走一遍目标很明确在 Windows 上从零装好 Claude Code用 TaoToken 统一管理 API Key十五分钟内发起第一次对话。全程不需要额外的网络工具只需要 Node、npm、一个可用的 API Key以及一份写对的settings.json。先说清楚适合谁看如果你之前没碰过 Claude Code或者装到一半被环境变量和配置文件搞晕了这篇按步骤跟做就行。如果你已经在用但每次换 Key 都要手动改环境变量那第四节的 CC Switch 和settings.json骨架能帮你省事。核心检索词先摆出来Claude Code 安装、Windows、Node、npm、API Key 配置、settings.json、CC Switch。下面按顺序来。2. 装之前先把 Node、npm、Git 三件套确认好Claude Code 是通过 npm 全局安装的所以 Node 环境是硬前提。官方建议 Node 18 以上我实测 Node 20 LTS 最稳Node 22 也能跑。先打开 PowerShell 确认版本。按Win R输入powershell回车进入 Windows PowerShell 窗口。这里强调一下尽量用 PowerShell 而不是 CMD因为后面设置环境变量、执行脚本PowerShell 的权限模型更清晰不容易出现全局安装后命令找不到的情况。node --version npm --version git --version三条命令分别输出类似v20.11.1、10.2.4、git version 2.43.0就说明齐了。如果node或npm提示不是内部或外部命令去 Node.js 官网下载 LTS 安装包安装时勾选 “Add to PATH”装完重开一个 PowerShell 窗口再验证。Git 不是 Claude Code 运行的强制依赖但很多项目操作和后续拉代码会用到建议一并装上。Node 装好后npm 的全局目录有时会落在需要管理员权限的位置导致npm install -g报EACCES或EPERM。可以先看一眼全局路径npm config get prefix如果输出的是C:\Program Files\nodejs这类受保护目录建议改成用户目录下的路径避免每次全局安装都要管理员权限npm config set prefix $env:APPDATA\npm改完之后把%APPDATA%\npm加进系统 PATH重开窗口npm全局命令就能正常用了。这一步不做也能装但后面升级 Claude Code 时容易反复踩权限的坑。3. 安装 Claude Code 并确认版本号环境确认完直接全局安装。在 PowerShell 里执行npm install -g anthropic-ai/claude-code安装过程会拉取依赖网速正常的话一两分钟。装完执行版本检查claude --version能看到类似1.x.x的版本号说明可执行文件已经进了 PATH。如果提示claude不是内部或外部命令八成是 npm 全局 bin 目录没进 PATH回到上一节确认npm config get prefix的路径把对应目录加进环境变量重开窗口再试。这里有个小细节安装完成后不要急着敲claude进交互界面先把 API Key 和环境变量配好否则第一次启动会引导你去登录 Anthropic 官方账号而我们要走的是 TaoToken 统一 Key 的路线。4. 用 TaoToken 统一 Key配好环境变量和 settings.jsonTaoToken 在这里扮演的角色是统一入口你只需要一个 API Key就能让 Claude Code 指向统一的 API 地址不用在多个服务之间来回切换。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。先去控制台创建 Key。打开 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 并复制。这个 Key 就是 Claude Code 连接服务的通行证别泄露也别提交到 Git 仓库。Claude Code 通过两个环境变量决定连哪个服务ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。先做临时配置验证能不能通$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_API_KEY 你的Key临时变量只在当前窗口有效关掉就没了。要长期生效写进用户级环境变量[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, 你的Key, User)设置完关掉当前 PowerShell重新开一个窗口让新变量生效。除了环境变量Claude Code 还支持用settings.json做更细的配置。这个文件通常放在用户目录下的.claude文件夹里比如C:\Users\你的用户名\.claude\settings.json。如果目录不存在就手动建一个。一份可复制的最小骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的Key }, permissions: { allow: [], deny: [] } }env段里的变量会覆盖系统环境变量适合你想给不同项目配不同 Key 的场景。permissions段控制工具调用的放行和拒绝规则刚开始留空即可后面按需加。如果你经常在多个 Key 或不同服务之间切换可以了解下 CC Switch 这类切换工具它的思路是把多套配置存成 profile一键切换当前生效的settings.json。不过对大多数人来说先把上面这份骨架跑通比一上来就上切换工具更实在。5. 一条 curl 验证请求确认 Key 真的能用配置写完别急着进交互界面先用 curl 打一发请求确认 Key 和地址都对。PowerShell 里执行curl.exe -X POST https://taotoken.net/api/v1/messages -H x-api-key: 你的Key -H anthropic-version: 2023-06-01 -H content-type: application/json -d {\model\:\claude-3-5-sonnet-20241022\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\说一句你好\}]}注意 Windows PowerShell 里curl是Invoke-WebRequest的别名所以要写curl.exe才会调用真正的 curl。反引号是 PowerShell 的换行符别漏。返回结果里能看到content数组和一段文本就说明 Key 有效、地址可达。如果返回 401检查 Key 有没有复制全、有没有多余空格返回 404 或连接失败检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api末尾不要多加/v1。curl 通了之后回到 PowerShell 输入claude第一次启动会问几个初始化问题比如是否信任当前目录、选择主题按提示选 yes 即可。然后就能直接对话了。想验证模型响应也可以打开模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 对照测试。6. 本篇常见报错排查报错一claude命令找不到。全局 bin 目录没进 PATH。执行npm config get prefix拿到路径把该路径加进系统环境变量 Path重开窗口。报错二启动后提示当前地区不支持。这是 Claude Code 的引导检查在作怪。找到用户目录下的.claude.json文件比如C:\Users\你的用户名\.claude.json如果看不到在文件资源管理器里开启“显示隐藏文件”。用文本编辑器打开加入一行hasCompletedOnboarding: true保存后重新运行claude。新用户的这个文件内容很少直接找合适位置插入即可注意 JSON 语法前一行末尾要有逗号。报错三curl 返回 401。Key 错误或没带上。确认请求头用的是x-api-key值里没有引号和空格。如果 Key 是在环境变量里配的确认当前窗口已经重开过。报错四npm install -g报 EPERM。全局目录权限问题。按第二节把 prefix 改到%APPDATA%\npm或者用管理员身份开 PowerShell 装一次。报错五settings.json 改了没生效。检查文件路径是不是C:\Users\你的用户名\.claude\settings.jsonJSON 有没有语法错误多余逗号、缺引号。可以用在线 JSON 校验工具过一遍。排查完这些基本就能稳定跑起来了。如果你打算长期用 Claude Code 做编码和 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到接入问题先翻文档再动手改配置比盲目试错快得多。