1. Windows 首次装 Claude Code，为什么总卡在 Node.js 和 Key 这两步
Claude Code 是 Anthropic 推出的命令行编程助手，能在终端里直接读写项目文件、跑命令、改代码，适合习惯用命令行干活的开发者。但它在 Windows 上的首次安装，劝退率其实不低：Node.js 版本不对、npm 全局目录没权限、PowerShell 脚本被拦、装完claude命令找不到、Key 写进去了却请求不通——每一步都能让人卡半小时。
我自己第一次装的时候，claude --version能出版本号，但一发起对话就报鉴权失败，翻来覆去查了半天，最后发现是环境变量里的 Key 和配置文件里的 Key 打架了。这类问题不是 Claude Code 本身的锅，而是 Windows 下 Node.js 环境、PowerShell 执行策略、配置文件路径三件事没串起来。
这篇就聚焦一件事：在 Windows 上从零把 Claude Code 装好，并且用 TaoToken 的统一 Key 和 API 通道，把 Node.js 环境确认、settings.json 写入、VS Code 调用验证这条链路一次跑通。适合刚接触 Claude Code、不想在环境配置上反复折腾的人。全程用 PowerShell 操作，配置片段可以直接复制。
核心检索词先摆出来：Claude Code 安装、Node.js 环境确认、npm 全局安装、PowerShell 执行策略、VS Code 配置、TaoToken 统一 Key。下面按“环境检查 → Key 写入 → 请求回显”三步走，每一步都有可复制的命令和预期结果。
2. 装之前先把 TaoToken 的 Key 和通道准备好
Claude Code 默认走 Anthropic 官方通道，但很多人在国内网络环境下直连不稳定，或者想统一管理多个模型的 Key。TaoToken 在这里的角色是提供一个统一的 API 通道和 Key 管理入口，你只需要在 TaoToken 控制台创建一个 Key，然后把它写进 Claude Code 的配置文件，就能让 Claude Code 通过这个通道发起请求。
具体操作路径是这样的：先到 TaoToken 控制台创建一个 API Key，这个 Key 后面要写进 settings.json。控制台地址是 https://taotoken.net/console ，创建 Key 的页面在 https://taotoken.net/api-keys 。创建的时候给它起个能认出来的名字，比如claude-code-win，方便以后区分。
创建完 Key 之后，你需要知道两件事：一是 API 的基础地址，二是这个 Key 本身。TaoToken 的 API 入口是 https://taotoken.net/api ，这个地址后面会作为ANTHROPIC_BASE_URL写进配置。Key 就是刚才创建的那串字符，注意不要泄露，也不要提交到 Git 仓库里。
注意：Key 只在创建时完整显示一次，关掉页面就看不到了。如果没记下来，直接删掉重新建一个，别去猜。
如果你后面打算长期用 Claude Code 做编码或者跑 Agent 任务，可以顺带看一下 Coding Plan 的说明页 https://taotoken.net/coding-plan ，它讲的是怎么把这类编码工具的调用额度规划好，避免用着用着突然断掉。这一步不是必须的，但提前了解没坏处。
3. 可复制配置：Node.js 环境确认 + settings.json 骨架
3.1 用 PowerShell 确认 Node.js 和 npm
Claude Code 依赖 Node.js 运行，所以第一步是确认环境。以管理员身份打开 PowerShell，先看版本：
node -v npm -v预期输出类似v24.14.1和11.12.1。如果提示“无法将 node 识别为 cmdlet”，说明 Node.js 没装或者没进 PATH，去 Node.js 官网下载 LTS 版本的 msi 安装包，安装时勾选“Add to PATH”。
版本确认没问题后，配置 PowerShell 脚本执行权限，否则后面 npm 全局安装可能被拦：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser执行后会问你是否确认，输入Y回车。这个设置只影响当前用户，不会动系统级策略，相对安全。
接着更新 npm 到较新版本，避免旧版 npm 在全局安装时出权限问题：
npm install -g npm@11.12.1然后全局安装 Claude Code：
npm install -g @anthropic-ai/claude-code安装完成后验证：
claude --version能输出版本号就说明命令行工具装好了。如果这一步报错，先看第 5 节的排查部分。
3.2 写入 settings.json 骨架
Claude Code 的配置文件在用户目录下的.claude文件夹里。Windows 下路径是C:\Users\你的用户名\.claude\settings.json。如果文件夹不存在，先创建：
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"然后用编辑器打开或新建settings.json，写入下面的骨架。把sk-你的TaoTokenKey替换成你在控制台创建的真实 Key：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoTokenKey" }, "permissions": { "allow": [], "deny": [] } }这个骨架做了两件事：一是把 API 请求指向 TaoToken 的通道，二是把 Key 通过环境变量注入。permissions字段先留空，后面你用到具体工具时再按需加白名单。
写完之后，可以在 PowerShell 里确认文件内容：
Get-Content "$env:USERPROFILE\.claude\settings.json"确认 Key 和 URL 都写对了，没有多余空格或换行符截断。
提示：如果你之前设置过系统环境变量
ANTHROPIC_API_KEY，它可能会覆盖配置文件里的值。用$env:ANTHROPIC_API_KEY检查一下，如果有冲突，先把系统环境变量清掉，统一以 settings.json 为准。
4. 三步验证：环境检查、Key 写入、请求回显
配置写完了不代表通了，得实际发一次请求看回显。下面三步按顺序做，每步都有明确的成功标志。
4.1 环境检查：确认 claude 命令和配置路径
先确认claude命令能找到，并且它读的是你刚写的配置文件：
claude --version claude config listclaude config list会列出当前生效的配置项。重点看ANTHROPIC_BASE_URL是不是https://taotoken.net/api，以及 Key 是否被正确读取。如果这里显示的还是官方地址，说明 settings.json 没被加载，检查文件路径和 JSON 格式。
4.2 Key 写入验证：发起一次最小对话
在 PowerShell 里直接跑一个最简单的请求，看能不能拿到模型回复：
claude -p "用一句话说明什么是递归"-p参数表示单次提问模式，不进入交互界面。如果配置正确，几秒内会返回一段文字。如果报 401 或鉴权失败，说明 Key 有问题；如果报连接超时，说明 API 地址或网络通道有问题。这两种错误的排查方向不一样，别混在一起查。
4.3 请求回显：在 VS Code 里验证调用链路
Claude Code 本身是命令行工具，但很多人希望在 VS Code 里也能用。VS Code 的 Claude 插件会读取同一份 settings.json，所以只要命令行通了，插件通常也能通。
在 VS Code 里安装 Claude 插件后，打开命令面板（Ctrl+Shift+P），搜索 Claude 相关命令，发起一次对话。如果插件返回了正常回复，说明从 VS Code → 插件 → settings.json → TaoToken 通道 → 模型这条链路是通的。
如果插件报错但命令行正常，优先检查插件是否读取了正确的配置文件路径。有些插件版本会用自己的配置存储，需要在插件设置里手动指向~/.claude/settings.json。
到这里，三步验证都过了，安装流程就算跑通了。后面你可以正常在终端或 VS Code 里用 Claude Code 读写项目文件。
5. 本篇常见错排查：从 npm 报错到 401 鉴权失败
装 Claude Code 过程中遇到的报错，大部分集中在下面几类。我按出现频率排一下，你对号入座。
npm 全局安装报 EACCES 或权限错误。这是 Windows 下 npm 全局目录权限问题。先确认 PowerShell 是以管理员身份打开的，然后检查 npm 全局路径：
npm config get prefix如果路径在C:\Program Files\nodejs下，普通用户没写权限。可以改成用户目录下的路径：
npm config set prefix "$env:APPDATA\npm"改完之后把%APPDATA%\npm加到 PATH 里，重开 PowerShell 再装。
claude命令找不到。说明 npm 全局 bin 目录没进 PATH。用npm config get prefix找到路径，把该路径加到系统环境变量 PATH 里，重启终端。
401 鉴权失败。三种可能：Key 写错了、Key 被系统环境变量覆盖了、Key 本身失效了。按顺序查：先Get-Content看 settings.json 里的 Key，再$env:ANTHROPIC_API_KEY看有没有冲突，最后去 TaoToken 控制台确认 Key 状态。如果 Key 泄露过，直接删掉重建。
连接超时或请求被拒。检查ANTHROPIC_BASE_URL是不是https://taotoken.net/api，注意结尾不要多加斜杠。如果地址对但仍然超时，换个网络环境试试，排除本地网络策略问题。
settings.json 格式错误。JSON 对逗号和引号很敏感。用 VS Code 打开这个文件，它会自动标红语法错误。常见问题是最后一项多了逗号，或者 Key 里混入了中文引号。
VS Code 插件不生效。先确认命令行claude -p能通，再检查插件设置里的配置文件路径。有些插件需要重启 VS Code 才能重新加载配置。
排查的时候记住一个原则：先让命令行通，再管编辑器。命令行是基础，编辑器只是外壳。命令行通了，编辑器的问题基本都在路径和插件配置上。
6. 跑通之后，Key 和通道怎么继续用
安装跑通只是开始，后面你可能会在多个项目、多个工具里用到同一个 Key。TaoToken 的统一 Key 设计就是为了避免每个工具单独配一遍。Claude Code 用这个 Key，其他支持自定义 API 地址的工具也可以用同一个 Key，只要把 base URL 指向 https://taotoken.net/api 就行。
如果你打算长期用 Claude Code 做编码任务，建议把 Key 的管理和额度规划提前做好。Coding Plan 页面 https://taotoken.net/coding-plan 里有关于编码场景下调用规划的说明，可以按自己的使用频率选合适的方案。模型对话的入口在 https://taotoken.net/chat ，想快速验证某个模型能不能通，直接在那里发一句话比在命令行里试更快。接入文档在 https://taotoken.net/doc ，里面有针对不同工具的配置示例，遇到新工具不知道怎么填参数时可以去翻。
最后提醒一句：settings.json 里的 Key 不要提交到 Git。如果你在多个机器上同步配置，用环境变量或者单独的密钥管理工具，别把明文 Key 写进版本控制里。这个坑我见过太多次了，一旦推到公开仓库，Key 基本等于废了，只能删掉重建。
