클라이언트 SDK - Claude Docs

Anthropic의 클라이언트 SDK를 파트너 플랫폼을 통해 사용하려면 추가 구성이 필요합니다. Amazon Bedrock을 사용 중인 경우 이 가이드를 참조하세요. Google Cloud Vertex AI를 사용 중인 경우 이 가이드를 참조하세요.

Python

Python 라이브러리 GitHub 저장소 예제:

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)

허용되는 model 문자열:

# 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

TypeScript 라이브러리 GitHub 저장소

이 라이브러리는 TypeScript로 작성되었지만 JavaScript 라이브러리에서도 사용할 수 있습니다.

예제:

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);

허용되는 model 문자열:

// 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

Java 라이브러리 GitHub 저장소 예제:

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);

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

Go 라이브러리 GitHub 저장소 예제:

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)
}

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#

C# 라이브러리 GitHub 저장소

C# SDK는 현재 베타 버전입니다.

예제:

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);

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

Ruby 라이브러리 GitHub 저장소 예제:

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)

허용되는 model 문자열:

# 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

PHP 라이브러리 GitHub 저장소

PHP SDK는 현재 베타 버전입니다.

예제:

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);

허용되는 model 문자열:

// 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"

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

클라이언트 SDK의 베타 네임스페이스

모든 SDK에는 사용 가능한 beta 네임스페이스가 있습니다. 이는 Anthropic이 베타 버전으로 출시하는 새로운 기능에 사용됩니다. 이를 베타 헤더와 함께 사용하여 이러한 기능을 사용하세요.

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

​클라이언트 SDK의 베타 네임스페이스

Python

TypeScript

Java

Go

C#

Ruby

PHP

클라이언트 SDK의 베타 네임스페이스