掌握 Claude API：流式输出、工具调用与系统提示词指南

npm install @anthropic-ai/sdk

import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  apiKey: 'YOUR_N1N_API_KEY',
  baseURL: 'https://api.n1n.ai/v1', // 使用 n1n.ai 提供的统一网关
})

const response = await client.messages.create({
  model: 'claude-3-5-sonnet-20241022',
  max_tokens: 2048,
  system: `你是一名资深的 TypeScript 架构师。
  <rules>
  - 仅输出符合生产标准的防御性代码。
  - 必须包含 JSDoc 注释。
  - 严禁使用 any 类型。
  </rules>`,
  messages: [{ role: 'user', content: '请实现一个通用的单例模式装饰器。' }],
})

const stream = client.messages.stream({
  model: 'claude-3-5-sonnet-20241022',
  max_tokens: 4096,
  messages: [{ role: 'user', content: '请详细解释量子纠缠的原理。' }],
})

// 实时监听内容增量
for await (const event of stream) {
  if (event.type === 'content_block_delta' && event.delta.type === 'text_delta') {
    // 这里可以将 delta.text 通过 WebSocket 或 Server-Sent Events (SSE) 发送给前端
    process.stdout.write(event.delta.text)
  }
}

// 获取最终的完整消息对象，包含 token 统计
const finalMessage = await stream.getFinalMessage()
console.log(`\n生成完毕，共消耗 ${finalMessage.usage.output_tokens} tokens。`)

const response = await client.messages.create({
  model: 'claude-3-5-sonnet-20241022',
  max_tokens: 1024,
  tools: [
    {
      name: 'get_stock_price',
      description: '获取指定股票代码的实时价格',
      input_schema: {
        type: 'object',
        properties: {
          symbol: { type: 'string', description: '股票代码，例如 AAPL' },
        },
        required: ['symbol'],
      },
    },
  ],
  messages: [{ role: 'user', content: '苹果公司现在的股价是多少？' }],
})

if (response.stop_reason === 'tool_use') {
  const toolUse = response.content.find((b) => b.type === 'tool_use')!
  if (toolUse.type === 'tool_use') {
    // 模拟执行本地 API 调用
    const priceData = { symbol: 'AAPL', price: 192.5, currency: 'USD' }

    // 将结果反馈给 Claude
    const finalResponse = await client.messages.create({
      model: 'claude-3-5-sonnet-20241022',
      max_tokens: 1024,
      messages: [
        { role: 'user', content: '苹果公司现在的股价是多少？' },
        { role: 'assistant', content: response.content },
        {
          role: 'user',
          content: [
            {
              type: 'tool_result',
              tool_use_id: toolUse.id,
              content: JSON.stringify(priceData),
            },
          ],
        },
      ],
    })
    console.log(finalResponse.content[0].text)
  }
}