1. Windows 上跑 Claude Code先搞清楚它到底在干什么Claude Code 是 Anthropic 推出的命令行编程助手你在终端里敲一句自然语言它就能读你当前项目的文件、改代码、跑命令。它不是一个带界面的 IDE 插件而是一个跑在命令行里的 Agent所以对 Windows 用户来说第一步不是研究功能而是把运行环境铺好。很多人卡住的地方其实不在 Claude Code 本身而在两件事一是 Windows 下 Node 和 Git 的环境没配干净npm install报一堆权限错二是装完之后发现它连不上模型因为默认走的是官方通道需要额外配置。这篇就按「先装好、再接通、最后验证」的顺序走一遍重点放在 TaoToken 统一 Key 的配置上让你装完就能真的对话而不是停在claude命令能启动但一发消息就报错的阶段。适合谁看第一次在 Windows 上接触 Claude Code 的人、之前装过但鉴权一直没通的人、以及想用一个统一 Key 管理多个模型通道的人。全程用 CMD 或 PowerShell 都能跟做不需要额外装一堆花哨工具。2. 装之前先把 Node 和 Git 这两块地基打好Claude Code 依赖 Node.js 运行同时它内部会调用 Git 来做版本相关的操作所以这两个必须先装。Windows 上推荐直接去 Node.js 官网下 LTS 版本安装时记得勾选「Add to PATH」这一步漏了后面npm命令会找不到。装完打开一个新的 CMD 窗口验证一下node -v npm -v git --version三条命令都能打印出版本号说明环境没问题。如果node -v报「不是内部或外部命令」八成是 PATH 没生效关掉窗口重开一次或者手动把 Node 安装目录加进系统环境变量。Git 这边去官网下 Windows 版一路默认下一步即可。装完后git --version能出版本就行。这里有个小坑如果你公司网络对 npm 源有限制可以先把源切到国内镜像避免安装时卡住npm config set registry https://registry.npmmirror.com这一步不是必须的但能省掉很多「装到一半不动了」的等待。3. 安装 Claude Code 本体一条命令的事环境好了之后安装 Claude Code 就一条全局安装命令在 CMD 里执行npm install -g anthropic-ai/claude-code-g表示全局安装装完之后任何目录下都能调用claude命令。安装过程会拉一些依赖耐心等它跑完。如果中途报EACCES或权限相关错误用管理员身份重开一个 CMD 再执行一次通常能解决。装完验证claude --version能打印出版本号说明本体装好了。这时候你直接敲claude也能启动但先别急着用——它默认没有接入任何可用的模型通道你发消息大概率会提示鉴权失败或者连接不上。所以下一步才是关键把 TaoToken 的统一 Key 配进去。4. 用 TaoToken 统一 Key 打通模型通道TaoToken 在这里扮演的角色是给你一个统一的 API 入口和 Key让 Claude Code 这类工具能通过它去调用背后的模型而不用你自己去分别对接每个平台。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。先去控制台创建一个 API Key。打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后在 API Keys 页面新建一个 Key复制出来备用。这个 Key 就是你后面配置里要填的东西注意别泄露。Claude Code 的配置有两种常见方式一种是通过环境变量一种是通过settings.json。Windows 下我更推荐用settings.json因为环境变量在 CMD 和 PowerShell 里写法不一样容易搞混。配置文件一般放在用户目录下的.claude文件夹里路径类似C:\Users\你的用户名\.claude\settings.json。如果文件夹不存在就手动建一个。配置骨架长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你刚才复制的TaoToken Key } }这里两个字段是关键ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你的 Key。Claude Code 启动时会读这个文件把请求发到指定地址并带上鉴权信息。如果你更习惯用环境变量在 PowerShell 里可以这样设当前会话有效$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN你的TaoToken KeyCMD 里则是set ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKEN你的TaoToken Key环境变量的缺点是关掉窗口就失效想持久化还得去系统设置里加所以还是推荐settings.json。5. 一条最小请求验证安装和鉴权是否都生效配置写好后回到你的项目目录启动 Claude Codeclaude第一次启动它可能会让你确认一些初始化选项按提示走完。进入交互界面后发一条最简单的请求比如你好帮我看看当前目录下有哪些文件如果配置正确它会正常返回内容并且能读取你当前目录的文件列表。这一步能返回结果就说明安装、鉴权、模型通道三件事全部打通了。想更直接地验证通道也可以用非交互模式跑一条命令claude -p 用一句话说明你现在能做什么-p是直接输出结果不进入交互界面适合快速测试。如果这条命令能正常打印出模型回复那基本可以确认 TaoToken 的 Key 和地址都生效了。实测下来最容易出问题的就是 Key 复制时带了空格或者settings.json里少了逗号导致 JSON 格式错误。JSON 对格式很敏感改完可以用在线 JSON 校验工具过一遍或者直接看 Claude Code 启动时有没有报解析错误。6. 配置没生效这几个坑挨个排查报鉴权失败或 401先检查ANTHROPIC_AUTH_TOKEN是不是完整复制了有没有多余空格。再去 TaoToken 控制台确认这个 Key 还在有效状态、额度没耗尽。如果用的是环境变量确认当前窗口确实设进去了可以echo %ANTHROPIC_AUTH_TOKEN%CMD或echo $env:ANTHROPIC_AUTH_TOKENPowerShell看一下。报连接超时或找不到地址检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api注意不要多加斜杠或者写成别的路径。地址写错是最常见的连接失败原因。claude命令找不到说明全局安装没成功或者 npm 全局路径没进 PATH。重新跑一次npm install -g anthropic-ai/claude-code然后npm config get prefix看看全局目录在哪把这个目录加进系统 PATH。settings.json 不生效确认文件路径对不对Windows 下是C:\Users\用户名\.claude\settings.json注意.claude前面有个点。另外确认文件编码是 UTF-8有些编辑器默认存成别的编码会导致读取异常。改了配置但没变化Claude Code 启动时读配置改完要退出重进。如果还是不行检查是不是同时设了环境变量和配置文件两者冲突时以哪个为准容易乱建议只保留一种方式。排查顺序建议从「Key 是否有效」→「地址是否正确」→「配置文件格式」→「环境变量冲突」这样一层层往下走基本能覆盖九成以上的问题。接入相关的细节也可以对照 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里的说明核对。7. 接下来怎么用得更顺装好只是起点。日常用 Claude Code 的时候建议在具体项目目录里启动它这样它能直接读到项目文件改代码、查结构都更准。如果你要长期拿它做编码或者跑 Agent 类任务可以了解一下 Coding Plan 这类方案地址在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合需要稳定额度、频繁调用的场景。另外如果你只是想先试试模型对话效果不想折腾命令行也可以直接用模型对话入口 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 快速体验一下确认通道没问题再回到 Claude Code 里干活。Key 的管理建议单独建一个别和别的工具混用方便出问题时定位。配置改完记得重启 Claude CodeJSON 格式每次都要检查。这几步做扎实后面用起来就很少再回头折腾环境了。