1. Windows 上跑 Claude Code 到底卡在哪Node.js、Git 与 API 通道三件事Claude Code 是 Anthropic 推出的终端 AI 编程助手它和普通代码补全最大的区别在于它能主动读取你的整个代码库、直接编辑文件、执行终端命令、跑测试还能和 Git、VS Code 这些工具串起来干活。你给它一句「把 utils 里的日期格式化函数抽出来单独成模块顺便补上单测」它会自己找文件、改代码、跑命令验证。适合谁适合已经在 Windows 上写代码、想让 AI 真正动手而不是只给建议的开发者。但 Windows 平台部署 Claude Code 有个现实问题它本质是个 Node.js CLI 工具依赖 Node 运行时和 Git 环境同时默认要连 Anthropic 官方接口。国内网络环境下直连官方接口经常超时所以实际部署链路是「Node.js Git Claude Code CLI 一个兼容 Anthropic 协议的 API 通道」。这篇就把这条链路从头到尾走一遍包括环境变量、settings.json 配置、终端验证命令以及我踩过的几个典型报错。核心检索词先明确Claude Code 在 Windows 上的完整部署需要 Node.js 18、Git for Windows、npm 全局安装 CLI再通过 TaoToken 这类兼容 Anthropic API 的通道拿到 Base URL 和 Key写进~/.claude/settings.json最后在 VS Code 里装插件打通编辑器。下面按顺序来每一步都给可复制的命令和配置。先说清楚一个概念避免后面混淆Claude Code 是一个「执行框架」它负责调度工具、读写文件、跑命令真正生成内容的是背后的大模型。所以框架和模型通道是两件事框架装好了通道配错了照样跑不起来。很多人卡在「claude 命令能识别但一运行就报错」八成是通道没配对。Windows 11 是本文的基准环境Win10 22H2 以上也基本一致。终端建议用 Windows Terminal 里的 PowerShell或者 Git Bash两者都行后面命令会标注差异。整个部署大概 20 分钟其中下载安装占大头。2. 前置准备Node.js 18 与 Git for Windows 的安装与版本校验2.1 安装 Node.js 并确认版本Claude Code CLI 要求 Node.js 18 或更高。直接去 Node.js 官网下载页选 LTS长期维护版别选 CurrentLTS 更稳。下载.msi安装包双击一路默认下一步即可安装程序会自动把node和npm加进 PATH。装完打开一个新的终端窗口重要必须新开旧窗口读不到新 PATH执行node --version npm --version正常输出类似v20.11.1和10.2.4。如果提示「不是内部或外部命令」说明 PATH 没生效重启终端或重启电脑再试。版本低于 18 的话去官网重新下 LTS 覆盖安装。这里有个小坑有些人电脑上之前装过旧版 NodePATH 里可能同时存在多个版本。用where node可以看当前实际调用的是哪个路径确认是刚装的那个。2.2 安装 Git for WindowsGit 不只是版本控制Claude Code 在 Windows 上很多文件操作和 shell 调用依赖 Git Bash 环境所以必须装。去 Git 官网下载 Windows 安装包双击运行。安装过程中有一个关键选项在「Choosing the default editor」之后会遇到「Adjusting your PATH environment」保持默认的「Git from the command line and also from 3rd-party software」即可。再往后有个 HTTPS 传输后端的选择选「Use the OpenSSL library」这个和后面网络请求的兼容性有关别选成 Windows Secure Channel。其余选项默认下一步装完新开终端验证git --version输出git version 2.43.0.windows.1之类就对了。如果要在 VS Code 插件里用还需要记住git-bash.exe的路径通常在C:\Program Files\Git\bin\bash.exe或C:\Program Files\Git\git-bash.exe后面排错会用到。2.3 安装 Claude Code CLI环境齐了用 npm 全局安装 CLInpm install -g anthropic-ai/claude-code如果 npm 下载慢可以先换镜像源再装npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code装完验证claude --version能打印版本号说明 CLI 装好了。这时候直接敲claude会报错或者卡住因为还没配 API 通道和 Key这是正常的下一步解决。3. 接入 TaoTokensettings.json 配置片段与 VS Code 集成3.1 获取 Key 与 Base URLTaoToken 提供兼容 Anthropic 协议的 API 通道Claude Code 只要把 Base URL 指向它、填上 Key 就能跑。先去控制台创建 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建后复制那串sk-开头的 Key只显示一次存好。Base URL 用https://taotoken.net/api注意这个地址后面不加 UTM 参数直接写进配置。3.2 写 settings.jsonWindows 下 Claude Code 的配置文件在用户目录的.claude文件夹里。路径是C:\Users\你的用户名\.claude\settings.json。如果.claude文件夹不存在手动建一个。用记事本或 VS Code 打开没有就新建settings.json写入{ env: { ANTHROPIC_API_KEY: sk-你的真实APIKey, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929 } }三个字段缺一不可ANTHROPIC_API_KEY是你的 KeyANTHROPIC_BASE_URL指向 TaoToken 通道ANTHROPIC_MODEL指定模型 ID。模型 ID 要和你账号里可用的模型一致写错了会报模型不存在。注意JSON 里不能有多余逗号最后一项后面不要加逗号否则解析失败。Windows 记事本保存时确认编码是 UTF-8别存成带 BOM 的格式。3.3 首次启动的 onboarding 配置第一次运行claude时它会走一个引导流程。如果引导卡住或反复弹登录可以在C:\Users\你的用户名\.claude.json注意是用户根目录下的.claude.json不是.claude文件夹里的里补一个字段{ hasCompletedOnboarding: true }如果这个文件里已经有其他内容在最后一个字段后面加逗号再补这一行。这样再运行claude就会跳过引导直接进对话。3.4 VS Code 插件集成终端里聊天不方便和项目文件联动装 VS Code 插件更顺手。前置条件是 VS Code 1.98.0 或更高。在扩展商店搜「Claude Code」安装装完左侧会出现图标。点图标如果提示登录按Ctrl,打开设置搜claude code勾选禁止每次登录提示的选项重启 VS Code就能直接进聊天框。插件还可能报「找不到 git」。解决办法Win 搜索「编辑系统环境变量」→ 环境变量 → 在用户变量或系统变量的 Path 里新增一条 Git 的 bash 路径比如C:\Program Files\Git\bin。保存后重启 VS Code点插件上的 New Session就能用了。插件有三个模式值得记住ask 是先说后动操作前问你edit 是直接执行适合明确低风险的操作plan 是先规划再执行会拆步骤逐步确认。日常改代码用 plan 最稳。4. 验证请求终端命令、成功结果与模型对话确认配置写完进一个项目目录测试。先建个工作目录mkdir C:\Users\你的用户名\Desktop\claude_demo cd C:\Users\你的用户名\Desktop\claude_demo claude首次进目录会问是否信任该文件夹选Yes, I trust this folder。然后进入交互界面直接输入一句测试帮我创建一个 hello.py打印当前时间如果通道配对了它会读取目录、创建文件、写入代码你可以在终端看到工具调用过程。退出用/exit。想单独验证 API 通道是否通可以用 curl 直接打接口curl https://taotoken.net/api/v1/messages ^ -H x-api-key: sk-你的真实APIKey ^ -H anthropic-version: 2023-06-01 ^ -H content-type: application/json ^ -d {\model\:\claude-sonnet-4-5-20250929\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\say hi\}]}PowerShell 里换行符用反引号或者把命令写成一行。返回 JSON 里带content字段就说明通道正常。这一步能快速区分是「通道问题」还是「CLI 问题」。更新 CLI 到最新版claude update如果只是想先在网页里试试模型效果不想装环境可以直接用模型对话页https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 问题5.1 401 Unauthorized最常见。原因通常是 Key 写错、Key 失效、或者settings.json里字段名拼错。检查三点Key 是不是完整复制别漏字符、ANTHROPIC_API_KEY拼写对不对、Base URL 是不是https://taotoken.net/api。改完配置要重启终端环境变量是启动时读的。5.2 local proxy failed / connection refused这个报错说明 CLI 尝试连的地址不通。多半是ANTHROPIC_BASE_URL写成了官方地址或者写错域名。确认写的是 TaoToken 的地址且没有多余斜杠或空格。另外检查系统代理设置如果开了某些网络工具导致请求被劫持也会出现这个错关掉再试。5.3 reading choices / 返回结构解析失败这个通常是模型 ID 写错或者通道返回的响应格式和 CLI 预期不一致。先确认ANTHROPIC_MODEL是你账号里真实可用的模型 ID别照抄别人的。如果模型 ID 对但还报用第 4 节的 curl 命令单独测接口看返回的 JSON 结构是否正常。5.4 OAuth / 反复要求登录Claude Code 默认走 OAuth 登录官方账号但用 API Key 模式时不需要。如果反复弹登录检查.claude.json里hasCompletedOnboarding是否为true以及settings.json里 Key 是否生效。VS Code 插件里则去设置搜claude code勾选跳过登录提示。5.5 插件报 git not found前面提过把 Git 的bin目录加进系统 Path。注意改完要完全退出 VS Code不是关窗口是任务栏右键退出再重开否则读不到新环境变量。排查顺序建议先 curl 测通道 → 再终端跑 claude → 最后 VS Code 插件。一层层排除比一上来就怀疑插件快得多。6. 长期编码与 Agent 场景把 Claude Code 用顺手的几个配置建议环境跑通只是开始。如果你打算长期用 Claude Code 做日常编码甚至跑 Agent 任务有几个点值得提前配好。第一模型选择。日常改代码用响应快的模型复杂重构或长链路任务再切到能力更强的模型。settings.json里的ANTHROPIC_MODEL可以随时改改完重启终端生效。第二项目级配置。除了用户级的~/.claude/settings.jsonClaude Code 还支持项目目录下的配置团队协作时可以把项目相关的模型和参数固化下来避免每个人环境不一致。第三权限与安全。Claude Code 能执行终端命令和改文件第一次在陌生仓库里跑建议用 plan 模式让它先给方案你确认别直接 edit 模式放开跑。生产仓库尤其注意别让它直接连生产数据库或执行危险命令。第四长期用建议走 Coding Plan额度和通道更稳定适合每天都要跑 Agent 的场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite如果你更想先深入某个具体能力比如 Claude Code 的 Agent 工作流或者和 Anthropic 协议的对接细节可以看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 的 Anthropic 协议接入说明在这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite最后说个实际经验Windows 上最容易出问题的不是 CLI 本身而是环境变量和路径。每次改完settings.json或系统 Path养成「新开终端再测」的习惯能省掉一半的「明明改了却没生效」的困惑。配置片段建议用 VS Code 编辑JSON 语法高亮能帮你提前发现逗号和括号问题。