1. Windows 上装 Claude Code为什么我最后选了 winget PowerShellClaude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯在 VS Code 里写代码、又想让 AI 帮忙处理多文件任务的开发者。它原生是 Node.js 生态的工具Windows 上过去要么手动装 Node 再 npm 全局安装要么在 WSL 里折腾对刚上手的人不太友好。现在官方在 winget 上架了包配合 PowerShell 做环境变量初始化整个流程能压到十分钟以内。我这台机器是 Windows 11之前一直用网页版对话但项目一多就发现复制粘贴太累尤其是要改十几个文件的时候。于是决定把 Claude Code 装到本地并且用 TaoToken 作为统一的 Key/API 通道这样模型切换、额度管理都在一个地方不用每个工具单独配一遍。下面把完整过程记下来包括 winget 安装、PowerShell 初始化、VS Code 接入、以及一条验证是否生效的测试动作。如果你也是 Windows 环境、想从零把 Claude Code 跑起来可以照着走一遍。2. 前置准备TaoToken 账号与 Key 的获取在动手装 Claude Code 之前先把 API 通道准备好否则装完没法验证。TaoToken 是一个统一的大模型 API 接入平台Claude Code、Coding Plan、模型对话这些场景都能走同一个 Key省得每个工具单独申请。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进控制台。具体拿 Key 的路径登录后打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面新建一个 Key复制出来先存到记事本。这个 Key 就是后面 PowerShell 里要填的ANTHROPIC_AUTH_TOKEN。如果你打算长期用 Claude Code 写代码、跑 Agent 任务可以顺便看一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对编码场景做了额度规划比按量零散调用更省心。注意Key 只在创建时完整显示一次关掉页面就看不到了务必先复制保存。不要把它写进会提交到 Git 的文件里。TaoToken 的 API 基地址是 https://taotoken.net/api 这个地址后面会作为ANTHROPIC_BASE_URL的值。注意这里不加任何查询参数保持干净。模型名则根据你在平台上开通的模型来填比如claude-sonnet-4-5这类。准备工作就这两样一个 Key一个基地址。3. 用 winget 安装 Claude Code 并初始化 PowerShell 环境3.1 winget 安装与版本确认打开 PowerShell不需要管理员权限普通窗口就行。先确认 winget 可用winget --version如果提示找不到命令说明系统里的应用安装程序版本太旧去 Microsoft Store 更新「应用安装程序」即可。确认可用后执行安装winget install --id Anthropic.ClaudeCode --source winget安装过程会自动拉取包并配置好可执行文件路径。装完后关掉当前 PowerShell 窗口重新开一个让 PATH 生效。然后验证claude --version能打印出版本号就说明二进制装好了。这一步踩过的坑是不重开窗口直接敲claude会提示不是内部或外部命令因为环境变量还没刷新重开就好。3.2 用 PowerShell 配置环境变量Claude Code 读取的是 Anthropic 风格的环境变量。临时配置只对当前窗口有效这样写$key sk-你的TaoToken密钥 $env:ANTHROPIC_AUTH_TOKEN $key $env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_MODEL claude-sonnet-4-5三行分别对应鉴权、请求地址、默认模型。配完直接敲claude就能进交互界面。但临时变量关掉窗口就没了每次都要重配很烦所以要做永久保存写到用户级环境变量里[System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, $key, User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, claude-sonnet-4-5, User)User表示只对当前用户生效不需要管理员权限也不会污染系统级变量。写完之后同样要重开 PowerShell 才能读到。这里有个细节$key变量在同一个窗口里还有值所以能直接引用如果你分两次操作第二次要把 Key 字符串重新赋给$key。3.3 模型角色映射Claude Code 内部会把不同任务分给不同「角色」比如快速补全走 Haiku、复杂推理走主模型。你可以用下面两个变量把角色映射到 TaoToken 上对应的模型$env:ANTHROPIC_DEFAULT_HAIKU_MODEL claude-haiku-4-5 $env:ANTHROPIC_MODEL claude-sonnet-4-5同样可以写成永久变量[System.Environment]::SetEnvironmentVariable(ANTHROPIC_DEFAULT_HAIKU_MODEL, claude-haiku-4-5, User)这样轻量任务走便宜快的模型重任务走能力强的模型额度和速度都更合理。具体模型名以 TaoToken 控制台里开通的为准别照抄。4. 在 VS Code 里接入并写好 settings.json4.1 安装扩展与打开集成终端VS Code 里用 Claude Code 有两种方式一是直接用内置终端跑claude二是装对应的扩展获得更好的集成体验。最省事的是第一种因为环境变量已经配好了VS Code 的集成终端会继承用户级变量。打开 VS Code按Ctrl调出终端敲claude就能用。如果你想要侧边栏面板、快捷键触发这类体验可以在扩展市场搜索 Claude Code 相关扩展安装。装完后在设置里指定可执行文件路径一般自动识别识别不到就手动填claude的完整路径用where.exe claude可以查到。4.2 settings.json 配置骨架VS Code 的用户设置文件可以用命令面板打开CtrlShiftP输入Open User Settings (JSON)。下面是一个配置骨架把终端环境和 Claude Code 相关项放进去{ terminal.integrated.env.windows: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-5, ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-haiku-4-5 }, terminal.integrated.defaultProfile.windows: PowerShell, files.autoSave: afterDelay }这里我把ANTHROPIC_AUTH_TOKEN故意没写进 settings.json因为它会随设置同步、也可能被截图分享出去放在用户级环境变量里更安全。terminal.integrated.env.windows里的变量会在 VS Code 终端启动时注入和系统环境变量叠加优先级更高方便你针对项目临时换模型。注意settings.json 是标准 JSON不能有注释、不能有多余逗号改完保存如果 VS Code 报红先检查格式。4.3 项目级配置如果某个项目想用不同模型可以在项目根目录建.vscode/settings.json只写差异项{ terminal.integrated.env.windows: { ANTHROPIC_MODEL: claude-opus-4-1 } }这样打开这个项目时终端会用 Opus其他项目还是走全局的 Sonnet。团队协作时把项目级配置提交到仓库大家模型行为一致但 Key 依然各自本地管理不会泄露。5. 验证请求一条测试动作确认安装生效配置写完别急着写业务代码先用一条最小请求确认链路通。重开一个 PowerShell 或 VS Code 终端执行claude -p 11等于几只回答数字-p是 print 模式跑完直接输出结果不进入交互界面适合脚本化验证。如果返回2说明 Key、基地址、模型三者都对请求成功打到了 TaoToken 再转发到模型。如果卡住或报错看下一节的排查。想更直观地确认模型身份可以问一个带自述的问题claude -p 用一句话说明你是什么模型返回内容里通常会带模型标识。另外在交互模式里敲/status也能看到当前会话用的模型和配置来源。我实测下来从敲命令到出结果大概两三秒延迟正常。如果你还想在网页端对照验证同一个 Key 是否可用可以打开模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 用同一个 Key 发一条消息两边都能通就说明 Key 本身没问题问题只可能在本地配置。6. 本篇常见错误排查报错claude : 无法将“claude”项识别为 cmdletPATH 没刷新。关掉所有 PowerShell 和 VS Code 窗口重开。还不行就用where.exe claude看路径在不在不在的话重新跑一遍 winget 安装。报错 401 或authentication_errorANTHROPIC_AUTH_TOKEN没读到或值不对。在 PowerShell 里执行$env:ANTHROPIC_AUTH_TOKEN看有没有输出。为空说明永久变量没写成功或者当前窗口是写之前开的。检查 Key 有没有多余空格、有没有复制漏字符。报错 404 或连接超时ANTHROPIC_BASE_URL写错了。正确值是https://taotoken.net/api不要多加/v1之类的后缀也不要在末尾加斜杠。用$env:ANTHROPIC_BASE_URL确认实际值。报错模型不存在model_not_foundANTHROPIC_MODEL填的模型名在 TaoToken 上没有开通。去控制台看可用模型列表把名字改成完全一致的。模型名大小写、连字符都要对上。VS Code 终端里能用外部 PowerShell 不能用说明变量只写进了 VS Code 的 settings.json没写用户级环境变量。按 3.2 节用SetEnvironmentVariable补一遍。改了环境变量但没生效用户级环境变量在进程启动时读取已经开着的窗口不会自动更新。一律重开窗口。VS Code 还要注意有时候要完全退出再启动而不只是关掉终端面板。Key 泄露风险如果 Key 不小心提交到了 Git立刻去控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 吊销重建。平时用.gitignore排除.env和本地 settings 文件。排查顺序建议固定成先claude --version确认装没装再$env:ANTHROPIC_BASE_URL确认地址再$env:ANTHROPIC_AUTH_TOKEN确认鉴权最后claude -p发请求。一层层往下基本五分钟内能定位。7. 后续怎么用接入文档与长期编码方案装好只是起点。日常用 Claude Code 处理多文件重构、写测试、读日志建议把接入文档过一遍里面有针对不同场景的参数说明和最佳实践接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。里面会讲清楚流式输出、超时设置、并发限制这些细节配好了体验差别很大。如果你像我一样每天都要用 Claude Code 跑 Agent 任务、批量改代码按量计费容易心里没底可以看看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它把编码场景的额度打包适合长期高频使用。Key 管理统一在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以给不同项目建不同 Key方便单独吊销和统计用量。最后留一个我自己的习惯把常用的模型切换写成 PowerShell 函数放进$PROFILE比如function cc-fast { $env:ANTHROPIC_MODELclaude-haiku-4-5; claude }需要快速补全时敲cc-fast重任务敲cc。这样不用每次改环境变量切换成本几乎为零。