1. Windows 上跑 Claude Code我踩过的那些坑Claude Code 是 Anthropic 推出的命令行 AI 编程助手能直接在你的项目目录里读写文件、执行命令、重构代码适合已经习惯终端工作流的开发者。而 Windows 环境从零把它跑起来坑比 Mac 和 Linux 多不少Node.js 版本不对、npm 全局安装卡住、环境变量设了不生效、settings.json 放错位置、请求地址填错导致一直转圈。这篇就把我在 Windows 上从零到跑通 Claude Code 的完整过程拆开写每一步都给可复制的命令和配置片段你照着做基本能复现。先说清楚这篇适合谁第一次接触 Claude Code 的 Windows 开发者机器上可能连 Node.js 都没装或者装了但版本太老。整条链路是 Node.js → npm → Claude Code CLI → 统一 Key/API 通道 → settings.json → 验证对话。中间任何一环断了后面都会报错所以我会按顺序来并在每个环节给出「怎么判断这步成功了」。我用的统一通道是 TaoToken它把模型调用收敛成一个 Key 和一个 API 地址省得你在多个厂商的地址和模型名之间来回切。下面所有配置都以它为例你换成别的通道时只要把地址和模型名对应替换即可但不要凭感觉猜地址一定以官方文档为准。2. 前置准备Node.js、npm 与 TaoToken 通道2.1 确认 Node.js 版本是否达标Claude Code 对 Node.js 版本有要求太老的版本会在安装或运行时直接报错。先按Win R输入cmd回车打开命令提示符然后执行node --version npm --version判定标准很简单Node.js 版本号建议≥ v22LTS 长期支持版更稳。如果提示「不是内部或外部命令」说明根本没装如果版本号是 v16、v18 这种也建议升级不然后面 npm 装包容易出兼容问题。2.2 安装或升级 Node.js去 Node.js 官网下载页认准LTS标签下载Windows Installer (.msi)。双击安装大部分步骤默认 Next 即可但有一个界面要特别注意出现Tools for Native Modules时勾选「Automatically install the necessary tools」。这一步会自动帮你配好 Python 和 C 编译环境Claude Code 某些底层依赖会用到不勾后面可能卡在编译报错上。安装完成后点 Finish如果弹出一个蓝色 PowerShell 窗口在自动装工具别关等它跑完。然后重新开一个 cmd重要旧窗口读不到新环境变量再执行node --version确认版本达标。2.3 配置 npm 镜像并安装 Claude Code国内直连 npm 官方源经常超时先切镜像再装npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code看到added xxx packages in xx s就说明装好了。如果卡住或 timeout先确认镜像已切换再重试一次仍然不行就检查网络是否稳定不要盲目叠加一堆来路不明的 git 替换配置那些反而容易把 git 全局配置搞乱。2.4 拿到 TaoToken 的 Key 和 API 地址Claude Code 需要一个 API Key 和一个请求地址。走 TaoToken 统一通道的话先去控制台创建 Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite创建完把 Key 复制下来只显示一次丢了就重建。API 基础地址是https://taotoken.net/api这个不加 UTM。模型名以文档里列的为准别照搬别人截图里的名字。注意Key 属于敏感凭证不要写进会提交到 Git 的代码里也不要在公开截图里露出完整字符串。3. 可复制配置settings.json 骨架与环境变量3.1 两种配置方式选一种即可Claude Code 读取配置有两种常见方式环境变量或者settings.json文件。环境变量适合快速试settings.json 适合长期用、方便版本管理。我建议直接用 settings.json结构清晰。在 cmd 里设置环境变量临时当前窗口有效set ANTHROPIC_AUTH_TOKEN你的TaoToken_Key set ANTHROPIC_BASE_URLhttps://taotoken.net/api set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1想永久生效就把set换成setx但setx设置后要新开窗口才读得到。3.2 settings.json 骨架示例Claude Code 的用户级配置一般放在用户目录下的.claude文件夹里。Windows 路径通常是C:\Users\你的用户名\.claude\settings.json。如果文件夹不存在就手动建一个。骨架如下{ env: { ANTHROPIC_AUTH_TOKEN: 你的TaoToken_Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 }, model: 填入文档中的模型名, permissions: { allow: [], deny: [] } }几个关键点逐条说明ANTHROPIC_AUTH_TOKEN填你刚创建的 KeyANTHROPIC_BASE_URL填https://taotoken.net/api注意结尾不要多加斜杠model字段填文档里给出的模型名写错会直接请求失败permissions先留空数组后面按需加白名单。提示JSON 不支持注释也别用中文引号否则解析会报错。改完保存时确认编码是 UTF-8。3.3 项目级配置可选如果你只想在某个项目里用特定模型可以在项目根目录建.claude/settings.json字段结构一样项目级会覆盖用户级。团队协作时把项目级配置提交进仓库但Key 不要提交用环境变量注入。4. 验证请求从启动到第一次成功对话4.1 启动 Claude Code新开一个 cmdcd到你的项目目录然后输入claude第一次启动会问你是否信任当前目录键盘移到Yes, proceed回车。如果配置正确会进入交互界面。4.2 发一条验证消息直接输入一句简单的话比如你是什么模型正常情况它会返回模型信息。这一步能返回内容说明 Key、地址、模型名三者都对上了。如果一直转圈或报 401/404跳到第 5 节排查。4.3 让它做一件真实的小事光对话成功还不够验证它能不能操作文件。在项目目录里输入帮我在当前目录创建一个 hello.txt内容写 hello claude code它会请求写文件权限确认后检查文件是否真的生成了。这一步过了说明工具调用链路是通的。4.4 查看当前配置是否生效在 Claude Code 里可以用内置命令查看状态或者退出后在 cmd 里确认环境变量echo %ANTHROPIC_BASE_URL%输出应该是https://taotoken.net/api。如果为空说明环境变量没生效回去检查是不是用了setx但没开新窗口。5. 本篇常见错误排查5.1 报 401 Unauthorized九成是 Key 的问题复制时带了空格、Key 已失效、或者ANTHROPIC_AUTH_TOKEN名字拼错。重新去控制台复制一次注意别把首尾空白带进去。5.2 报 404 或 model not found模型名写错了或者地址结尾多了斜杠。核对文档里的模型名地址严格写成https://taotoken.net/api。5.3 npm 安装一直 timeout先确认npm config get registry输出的是镜像地址。如果已经是镜像还超时检查网络稳定性重试即可不要盲目叠加一堆 git 替换规则。5.4 改了 settings.json 不生效常见原因文件放错目录、JSON 语法错误、编码不是 UTF-8。用编辑器打开确认没有多余逗号路径是C:\Users\你的用户名\.claude\settings.json。5.5 启动后一直转圈无响应先确认CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1减少非必要请求。再确认地址和 Key 都对。如果还不行换一条最简单的消息测试排除是某次请求内容过长导致。5.6 权限确认太频繁打断思路默认模式下每次改文件、跑命令都要确认。想减少打断可以在permissions.allow里加白名单比如允许特定目录的读写。至于跳过全部权限确认的模式风险很高建议只在明确知道后果的隔离环境里用日常别开。6. 后续怎么用模型对话、接入文档与长期编码跑通之后日常使用分几个方向。想快速验证某个模型效果、对比不同模型回答可以直接用模型对话页面模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入过程中遇到字段、地址、参数问题查接入文档最靠谱接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你是长期用 Claude Code 写代码、跑 Agent 任务按量计费容易失控可以看 Coding PlanCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite另外Claude Code 在 Anthropic 生态里有对应的接入说明配合命令行工作流会更顺ClaudeCodeAnthropichttps://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后给个实用建议把settings.json纳入你的 dotfiles 管理Key 用环境变量注入这样换机器时配置能一键迁移又不会把凭证泄露出去。跑通第一次之后后面升级 CLI 用claude --update就行配置基本不用动。