← Back to daily report

api/client-sdks.md

Changed on 2026-02-06 18:20:36 EST

Unified Diff

--- a/api/client-sdks.md
+++ b/api/client-sdks.md
@@ -1,143 +1,297 @@
 # Client SDKs
 
-We provide client libraries in a number of popular languages that make it easier to work with the Claude API.
+Official SDKs for building with the Claude API in Python, TypeScript, Java, Go, Ruby, C#, and PHP.
 
 ---
 
-This page includes brief installation instructions and links to the open-source GitHub repositories for Anthropic's Client SDKs. For basic usage instructions, see the [API reference](/docs/en/api/overview) For detailed usage instructions, refer to each SDK's GitHub repository. 
-
-<Note>
-Additional configuration is needed to use Anthropic's Client SDKs through a partner platform. If you are using Amazon Bedrock, see [this guide](/docs/en/build-with-claude/claude-on-amazon-bedrock); if you are using Google Cloud Vertex AI, see [this guide](/docs/en/build-with-claude/claude-on-vertex-ai); if you are using Microsoft Foundry, see [this guide](/docs/en/build-with-claude/claude-in-microsoft-foundry).
-</Note>
-
-## Python
-
-[Python library GitHub repo](https://github.com/anthropics/anthropic-sdk-python)
-
-**Requirements:** Python 3.8+
-
-**Minimum SDK version:** 0.22.0
-
-**Installation:**
-
+Anthropic provides official client SDKs in multiple languages to make it easier to work with the Claude API. Each SDK provides idiomatic interfaces, type safety, and built-in support for features like streaming, retries, and error handling.
+
+<CardGroup cols={3}>
+  <Card title="Python" href="/docs/en/api/sdks/python">
+    Sync and async clients, Pydantic models
+  </Card>
+  <Card title="TypeScript" href="/docs/en/api/sdks/typescript">
+    Node.js, Deno, Bun, and browser support
+  </Card>
+  <Card title="Java" href="/docs/en/api/sdks/java">
+    Builder pattern, CompletableFuture async
+  </Card>
+  <Card title="Go" href="/docs/en/api/sdks/go">
+    Context-based cancellation, functional options
+  </Card>
+  <Card title="Ruby" href="/docs/en/api/sdks/ruby">
+    Sorbet types, streaming helpers
+  </Card>
+  <Card title="C#" href="/docs/en/api/sdks/csharp">
+    .NET Standard 2.0+, IChatClient integration
+  </Card>
+  <Card title="PHP" href="/docs/en/api/sdks/php">
+    Value objects, builder pattern
+  </Card>
+</CardGroup>
+
+## Quick installation
+
+<Tabs>
+<Tab title="Python">
 ```bash
 pip install anthropic
 ```
-
----
-
-## TypeScript
-
-[TypeScript library GitHub repo](https://github.com/anthropics/anthropic-sdk-typescript)
-
-<Info>
-While this library is in TypeScript, it can also be used in JavaScript libraries.
-</Info>
-
-**Minimum SDK version:** 0.37.0
-
-**Installation:**
-
+</Tab>
+<Tab title="TypeScript">
 ```bash
 npm install @anthropic-ai/sdk
 ```
-
----
-
-## Java
-
-[Java library GitHub repo](https://github.com/anthropics/anthropic-sdk-java)
-
-**Requirements:** Java 8 or later
-
-**Installation:**
-
-Gradle:
-```groovy
-implementation("com.anthropic:anthropic-java:2.10.0")
-```
-
-Maven:
-```xml
+</Tab>
+<Tab title="Java">
+<CodeGroup>
+```groovy Gradle
+implementation("com.anthropic:anthropic-java:2.11.1")
+```
+
+```xml Maven
 <dependency>
     <groupId>com.anthropic</groupId>
     <artifactId>anthropic-java</artifactId>
-    <version>2.10.0</version>
+    <version>2.11.1</version>
 </dependency>
 ```
-
----
-
-## Go
-
-[Go library GitHub repo](https://github.com/anthropics/anthropic-sdk-go)
-
-**Requirements:** Go 1.22+
-
-**Installation:**
-
-```bash
-go get -u 'github.com/anthropics/anthropic-sdk-go@v1.17.0'
-```
-
----
-
-## C#
-
-[C# library GitHub repo](https://github.com/anthropics/anthropic-sdk-csharp)
-
-<Info>
-The C# SDK is currently in beta.
-</Info>
-
-**Requirements:** .NET 8 or later
-
-**Installation:**
-
+</CodeGroup>
+</Tab>
+<Tab title="Go">
+```bash
+go get github.com/anthropics/anthropic-sdk-go
+```
+</Tab>
+<Tab title="Ruby">
+```bash
+bundler add anthropic
+```
+</Tab>
+<Tab title="C#">
 ```bash
 dotnet add package Anthropic
 ```
-
----
-
-## Ruby
-
-[Ruby library GitHub repo](https://github.com/anthropics/anthropic-sdk-ruby)
-
-**Requirements:** Ruby 3.2.0 or later
-
-**Installation:**
-
-Add to your Gemfile:
-```ruby
-gem "anthropic", "~> 1.13.0"
-```
-
-Then run:
-```bash
-bundle install
-```
-
----
-
-## PHP
-
-[PHP library GitHub repo](https://github.com/anthropics/anthropic-sdk-php)
-
-<Info>
-The PHP SDK is currently in beta.
-</Info>
-
-**Requirements:** PHP 8.1.0 or higher
-
-**Installation:**
-
-```bash
-composer require "anthropic-ai/sdk 0.3.0"
-```
-
----
-
-## Beta namespace in client SDKs
-
-Every SDK has a `beta` namespace that is available for accessing new features that Anthropic releases in beta versions. Use this in conjunction with [beta headers](/docs/en/api/beta-headers) to access these features. Refer to each SDK's GitHub repository for specific usage examples.+</Tab>
+<Tab title="PHP">
+```bash
+composer require anthropic-ai/sdk
+```
+</Tab>
+</Tabs>
+
+## Quick start
+
+<CodeGroup>
+```python Python
+import anthropic
+
+client = anthropic.Anthropic()
+
+message = client.messages.create(
+    model="claude-opus-4-6",
+    max_tokens=1024,
+    messages=[
+        {"role": "user", "content": "Hello, Claude"}
+    ]
+)
+print(message.content)
+```
+
+```typescript TypeScript
+import Anthropic from "@anthropic-ai/sdk";
+
+const client = new Anthropic();
+
+const message = await client.messages.create({
+  model: "claude-opus-4-6",
+  max_tokens: 1024,
+  messages: [
+    { role: "user", content: "Hello, Claude" }
+  ],
+});
+console.log(message.content);
+```
+
+```java Java
+AnthropicClient client = AnthropicOkHttpClient.fromEnv();
+
+MessageCreateParams params = MessageCreateParams.builder()
+    .model(Model.CLAUDE_OPUS_4_6)
+    .maxTokens(1024L)
+    .addUserMessage("Hello, Claude")
+    .build();
+
+Message message = client.messages().create(params);
+System.out.println(message.content());
+```
+
+```go Go
+client := anthropic.NewClient()
+
+message, _ := client.Messages.New(context.Background(), anthropic.MessageNewParams{
+    Model:     anthropic.ModelClaudeOpus4_6,
+    MaxTokens: 1024,
+    Messages: []anthropic.MessageParam{
+        anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")),
+    },
+})
+fmt.Println(message.Content)
+```
+
+```ruby Ruby
+client = Anthropic::Client.new
+
+message = client.messages.create(
+  model: "claude-opus-4-6",
+  max_tokens: 1024,
+  messages: [
+    { role: "user", content: "Hello, Claude" }
+  ]
+)
+puts message.content
+```
+
+```csharp C#
+using Anthropic;
+
+var client = new AnthropicClient();
+
+var message = await client.Messages.Create(new MessageCreateParams
+{
+    Model = "claude-opus-4-6",
+    MaxTokens = 1024,
+    Messages = [new() { Role = Role.User, Content = "Hello, Claude" }]
+});
+Console.WriteLine(message.Content);
+```
+
+```php PHP
+use Anthropic\Client;
+
+$client = new Client(apiKey: getenv('ANTHROPIC_API_KEY'));
+
+$message = $client->messages->create(
+    model: 'claude-opus-4-6',
+    maxTokens: 1024,
+    messages: [
+        ['role' => 'user', 'content' => 'Hello, Claude']
+    ],
+);
+echo $message->content[0]->text;
+```
+</CodeGroup>
+
+## Platform support
+
+All SDKs support multiple deployment options:
+
+| Platform | Description |
+|----------|-------------|
+| Claude API | Connect directly to Claude API endpoints |
+| [Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock) | Use Claude through AWS |
+| [Google Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai) | Use Claude through Google Cloud |
+| [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry) | Use Claude through Microsoft Azure |
+
+See individual SDK pages for platform-specific setup instructions.
+
+## Beta features
+
+Access beta features using the `beta` namespace in any SDK:
+
+<CodeGroup>
+```python Python
+message = client.beta.messages.create(
+    model="claude-opus-4-6",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "Hello"}],
+    betas=["feature-name"]
+)
+```
+
+```typescript TypeScript
+const message = await client.beta.messages.create({
+  model: "claude-opus-4-6",
+  max_tokens: 1024,
+  messages: [{ role: "user", content: "Hello" }],
+  betas: ["feature-name"],
+});
+```
+
+```java Java
+import com.anthropic.models.beta.messages.MessageCreateParams;
+import com.anthropic.models.messages.Model;
+
+MessageCreateParams params = MessageCreateParams.builder()
+    .model(Model.CLAUDE_OPUS_4_6)
+    .maxTokens(1024L)
+    .addUserMessage("Hello")
+    .addBeta("feature-name")
+    .build();
+
+client.beta().messages().create(params);
+```
+
+```go Go
+message, _ := client.Beta.Messages.New(context.Background(), anthropic.BetaMessageNewParams{
+    Model:     anthropic.ModelClaudeOpus4_6,
+    MaxTokens: 1024,
+    Messages: []anthropic.BetaMessageParam{
+        anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello")),
+    },
+    Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBeta("feature-name")},
+})
+```
+
+```ruby Ruby
+message = anthropic.beta.messages.create(
+  model: "claude-opus-4-6",
+  max_tokens: 1024,
+  messages: [{ role: "user", content: "Hello" }],
+  betas: ["feature-name"]
+)
+```
+
+```csharp C#
+var message = await client.Beta.Messages.Create(new MessageCreateParams
+{
+    Model = "claude-opus-4-6",
+    MaxTokens = 1024,
+    Messages = [new() { Role = Role.User, Content = "Hello" }],
+    Betas = ["feature-name"],
+});
+```
+
+```php PHP
+$message = $client->beta->messages->create(
+    model: 'claude-opus-4-6',
+    maxTokens: 1024,
+    messages: [['role' => 'user', 'content' => 'Hello']],
+    betas: ['feature-name'],
+);
+```
+</CodeGroup>
+
+See [Beta headers](/docs/en/api/beta-headers) for available beta features.
+
+## Requirements
+
+| SDK | Minimum Version |
+|-----|-----------------|
+| Python | 3.9+ |
+| TypeScript | 4.9+ (Node.js 20+) |
+| Java | 8+ |
+| Go | 1.22+ |
+| Ruby | 3.2.0+ |
+| C# | .NET Standard 2.0 |
+| PHP | 8.1.0+ |
+
+## GitHub repositories
+
+- [anthropic-sdk-python](https://github.com/anthropics/anthropic-sdk-python)
+- [anthropic-sdk-typescript](https://github.com/anthropics/anthropic-sdk-typescript)
+- [anthropic-sdk-java](https://github.com/anthropics/anthropic-sdk-java)
+- [anthropic-sdk-go](https://github.com/anthropics/anthropic-sdk-go)
+- [anthropic-sdk-ruby](https://github.com/anthropics/anthropic-sdk-ruby)
+- [anthropic-sdk-csharp](https://github.com/anthropics/anthropic-sdk-csharp)
+- [anthropic-sdk-php](https://github.com/anthropics/anthropic-sdk-php)