安装

系统要求

• Node.js ≥ 18.x（LTS）
• TypeScript ≥ 5.0
• ESM — SDK 仅支持 ES Module 项目

npm 安装

npm install claude-code-sdk-ts

添加 API 密钥

SDK 需要 Anthropic API 密钥才能工作。可以通过环境变量配置：

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

或在代码中直接传入：

import { ClaudeCodeSDK } from 'claude-code-sdk-ts'

const sdk = new ClaudeCodeSDK({
  llm: {
    provider: 'anthropic',
    apiKey: 'sk-ant-xxxxxxxxxxxxx',
    model: 'claude-sonnet-4-20250514',
  },
})

验证安装

运行以下代码验证 SDK 是否正常工作：

import { ClaudeCodeSDK } from 'claude-code-sdk-ts'

const sdk = new ClaudeCodeSDK({
  llm: {
    provider: 'anthropic',
    apiKey: process.env.ANTHROPIC_API_KEY!,
    model: 'claude-sonnet-4-20250514',
  },
})

console.log('SDK 版本:', sdk.version)
// SDK 版本: 0.4.0

可选依赖

根据不同 Provider，可能需要安装额外的包：