---
title: C# SDK
url: https://platform.claude.com/docs/ja/cli-sdks-libraries/sdks/csharp
description: IChatClient統合を備えた.NETアプリケーション向けのAnthropic C# SDKをインストールして設定する
---

Anthropic C# SDKは、C#で書かれたアプリケーションからClaude APIへの便利なアクセスを提供します。

<Info>
  コード例を含むAPI機能のドキュメントについては、[APIリファレンス](https://platform.claude.com/docs/ja/api/overview)を参照してください。このページでは、C#固有のSDK機能と設定について説明します。
</Info>

<Warning>
  バージョン10以降、`Anthropic`パッケージはC#向けの公式Anthropic SDKになりました。パッケージバージョン3.X以下は、以前はtryAGIコミュニティ製のSDKに使用されていましたが、これは[`tryAGI.Anthropic`](https://www.nuget.org/packages/tryagi.Anthropic/)に移行しました。プロジェクトで以前のクライアントを引き続き使用する必要がある場合は、パッケージ参照を`tryAGI.Anthropic`に更新してください。
</Warning>

## インストール

[NuGet](https://www.nuget.org/packages/Anthropic)からパッケージをインストールします。

```bash
dotnet add package Anthropic
```

## 要件

このライブラリには.NET Standard 2.0以降が必要です。

## 使用方法

```csharp
using System;
using Anthropic;
using Anthropic.Models.Messages;

AnthropicClient client = new();

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

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

foreach (var block in message.Content)
{
    if (block.TryPickText(out var textBlock))
    {
        Console.WriteLine(textBlock.Text);
    }
}
```

Workload Identity Federationを含む認証オプションについては、[認証](https://platform.claude.com/docs/ja/manage-claude/authentication)を参照してください。お使いのAPIキーが複数のワークスペースにアクセスできる[個人キーまたはサービスアカウントキー](https://platform.claude.com/docs/ja/manage-claude/authentication#key-types)である場合は、`anthropic-workspace-id`リクエストヘッダーにワークスペースIDを設定してください。[ワークスペースを選択する](https://platform.claude.com/docs/ja/manage-claude/authentication#select-a-workspace)では、このSDKにおけるリクエストごとのオプションを示しています。

## クライアント設定

環境変数を使用してクライアントを設定します。

```csharp
using Anthropic;

// 環境変数 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL を使用して設定されます
AnthropicClient client = new();
```

または手動で設定します。

```csharp
using Anthropic;

AnthropicClient client = new() { ApiKey = "my-anthropic-api-key" };
```

または、2つのアプローチを組み合わせて使用します。

利用可能なオプションについては、次の表を参照してください。

| プロパティ       | 環境変数                   | 必須    | デフォルト値                        |
| ----------- | ---------------------- | ----- | ----------------------------- |
| `ApiKey`    | `ANTHROPIC_API_KEY`    | false | -                             |
| `AuthToken` | `ANTHROPIC_AUTH_TOKEN` | false | -                             |
| `BaseUrl`   | `ANTHROPIC_BASE_URL`   | true  | `"https://api.anthropic.com"` |

### 設定の変更

同じ接続とスレッドプールを再利用しながら、変更したクライアント設定を一時的に使用するには、任意のクライアントまたはサービスで`WithOptions`を呼び出します。

```csharp
using System;

var message = await client
    .WithOptions(options =>
        options with
        {
            BaseUrl = "https://example.com",
            Timeout = TimeSpan.FromSeconds(42),
        }
    )
    .Messages.Create(parameters);

Console.WriteLine(message);
```

[`with`式](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/operators/with-expression)を使用すると、変更したオプションを簡単に構築できます。

`WithOptions`メソッドは、元のクライアントやサービスには影響しません。

## ストリーミング

SDKは、レスポンスの「チャンク」ストリームを返すメソッドを定義しています。各チャンクは、完全なレスポンスを待つのではなく、到着するとすぐに個別に処理できます。「streaming」（ストリーミング）メソッドは一般的に[SSE](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events)または[JSONL](https://jsonlines.org)レスポンスに対応します。

ストリーミングメソッドは、非ストリーミングのバリアントがない場合でも、常に名前に`Streaming`サフィックスが付きます。

これらのストリーミングメソッドは[`IAsyncEnumerable`](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.iasyncenumerable-1)を返します。

```csharp
using System;
using Anthropic.Models.Messages;

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

await foreach (var message in client.Messages.CreateStreaming(parameters))
{
    Console.WriteLine(message);
}
```

## エラー処理

SDKはカスタムの非チェック例外型をスローします。

* `AnthropicApiException`：APIエラーの基底クラス。各HTTPステータスコードに対してどの例外サブクラスがスローされるかについては、次の表を参照してください。

| ステータス | 例外                                       |
| ----- | ---------------------------------------- |
| 400   | `AnthropicBadRequestException`           |
| 401   | `AnthropicUnauthorizedException`         |
| 403   | `AnthropicForbiddenException`            |
| 404   | `AnthropicNotFoundException`             |
| 422   | `AnthropicUnprocessableEntityException`  |
| 429   | `AnthropicRateLimitException`            |
| 5xx   | `Anthropic5xxException`                  |
| その他   | `AnthropicUnexpectedStatusCodeException` |

さらに、すべての4xxエラーは`Anthropic4xxException`を継承します。

* `AnthropicSseException`：最初のHTTPレスポンスが成功した後、SSEストリーミング中に発生したエラーに対してスローされます。

* `AnthropicIOException`：I/Oネットワークエラー。

* `AnthropicInvalidDataException`：正常にパースされたデータの解釈に失敗した場合。たとえば、必須であるはずのプロパティにアクセスしたが、APIが予期せずレスポンスからそれを省略した場合などです。

* `AnthropicException`：すべての例外の基底クラス。

## リトライ

SDKはデフォルトで自動的に2回リトライし、リクエスト間に短い指数バックオフを挟みます。

以下のエラータイプのみがリトライされます。

* 接続エラー（たとえば、ネットワーク接続の問題によるもの）
* 408 Request Timeout
* 409 Conflict
* 429 Rate Limit（レート制限）
* 5xx Internal

APIは、リクエストをリトライするかしないかをSDKに明示的に指示する場合もあります。

カスタムのリトライ回数を設定するには、`MaxRetries`プロパティを使用してクライアントを設定します。

```csharp
using Anthropic;

AnthropicClient client = new() { MaxRetries = 3 };
```

または、`WithOptions`を使用して単一のメソッド呼び出しを設定します。

```csharp
using System;

var message = await client
    .WithOptions(options =>
        options with { MaxRetries = 3 }
    )
    .Messages.Create(parameters);

Console.WriteLine(message);
```

## タイムアウト

リクエストはデフォルトで10分後にタイムアウトします。

カスタムのタイムアウトを設定するには、`Timeout`オプションを使用してクライアントを設定します。

```csharp
using System;
using Anthropic;

AnthropicClient client = new() { Timeout = TimeSpan.FromSeconds(42) };
```

または、`WithOptions`を使用して単一のメソッド呼び出しを設定します。

```csharp
using System;

var message = await client
    .WithOptions(options =>
        options with { Timeout = TimeSpan.FromSeconds(42) }
    )
    .Messages.Create(parameters);

Console.WriteLine(message);
```

## ページネーション

SDKは、ページ分割された結果のリストを返すメソッドを定義しています。結果に1ページずつアクセスする方法と、すべてのページにわたってアイテムごとにアクセスする方法の両方を便利に提供します。

### 自動ページネーション

すべてのページにわたってすべての結果を反復処理するには、`Paginate`メソッドを使用します。このメソッドは必要に応じて自動的に追加のページを取得します。このメソッドは[`IAsyncEnumerable`](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.iasyncenumerable-1)を返します。

```csharp
using System;

var page = await client.Messages.Batches.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}
```

### 手動ページネーション

個々のページのアイテムにアクセスし、次のページを手動でリクエストするには、`Items`プロパティと、`HasNext`および`Next`メソッドを使用します。

```csharp
var page = await client.Messages.Batches.List();
while (true)
{
    foreach (var item in page.Items)
    {
        Console.WriteLine(item);
    }
    if (!page.HasNext())
    {
        break;
    }
    page = await page.Next();
}
```

## レスポンスの検証

まれに、APIが期待される型と一致しないレスポンスを返す場合があります。デフォルトでは、SDKはこの場合に例外をスローしません。プロパティに直接アクセスした場合にのみ`AnthropicInvalidDataException`をスローします。

レスポンスが完全に正しく型付けされていることを事前に確認したい場合は、`Validate`を呼び出します。

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

または、`ResponseValidation`オプションを使用してクライアントを設定します。

```csharp
using Anthropic;

AnthropicClient client = new() { ResponseValidation = true };
```

または、`WithOptions`を使用して単一のメソッド呼び出しを設定します。

```csharp
using System;

var message = await client
    .WithOptions(options =>
        options with { ResponseValidation = true }
    )
    .Messages.Create(parameters);

Console.WriteLine(message);
```

## IChatClient統合

SDKは、`Microsoft.Extensions.AI.Abstractions`ライブラリの`IChatClient`インターフェースの実装を提供します。これにより、`AnthropicClient`（および`Anthropic.Services.IBetaService`）を、これらのコア抽象化と統合する他のライブラリと共に使用できます。たとえば、MCP C# SDK（`ModelContextProtocol`）ライブラリのツールは、`IChatClient`を通じて公開された`AnthropicClient`で直接使用できます。

```csharp
using Anthropic;
using Microsoft.Extensions.AI;
using ModelContextProtocol.Client;

// 環境変数 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL を使用して設定されます
AnthropicClient client = new();

IChatClient chatClient = client.AsIChatClient("claude-opus-5-5")
    .AsBuilder()
    .UseFunctionInvocation()
    .Build();

// MCP C# SDK の McpClient を使用します
McpClient learningServer = await McpClient.CreateAsync(
    new HttpClientTransport(new() { Endpoint = new("https://learn.microsoft.com/api/mcp") }));

ChatOptions options = new() { Tools = [.. await learningServer.ListToolsAsync()] };

Console.WriteLine(await chatClient.GetResponseAsync("Tell me about IChatClient", options));
```

## リクエストとレスポンス

Claude APIにリクエストを送信するには、`Params`クラスのインスタンスを構築し、対応するクライアントメソッドに渡します。レスポンスを受信すると、C#クラスのインスタンスにデシリアライズされます。

たとえば、`client.Messages.Create`は`MessageCreateParams`のインスタンスで呼び出す必要があり、`Task<Message>`のインスタンスを返します。

## 高度な使用方法

### バイナリレスポンス

SDKは、バイナリレスポンスを返すメソッドを定義しています。これは、非JSONデータのように必ずしもパースすべきではないAPIレスポンスに使用されます。

これらのメソッドは`HttpResponse`を返します。

```csharp
using System;
using Anthropic.Models.Files;

FileDownloadParams parameters = new() { FileID = "file_id" };

var response = await client.Files.Download(parameters);

Console.WriteLine(response);
```

レスポンスの内容をファイルまたは任意の[`Stream`](https://learn.microsoft.com/en-us/dotnet/api/system.io.stream)に保存するには、[`CopyToAsync`](https://learn.microsoft.com/en-us/dotnet/api/system.io.stream.copytoasync)メソッドを使用します。

```csharp
using System.IO;

using var response = await client.Files.Download(parameters);
using var contentStream = await response.ReadAsStream();
using var fileStream = File.Open(path, FileMode.OpenOrCreate);
await contentStream.CopyToAsync(fileStream); // Or any other Stream
```

### 生のレスポンス

SDKは、レスポンスをC#クラスのインスタンスにデシリアライズするメソッドを定義しています。レスポンスヘッダー、ステータスコード、または生のレスポンスボディにアクセスするには、クライアントまたはサービスの任意のHTTPメソッド呼び出しの前に`WithRawResponse`を付けます。

```csharp
var response = await client.WithRawResponse.Messages.Create(parameters);
var statusCode = response.StatusCode;
var headers = response.Headers;
```

生の`HttpResponseMessage`には、`RawMessage`プロパティを通じてアクセスすることもできます。

非ストリーミングレスポンスの場合、必要に応じてレスポンスをC#クラスのインスタンスにデシリアライズできます。

```csharp
using System;
using Anthropic.Models.Messages;

var response = await client.WithRawResponse.Messages.Create(parameters);
Message deserialized = await response.Deserialize();
Console.WriteLine(deserialized);
```

ストリーミングレスポンスの場合、必要に応じてレスポンスを`IAsyncEnumerable`にデシリアライズできます。

```csharp
using System;

var response = await client.WithRawResponse.Messages.CreateStreaming(parameters);
await foreach (var item in response.Enumerate())
{
    Console.WriteLine(item);
}
```

### ロギング

<Warning>
  すべてのログメッセージはデバッグ専用です。ログメッセージの形式と内容はリリース間で変更される可能性があります。
</Warning>

環境変数を設定してデバッグロギングを有効にします。

```bash
export ANTHROPIC_LOG=debug
```

### ドキュメント化されていないAPI機能

SDKは、ドキュメント化されたAPIを便利に使用できるように型付けされています。ただし、ドキュメント化されていない、またはまだサポートされていないAPIの部分を扱うこともサポートしています。

## プラットフォーム統合

<Note>
  コード例を含む詳細なプラットフォームセットアップガイドについては、以下を参照してください。

  * [Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)
  * [Amazon Bedrock（Opus 4.6以前）](https://platform.claude.com/docs/ja/build-with-claude/claude-on-amazon-bedrock-legacy)
  * [Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)
  * [Google Cloud](https://platform.claude.com/docs/ja/build-with-claude/claude-on-vertex-ai)
  * [Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)
</Note>

C# SDKは、個別のNuGetパッケージを通じて以下のプラットフォームをサポートしています。

* **Agent Platform：** `Anthropic.Vertex`。クライアントのセットアップについては、[Google Cloud上のClaude](https://platform.claude.com/docs/ja/build-with-claude/claude-on-vertex-ai)を参照してください。
* **Bedrock：** `Anthropic.Bedrock`。Messages-API Bedrockエンドポイントには`AnthropicBedrockMantleClient`を、または`AnthropicBedrockClient`（`bedrock-runtime`パス）を使用します。`AnthropicBedrockMantleClient`はオプションの`MantleAwsClientOptions`設定オブジェクトを受け取ります。`AnthropicBedrockClient`は`AnthropicBedrockCredentialsHelper.FromEnv()`または明示的な認証情報を受け付けます。
* **Claude Platform on AWS：** `Anthropic.Aws`。`AnthropicAwsClient`を使用します。クライアントで`WorkspaceId`を設定するか、`ANTHROPIC_AWS_WORKSPACE_ID`環境変数を設定します（[ワークスペース](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#workspaces)を参照）。ベータ版で利用可能です。
* **Foundry：** `Anthropic.Foundry`。`AnthropicFoundryClient`を`DefaultAnthropicFoundryCredentials.FromEnv()`または明示的な認証情報と共に使用します。

新しいプロジェクトには`AnthropicBedrockMantleClient`を使用してください。`AnthropicBedrockClient`は、Bedrockの`InvokeModel` APIを使用する既存のアプリケーション向けに引き続き提供されます。

## セマンティックバージョニング

このパッケージは一般的に[SemVer](https://semver.org/spec/v2.0.0.html)の規約に従いますが、特定の後方互換性のない変更がマイナーバージョンとしてリリースされる場合があります。

1. 技術的にはpublicであるが、外部での使用を意図またはドキュメント化していないライブラリ内部への変更。
2. 実際には大多数のユーザーに影響を与えないと予想される変更。

スムーズなアップグレード体験を確実に提供できるよう、後方互換性は真剣に考慮されています。

## 追加リソース

* [GitHubリポジトリ](https://github.com/anthropics/anthropic-sdk-csharp)
* [NuGetパッケージ](https://www.nuget.org/packages/Anthropic)
* [APIリファレンス](https://platform.claude.com/docs/ja/api/overview)
* [メッセージのストリーミング](https://platform.claude.com/docs/ja/build-with-claude/streaming)