Anthropic SDK 使用指南

概述

设置您的开发环境，以便使用您首选语言的 SDK 调用 Anthropic API。本页介绍如何设置本地开发环境以使用 Anthropic API。您可以使用官方支持的 SDK 或 HTTP 客户端。

创建并导出 API 密钥

开始之前，请通过令牌说明创建一个 API 密钥，用于安全访问 API。将密钥存储在安全位置，例如 .zshrc 文件或您电脑上的其他文本文件。生成 API 密钥后，在终端中将其导出为环境变量。

bash

export ANTHROPIC_API_KEY="your_api_key_here"

Windows CMD

setx ANTHROPIC_API_KEY "your_api_key_here"

Windows PowerShell

$env:ANTHROPIC_API_KEY="your_api_key_here"

说明：Anthropic SDK 会自动从系统环境中读取您的 API 密钥。您也可以在代码中直接设置 API 密钥，但这并不安全，尤其是在共享代码时。建议使用环境变量来保护您的密钥。

安装官方 SDK

JavaScript

要在服务器端的 JavaScript 环境中使用 Anthropic API（如 Node.js、Deno 或 Bun），可以使用官方的 TypeScript 和 JavaScript Anthropic SDK。

安装 SDK

使用您偏好的包管理器安装 Anthropic SDK。以下是使用 npm的示例命令：

npm install @anthropic-ai/sdk

安装 Anthropic SDK 后，创建一个名为 anthropic-example.mjs 的文件，并将示例代码复制到其中：

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
  baseURL: "https://api.agentsflare.com/anthropic/v1",
});

const response = await client.messages.create({
  model: 'claude-3-5-sonnet-20241022',
  max_tokens: 1024,
  messages: [
    {
      role: 'user',
      content: 'Write a one-sentence bedtime story about a unicorn.'
    }
  ]
});

console.log(response.content[0].text);

使用 node anthropic-example.mjs（或 Deno 或 Bun 的等效命令）执行，几秒钟后可看到 API 请求的输出结果。

Python

要在 Python 中使用 Anthropic API，可使用官方的 Anthropic Python SDK。

pip install anthropic

创建示例文件anthropic-example.py，并将示例代码复制到其中：

import anthropic
import os

client = anthropic.Anthropic(
    api_key=os.getenv("ANTHROPIC_API_KEY"),
    base_url="https://api.agentsflare.com/anthropic/v1"
)

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Write a one-sentence bedtime story about a unicorn."
        }
    ]
)

print(response.content[0].text)

执行 python anthropic-example.py，几秒钟后可看到 API 请求的输出结果。

.NET

要在 .NET 中使用 Anthropic API，可使用官方的 Anthropic .NET SDK。

dotnet add package Anthropic

示例代码（消息 API 请求）：

using Anthropic;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var client = new AnthropicClient(
            Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY"),
            new Uri("https://api.agentsflare.com/anthropic/v1")
        );

        var response = await client.Messages.CreateAsync(new MessageRequest
        {
            Model = "claude-3-5-sonnet-20241022",
            MaxTokens = 1024,
            Messages = new[]
            {
                new Message
                {
                    Role = Role.User,
                    Content = "Write a one-sentence bedtime story about a unicorn."
                }
            }
        });

        Console.WriteLine(response.Content[0].Text);
    }
}

执行 dotnet run，几秒钟后可看到 API 请求的输出结果。

Java

要在 Java 中使用 Anthropic API，可使用官方的 Anthropic Java SDK。

<dependency>
  <groupId>com.anthropic</groupId>
  <artifactId>anthropic-java</artifactId>
  <version>1.0.0</version>
</dependency>

示例代码（消息 API 请求）：

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.Message;
import com.anthropic.models.MessageCreateParams;
import com.anthropic.models.Model;

AnthropicClient client = AnthropicOkHttpClient.fromEnv();

MessageCreateParams params = MessageCreateParams.builder()
    .addUserMessage("Write a one-sentence bedtime story about a unicorn.")
    .model(Model.CLAUDE_3_5_SONNET)
    .maxTokens(1024)
    .build();

Message message = client.messages().create(params);
System.out.println(message.getContent().get(0).getText());

执行 java -jar anthropic-example.jar，几秒钟后可看到 API 请求的输出结果。

Go

要在 Go 中使用 Anthropic API，可使用官方的 Anthropic Go SDK。

go get github.com/anthropics/anthropic-sdk-go

示例代码（消息 API 请求）：

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"github.com/anthropics/anthropic-sdk-go"
)

func main() {
	client := anthropic.NewClient(
		anthropic.WithAPIKey(os.Getenv("ANTHROPIC_API_KEY")),
		anthropic.WithBaseURL("https://api.agentsflare.com/anthropic/v1"),
	)

	response, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
		Model:     anthropic.F(anthropic.ModelClaude3_5Sonnet20241022),
		MaxTokens: anthropic.F(int64(1024)),
		Messages: anthropic.F([]anthropic.MessageParam{
			anthropic.NewUserMessage(anthropic.NewTextBlock("Write a one-sentence bedtime story about a unicorn.")),
		}),
	})
	if err != nil {
		log.Fatalf("Messages.New error: %v", err)
	}

	fmt.Println(response.Content[0].Text)
}

执行 go run anthropic-example.go，几秒钟后可看到 API 请求的输出结果。