Client SDK - Claude Docs

È necessaria una configurazione aggiuntiva per utilizzare gli SDK Client di Anthropic attraverso una piattaforma partner. Se stai utilizzando Amazon Bedrock, consulta questa guida; se stai utilizzando Google Cloud Vertex AI, consulta questa guida.

Python

Repository GitHub della libreria Python Esempio:

Python

import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(message.content)

Stringhe model accettate:

# Claude 4 Models
"claude-opus-4-1-20250805"
"claude-opus-4-1"  # alias
"claude-opus-4-20250514"
"claude-opus-4-0"  # alias
"claude-sonnet-4-5-20250929"
"claude-sonnet-4-5"  # alias
"claude-sonnet-4-20250514"
"claude-sonnet-4-0"  # alias
"claude-haiku-4-5-20251001"
"claude-haiku-4-5"  # alias

# Claude 3.7 Models
"claude-3-7-sonnet-20250219" # deprecated
"claude-3-7-sonnet-latest"  # alias

# Claude 3.5 Models
"claude-3-5-haiku-20241022"
"claude-3-5-haiku-latest"  # alias

# Claude 3 Models
"claude-3-opus-20240229"  # deprecated
"claude-3-opus-latest"  # alias
"claude-3-haiku-20240307"

TypeScript

Repository GitHub della libreria TypeScript

Sebbene questa libreria sia in TypeScript, può essere utilizzata anche in librerie JavaScript.

Esempio:

TypeScript

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

const anthropic = new Anthropic({
  apiKey: 'my_api_key', // defaults to process.env["ANTHROPIC_API_KEY"]
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-4-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }],
});
console.log(msg);

Stringhe model accettate:

// Claude 4 Models
"claude-opus-4-1-20250805"
"claude-opus-4-1"  // alias
"claude-opus-4-20250514"
"claude-opus-4-0"  // alias
"claude-sonnet-4-5-20250929"
"claude-sonnet-4-5"  // alias
"claude-sonnet-4-20250514"
"claude-sonnet-4-0"  // alias
"claude-haiku-4-5-20251001"
"claude-haiku-4-5"  // alias

// Claude 3.7 Models
"claude-3-7-sonnet-20250219"  // deprecated
"claude-3-7-sonnet-latest"  // alias

// Claude 3.5 Models
"claude-3-5-haiku-20241022"
"claude-3-5-haiku-latest"  // alias

// Claude 3 Models
"claude-3-opus-20240229"  // deprecated
"claude-3-opus-latest"  // alias
"claude-3-haiku-20240307"

Java

Repository GitHub della libreria Java Esempio:

Java

import com.anthropic.models.Message;
import com.anthropic.models.MessageCreateParams;
import com.anthropic.models.Model;

MessageCreateParams params = MessageCreateParams.builder()
    .maxTokens(1024L)
    .addUserMessage("Hello, Claude")
    .model(Model.CLAUDE_SONNET_4_0)
    .build();
Message message = client.messages().create(params);

Valori enum model:

// Claude 4 Models
Model.CLAUDE_OPUS_4_1
Model.CLAUDE_OPUS_4_1_20250805
Model.CLAUDE_OPUS_4_0
Model.CLAUDE_OPUS_4_20250514
Model.CLAUDE_SONNET_4_5_20250929
Model.CLAUDE_SONNET_4_5
Model.CLAUDE_SONNET_4_20250514
Model.CLAUDE_SONNET_4_0
Model.CLAUDE_HAIKU_4_5_20251001
Model.CLAUDE_HAIKU_4_5

// Claude 3.7 Models
Model.CLAUDE_3_7_SONNET_LATEST  // alias
Model.CLAUDE_3_7_SONNET_20250219  // deprecated

// Claude 3.5 Models
Model.CLAUDE_3_5_HAIKU_LATEST
Model.CLAUDE_3_5_HAIKU_20241022

// Claude 3 Models
Model.CLAUDE_3_OPUS_LATEST
Model.CLAUDE_3_OPUS_20240229  // deprecated
Model.CLAUDE_3_HAIKU_20240307

Go

Repository GitHub della libreria Go Esempio:

package main

import (
	"context"
	"fmt"
	"github.com/anthropics/anthropic-sdk-go/option"

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

func main() {
	client := anthropic.NewClient(
		option.WithAPIKey("my-anthropic-api-key"),
	)

	message, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
		Model:     anthropic.ModelClaudeSonnet4_0,
		MaxTokens: 1024,
		Messages: []anthropic.MessageParam{
			anthropic.NewUserMessage(anthropic.NewTextBlock("What is a quaternion?")),
		},
	})
	if err != nil {
		fmt.Printf("Error creating message: %v\n", err)
		return
	}

	fmt.Printf("%+v\n", message.Content)
}

Costanti Model:

// Claude 4 Models
anthropic.ModelClaudeOpus4_1
anthropic.ModelClaudeOpus4_1_20250805
anthropic.ModelClaudeOpus4_0
anthropic.ModelClaudeOpus4_20250514
anthropic.ModelClaudeSonnet4_5_20250929
anthropic.ModelClaudeSonnet4_5
anthropic.ModelClaudeSonnet4_20250514
anthropic.ModelClaudeSonnet4_0
anthropic.ModelClaudeHaiku4_5_20251001
anthropic.ModelClaudeHaiku4_5

// Claude 3.7 Models
anthropic.ModelClaude3_7SonnetLatest  // alias
anthropic.ModelClaude3_7Sonnet20250219  // deprecated

// Claude 3.5 Models
anthropic.ModelClaude3_5HaikuLatest
anthropic.ModelClaude3_5Haiku20241022

// Claude 3 Models
anthropic.ModelClaude3OpusLatest
anthropic.ModelClaude_3_Opus_20240229  // deprecated
anthropic.ModelClaude_3_Haiku_20240307

C#

Repository GitHub della libreria C#

L’SDK C# è attualmente in beta.

Esempio:

using System;
using Anthropic;
using Anthropic.Models.Messages;
using Anthropic.Models.Messages.MessageParamProperties;

// Uses ANTHROPIC_API_KEY environment variable by default
AnthropicClient client = new();

MessageCreateParams parameters = new()
{
    MaxTokens = 1024,
    Messages =
    [
        new()
        {
            Role = Role.User,
            Content = "Hello, Claude",
        },
    ],
    Model = Model.ClaudeSonnet4_0,
};

var message = await client.Messages.Create(parameters);

Console.WriteLine(message);

Valori Model:

// Claude 4 Models
Model.ClaudeOpus4_1_20250805
Model.ClaudeOpus4_0  // alias
Model.ClaudeOpus4_20250514
Model.Claude4Opus20250514  // alias
Model.ClaudeSonnet4_5_20250929
Model.ClaudeSonnet4_5  // alias
Model.ClaudeSonnet4_20250514
Model.ClaudeSonnet4_0  // alias
Model.Claude4Sonnet20250514  // alias
Model.ClaudeHaiku4_5_20251001
Model.ClaudeHaiku4_5  // alias

// Claude 3.7 Models
Model.Claude3_7SonnetLatest  // alias
Model.Claude3_7Sonnet20250219  // deprecated

// Claude 3.5 Models
Model.Claude3_5HaikuLatest  // alias
Model.Claude3_5Haiku20241022

// Claude 3 Models
Model.Claude3OpusLatest  // alias
Model.Claude_3_Opus_20240229  // deprecated
Model.Claude_3_Haiku_20240307

Ruby

Repository GitHub della libreria Ruby Esempio:

ruby

require "bundler/setup"
require "anthropic"

anthropic = Anthropic::Client.new(
  api_key: "my_api_key" # defaults to ENV["ANTHROPIC_API_KEY"]
)

message =
  anthropic.messages.create(
    max_tokens: 1024,
    messages: [{
      role: "user",
      content: "Hello, Claude"
    }],
    model: "claude-sonnet-4-5"
  )

puts(message.content)

Stringhe model accettate:

# Claude 4 Models
:"claude-opus-4-1-20250805"
:"claude-opus-4-1"  # alias
:"claude-opus-4-20250514"
:"claude-opus-4-0"  # alias
:"claude-sonnet-4-5-20250929"
:"claude-sonnet-4-5"  # alias
:"claude-sonnet-4-20250514"
:"claude-sonnet-4-0"  # alias
:"claude-haiku-4-5-20251001"
:"claude-haiku-4-5"  # alias

# Claude 3.7 Models
:"claude-3-7-sonnet-20250219"  # deprecated
:"claude-3-7-sonnet-latest"  # alias

# Claude 3.5 Models
:"claude-3-5-haiku-20241022"
:"claude-3-5-haiku-latest"  # alias

# Claude 3 Models
:"claude-3-opus-20240229"  # deprecated
:"claude-3-opus-latest"  # alias
:"claude-3-haiku-20240307"

PHP

Repository GitHub della libreria PHP

L’SDK PHP è attualmente in beta.

Esempio:

PHP

<?php

use Anthropic\Client;
use Anthropic\Messages\MessageParam;

$client = new Client(
  apiKey: getenv("ANTHROPIC_API_KEY") ?: "my-anthropic-api-key"
);

$message = $client->messages->create(
  maxTokens: 1024,
  messages: [MessageParam::with(role: "user", content: "Hello, Claude")],
  model: "claude-sonnet-4-5",
);
var_dump($message->content);

Stringhe model accettate:

// Claude 4 Models
"claude-opus-4-1-20250805"
"claude-opus-4-1"  // alias
"claude-opus-4-20250514"
"claude-opus-4-0"  // alias
"claude-sonnet-4-5-20250929"
"claude-sonnet-4-5"  // alias
"claude-sonnet-4-20250514"
"claude-sonnet-4-0"  // alias
"claude-haiku-4-5-20251001"
"claude-haiku-4-5"  // alias

// Claude 3.7 Models
"claude-3-7-sonnet-20250219"  // deprecated
"claude-3-7-sonnet-latest"  // alias

// Claude 3.5 Models
"claude-3-5-haiku-20241022"
"claude-3-5-haiku-latest"  // alias

// Claude 3 Models
"claude-3-opus-20240229"  // deprecated
"claude-3-opus-latest"  // alias
"claude-3-haiku-20240307"

Costanti Model:

// Claude 4 Models
Model::CLAUDE_OPUS_4_1_20250805
Model::CLAUDE_OPUS_4_0  // alias
Model::CLAUDE_OPUS_4_20250514
Model::CLAUDE_SONNET_4_5_20250929
Model::CLAUDE_SONNET_4_5  // alias
Model::CLAUDE_SONNET_4_20250514
Model::CLAUDE_SONNET_4_0  // alias
Model::CLAUDE_HAIKU_4_5_20251001
Model::CLAUDE_HAIKU_4_5  // alias

// Claude 3.7 Models
Model::CLAUDE_3_7_SONNET_LATEST  // alias
Model::CLAUDE_3_7_SONNET_20250219  // deprecated

// Claude 3.5 Models
Model::CLAUDE_3_5_HAIKU_LATEST  // alias
Model::CLAUDE_3_5_HAIKU_20241022

// Claude 3 Models
Model::CLAUDE_3_OPUS_LATEST  // alias
Model::CLAUDE_3_OPUS_20240229  // deprecated
Model::CLAUDE_3_HAIKU_20240307

Namespace beta negli SDK client

Ogni SDK ha uno spazio dei nomi beta disponibile. Questo viene utilizzato per le nuove funzionalità che Anthropic rilascia in una versione beta. Utilizzalo insieme alle intestazioni beta per utilizzare queste funzionalità.

import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.beta.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    betas=["beta-feature-name"]
)
print(message.content)

​Python

​TypeScript

​Java

​Go

​C#

​Ruby

​PHP

​Namespace beta negli SDK client

Python

TypeScript

Java

Go

C#

Ruby

PHP

Namespace beta negli SDK client