1. Windows 下 Claude API 第一条请求为什么总卡在环境上
很多刚接触 Claude API 的开发者，第一反应是打开浏览器搜一段示例代码，复制到本地一跑，结果 PowerShell 里蹦出一串红字：node 不是内部或外部命令、npm 无法加载文件、401 invalid api key。问题往往不在代码本身，而在于 Windows 的终端环境和 Node.js 工具链没有理顺。Claude API 的最小可运行链路其实只有四步：装 Node.js、初始化 npm 项目、配置 API Key 与 Base URL、发一条对话请求。但每一步在 PowerShell 里都有坑，尤其是路径、执行策略和环境变量这三块。
这篇内容面向的是刚接触 Claude API、手上只有一台 Windows 电脑的开发者。你不需要提前懂 Node.js，也不需要会写复杂脚本，只要跟着把命令敲一遍，就能在本地跑通第一条请求，并且看到结构化的 JSON 返回。整条链路我会用 Chocolatey 装 Node.js，用 npm 初始化项目，用.env管理密钥，最后用一段fetch脚本和一条curl命令双重验证。实测下来，从零到返回choices字段，顺利的话十五分钟内能搞定。
需要先明确一个概念：Claude API 是 Anthropic 提供的模型调用接口，你发一段对话消息，它返回模型生成的文本。而 Claude Code 是另一条产品线，是跑在终端里的编码代理工具。两者都依赖 Node.js，但调用方式不同。这篇聚焦的是 API 请求本身，也就是你用自己的脚本去调模型，而不是用现成的 CLI 工具。搞清楚这一点，后面的配置才不会混。
环境上，Windows 10 或 Windows 11 都可以，PowerShell 用系统自带的 5.x 版本就够。如果你之前装过 Node.js 但版本很旧，建议先卸干净再重装，避免 npm 全局路径错乱。下面从 Chocolatey 开始，一步步把链路搭起来。
2. 用 Chocolatey 装 Node.js 并初始化 npm 项目
Chocolatey 是 Windows 上的包管理工具，作用类似 macOS 的 Homebrew。有了它，装 Node.js 只需要一行命令，不用去官网下载安装包再点下一步。先以管理员身份打开 PowerShell：点击开始菜单，搜索 PowerShell，右键选择“以管理员身份运行”。窗口标题出现 Administrator 字样就对了。
先检查是否已经装过 Chocolatey：
choco -v如果输出版本号，比如2.2.0，说明已经装好，直接跳到安装 Node.js。如果提示无法将“choco”项识别为 cmdlet，说明没装，执行下面这段安装脚本。注意这是一次性操作，装完以后不用再跑：
Set-ExecutionPolicy Bypass -Scope Process -Force; ` [System.Net.ServicePointManager]::SecurityProtocol = ` [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ` iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))等待一到三分钟，窗口不要关。跑完后再执行一次choco -v，能看到版本号就成功了。如果还是不行，关掉 PowerShell 重新以管理员身份打开再试。
接下来装 Node.js。Claude API 的调用脚本依赖 Node 18 以上版本，Chocolatey 默认装的是 LTS 版，满足要求：
choco install nodejs -y安装过程大概两到五分钟。装完后验证：
node -v npm -v两条命令都输出版本号，比如v20.11.1和10.2.4，这一关就过了。如果node -v没输出，先关掉当前 PowerShell 再重新打开，让环境变量刷新。
现在建项目目录。我习惯放在用户目录下的 projects 文件夹里：
mkdir $HOME\projects\claude-first-call cd $HOME\projects\claude-first-call npm init -ynpm init -y会生成一个默认的package.json。为了让项目支持 ES Module 语法（后面脚本里用import），需要把package.json改成下面这样。你可以直接用编辑器打开改，也可以用命令覆盖：
{ "name": "claude-first-call", "version": "1.0.0", "type": "module", "scripts": { "start": "node index.js" }, "dependencies": {} }关键字段是"type": "module"，没有它，脚本里的import会报Cannot use import statement outside a module。这个坑我踩过，排查了半天才发现是 package.json 少了一行。
3. 配置 .env 与调用脚本，把 Base URL 和 Key 写对
密钥和接口地址不要硬编码在脚本里，用.env文件管理，既安全又方便切换。先装dotenv：
npm install dotenv然后在项目根目录新建.env文件，内容如下。这里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY需要替换成你自己的实际值。TaoToken 的 API 地址是https://taotoken.net/api，密钥在控制台的 API Keys 页面生成：
ANTHROPIC_BASE_URL=https://taotoken.net/api ANTHROPIC_API_KEY=sk-你的实际密钥 ANTHROPIC_MODEL=claude-sonnet-4-20250514三个变量分别对应接口地址、密钥、模型 ID。模型 ID 要写完整，不能只写claude或sonnet，否则请求会返回模型不存在的错误。如果你不确定当前可用的模型 ID，可以在模型对话页面先手动试一条，确认能出结果再写进配置。
接着创建index.js，这是核心调用脚本：
import 'dotenv/config'; const baseUrl = process.env.ANTHROPIC_BASE_URL; const apiKey = process.env.ANTHROPIC_API_KEY; const model = process.env.ANTHROPIC_MODEL; async function main() { const response = await fetch(`${baseUrl}/v1/messages`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' }, body: JSON.stringify({ model: model, max_tokens: 256, messages: [ { role: 'user', content: '用一句话解释什么是 API。' } ] }) }); const data = await response.json(); console.log(JSON.stringify(data, null, 2)); } main().catch((err) => { console.error('请求失败:', err.message); });几个关键点。请求头里x-api-key放密钥，anthropic-version固定写2023-06-01，这是接口版本号，不写会报错。请求体里max_tokens控制返回长度，第一次测试给 256 就够。messages是对话数组，role只有user和assistant两种。
如果你更习惯用curl快速验证，可以在 PowerShell 里直接跑这条命令。注意 PowerShell 里curl是Invoke-WebRequest的别名，参数格式和 Linux 不一样，建议用curl.exe显式调用：
curl.exe -X POST "https://taotoken.net/api/v1/messages" ` -H "Content-Type: application/json" ` -H "x-api-key: sk-你的实际密钥" ` -H "anthropic-version: 2023-06-01" ` -d "{\"model\":\"claude-sonnet-4-20250514\",\"max_tokens\":128,\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"这条命令能直接看到原始返回，适合排查是脚本问题还是网络问题。如果curl.exe能通而脚本不通，问题多半在.env读取或 Node 版本上。
4. 运行脚本验证返回结构，确认 choices 字段
配置写好后，在项目目录下执行：
npm start正常情况下，终端会打印一段 JSON。Claude API 的返回结构和 OpenAI 略有不同，核心字段是content数组，而不是choices。你会看到类似这样的输出：
{ "id": "msg_01XyZ...", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "API 是应用程序之间约定好的通信接口，让不同软件能互相调用功能。" } ], "model": "claude-sonnet-4-20250514", "stop_reason": "end_turn", "usage": { "input_tokens": 18, "output_tokens": 32 } }判断请求成功看三个地方：type是message，content数组里有text字段，stop_reason是end_turn。usage里的 token 数可以用来估算成本。如果你之前用过 OpenAI 的接口，注意别去找choices，Claude 的返回结构里没有这个字段，找错了会以为请求失败。
如果返回里出现error字段，比如：
{ "type": "error", "error": { "type": "authentication_error", "message": "invalid x-api-key" } }说明密钥不对或没读到。先检查.env文件里ANTHROPIC_API_KEY有没有多余空格，再确认脚本里import 'dotenv/config'写在最前面。dotenv必须在其他代码之前加载，否则process.env读不到值。
验证通过后，你可以把messages里的内容换成任意问题，比如让它写一段排序算法、解释某个报错、翻译一段文本。每次改完直接npm start就行，不用重新配置。这一步跑通，说明整条链路已经打通，后面接自己的业务逻辑只是替换 prompt 和解析返回的事。
5. 常见报错排查：401、local proxy failed 与 OAuth 提示
实际跑的时候，报错基本集中在下面几类。我把真实遇到过的错误信息和对应解法列出来，方便你对照。
401 authentication_error：返回invalid x-api-key或missing api key。原因通常是密钥写错、.env没加载、或者 PowerShell 里环境变量被系统旧值覆盖。先确认.env文件在项目根目录，文件名就是.env不带后缀。然后在脚本开头加一行console.log(process.env.ANTHROPIC_API_KEY)看是否打印出密钥。如果打印undefined，说明 dotenv 没生效，检查package.json里有没有"type": "module"。
local proxy failed / ECONNREFUSED：这类错误说明请求根本没发出去，卡在本地网络层。常见原因是系统里设了全局代理，但代理没开或者端口不对。检查 PowerShell 里的代理设置：
netsh winhttp show proxy如果显示有代理地址，而你并不需要，用netsh winhttp reset proxy清掉。另外检查环境变量HTTP_PROXY和HTTPS_PROXY有没有被设成无效值，有就删掉。
reading 'choices' of undefined：这是把 OpenAI 的解析逻辑套到 Claude 上了。Claude 返回的是content数组，不是choices。如果你在代码里写data.choices[0]，必然报这个错。改成data.content[0].text即可。这个错误在从其他模型迁移过来时特别常见。
OAuth 相关提示：如果你在终端里看到要求登录、授权、跳转浏览器的提示，说明你运行的是 Claude Code 这类 CLI 工具，而不是纯 API 脚本。API 调用不需要 OAuth，只需要 API Key。两者配置方式不同，别混用。如果你确实想用 Claude Code，那需要单独安装并走它的登录流程，和这篇的 API 链路是两回事。
模型不存在 model_not_found：检查ANTHROPIC_MODEL是否写完整。模型 ID 区分大小写，也不能简写。建议直接从模型对话页面复制可用的模型名。
排查顺序建议是：先跑curl.exe确认网络和密钥没问题，再跑npm start确认脚本逻辑。两步分开定位，比一上来就改代码高效得多。
6. 后续怎么把这套链路用起来
第一条请求跑通之后，你可以把这套结构直接扩展成小工具。比如把messages换成从命令行参数读取，做成一个node ask.js "你的问题"的问答脚本；或者把返回的content[0].text写进文件，做批量文本处理。项目结构不用变，只改index.js里的逻辑就行。
密钥管理上，.env文件记得加进.gitignore，别提交到仓库。如果你要长期做编码类任务或者跑 Agent 流程，可以了解下 Coding Plan 这类方案，按周期使用比单次调用更划算。日常调试模型效果，直接在模型对话页面手动试 prompt 更快，确认好了再写进脚本。
接口地址和密钥都在控制台的 API Keys 页面管理，文档里有完整的参数说明和错误码对照。遇到返回结构看不懂的时候，先看文档里的响应示例，比在网上搜零散答案准。这套 Windows + PowerShell + Node.js 的链路搭好一次，后面换项目直接复制package.json和.env模板就能复用。
