anthropic-sdk-typescript

环境要求

• Node.js 20 LTS 或更高的非 EOL 版本
• 使用 TypeScript 时需 TypeScript >= 5.0
• 也可运行在 Deno 1.28.0+、Bun 1.0+、Cloudflare Workers、Vercel Edge Runtime 等运行时
• 一个可用的 Anthropic API Key

安装与启动步骤

1. 1确认 Node 版本

   SDK 要求 Node.js 20 LTS 或更高，先在终端确认本机版本，过低需先升级。

   node -v

   复制

2. 2安装 SDK

   在项目目录执行安装命令，把 @anthropic-ai/sdk 加入项目依赖。

   npm install @anthropic-ai/sdk

   复制

3. 3配置 API Key

   SDK 默认读取环境变量 ANTHROPIC_API_KEY，需在运行脚本的同一终端里设置。

   export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

   复制

4. 4编写调用脚本

   新建 index.mjs，写入创建客户端并发送一条消息的示例代码。

   import Anthropic from '@anthropic-ai/sdk';
   
   const client = new Anthropic({
     apiKey: process.env['ANTHROPIC_API_KEY'],
   });
   
   const message = await client.messages.create({
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Hello, Claude' }],
     model: 'claude-opus-5-5',
   });
   
   console.log(message.content);

   复制

5. 5运行脚本

   执行脚本，SDK 会带上鉴权信息请求 Claude API 并返回消息内容。

   node index.mjs

   复制

关键配置

如何确认成功

运行 node index.mjs 后终端打印出 message.content 内容数组（含文本块），且无鉴权报错，即调用成功。

常见问题

注意事项

• API Key 属于敏感凭据，不要提交到代码仓库或打包进前端产物。
• 安装与示例只在支持的服务端运行时中验证，Jest 需 28 以上且使用 node 环境，jsdom 环境不支持。
• 示例代码使用 ESM 语法，保存为 .mjs 或在 package.json 中声明 type: module 后运行。