--- title: ベータヘッダー url: https://platform.claude.com/docs/ja/api/beta-headers description: "`anthropic-beta` ヘッダーまたはSDKの `betas` パラメータを使用して、標準APIの一部になる前の実験的機能にアクセスします。" --- ベータヘッダー（beta headers）を使用すると、標準APIの一部になる前の実験的機能や新しいモデル機能にアクセスできます。 [クライアントSDK](https://platform.claude.com/docs/ja/cli-sdks-libraries/overview)は、ベータ機能を有効にしてAPIを呼び出すための `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) 名前空間を公開しています。 ## ベータヘッダーの使用方法 ベータ機能にアクセスするには、APIリクエストに `anthropic-beta` ヘッダーを含めます。 ```http POST /v1/messages x-api-key: YOUR_API_KEY anthropic-version: 2023-06-01 anthropic-beta: BETA_FEATURE_NAME content-type: application/json ``` 各機能のドキュメントには、送信すべき正確なベータ名が記載されています。[API概要](https://platform.claude.com/docs/ja/api/overview)には、現在ベータ版のAPIが一覧表示されています。 以下の例では、[コンテキスト編集](https://platform.claude.com/docs/ja/build-with-claude/context-editing)ベータを例として、cURL、`ant` CLI、およびSDKで同じリクエストを示します。SDKは `betas` (csharp, go: `Betas`; java: `.addBeta()`) を通じてベータ名を受け取り、`anthropic-beta` ヘッダーを自動的に送信します： ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: context-management-2025-06-27" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` ```bash CLI ant beta:messages create \ --beta context-management-2025-06-27 \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ```python Python client = Anthropic() response = client.beta.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], betas=["context-management-2025-06-27"], ) print(response.content) ``` ```typescript TypeScript const client = new Anthropic(); const msg = await client.beta.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello, Claude" }], betas: ["context-management-2025-06-27"] }); console.log(msg.content); ``` ```csharp C# var client = new AnthropicClient(); var message = await client.Beta.Messages.Create( new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], Betas = ["context-management-2025-06-27"], } ); Console.WriteLine(string.Join("\n", message.Content)); ``` ```go Go client := anthropic.NewClient() message, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, Messages: []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude")), }, Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaContextManagement2025_06_27}, }) if err != nil { panic(err) } fmt.Printf("%+v\n", message.Content) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024) .addUserMessage("Hello, Claude") .addBeta(AnthropicBeta.CONTEXT_MANAGEMENT_2025_06_27) .build(); BetaMessage message = client.beta().messages().create(params); System.out.println(message.content()); ``` ```php PHP $client = new Client(); $message = $client->beta->messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', betas: ['context-management-2025-06-27'], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.beta.messages.create( model: "claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello, Claude"}], betas: ["context-management-2025-06-27"] ) puts(message.content) ``` ベータ機能は実験的なものであり、以下の可能性があります。 * 通知の上で破壊的変更が行われる * 非推奨になる、または削除される * レート制限や価格が異なる * すべてのリージョンで利用できるとは限らない ### 複数のベータ機能 1つのリクエストで複数のベータ機能を使用するには、すべての機能名をカンマで区切ってヘッダーに含めます。 ```http anthropic-beta: feature1,feature2,feature3 ``` 同じリクエスト内で`anthropic-beta`ヘッダーを複数回送信することもできます。Claude APIはすべての`anthropic-beta`ヘッダーを読み取るため、以下は前の例と同等です： ```http anthropic-beta: feature1 anthropic-beta: feature2 anthropic-beta: feature3 ``` SDKでは、各機能を列挙します（例：`betas=["feature1", "feature2"]` (typescript, ruby: `betas: ["feature1", "feature2"]`; php: `betas: ['feature1', 'feature2']`; csharp: `Betas = ["feature1", "feature2"]`; go: `Betas: []anthropic.AnthropicBeta{"feature1", "feature2"}`; java: `.addBeta("feature1").addBeta("feature2")`)）。CLIでは、機能名をカンマで区切って単一の `--beta` フラグに渡します（例：`--beta feature1,feature2`）。フラグを繰り返し指定することもできます（例：`--beta feature1 --beta feature2`）。 ### 他のプラットフォームでのベータ機能 ベータ名はそれを受け付けるすべてのプラットフォームで同じですが、すべてのプラットフォームがすべてのベータを受け付けるわけではありません。[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)、[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)、および[Google Cloud](https://platform.claude.com/docs/ja/build-with-claude/claude-on-vertex-ai)は、Claude APIと同様に `anthropic-beta` ヘッダーでベータ名を受け取ります。複数のベータを送信するには、それらの名前をカンマで区切って1つのヘッダーに入れてください。Google Cloudは `anthropic-beta` ヘッダーを1つだけ読み取り、残りは無視するため、他のヘッダーに含まれるベータは有効になりません。 Amazon Bedrockでは、ベータ名を指定する場所は呼び出すAPIによって異なります： * [Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)（`bedrock-mantle` エンドポイント）は、`anthropic-beta` ヘッダーでベータ名を受け取ります。 * [InvokeModel API](https://platform.claude.com/docs/ja/build-with-claude/claude-on-amazon-bedrock-legacy)は、ヘッダーではなくリクエストボディからベータ名を読み取ります。ボディの `anthropic_beta` 配列に、1要素につき1つの名前で列挙してください。例：`"anthropic_beta": ["feature1", "feature2"]`。 ### エンドポイント固有のヘッダー 一部のベータAPIは特定のエンドポイントにスコープが限定されており、すべてのリクエストで機能固有のベータヘッダーが必要です。 | エンドポイント | ベータヘッダー | | ---------------------------------------------- | --------------------------- | | `/v1/agents`、`/v1/sessions`、`/v1/environments` | `managed-agents-2026-04-01` | | `/v1/tunnels` | `mcp-tunnels-2026-06-22` | | `/v1/memory_stores` およびサブリソース | `agent-memory-2026-07-22` | SDKの `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) 名前空間は、これらのヘッダーを自動的に追加します。自分で追加する必要があるのは、生のHTTPリクエストを行う場合のみです。詳細については、[Managed Agentsの概要](https://platform.claude.com/docs/ja/managed-agents/overview)、[エージェントメモリの使用](https://platform.claude.com/docs/ja/managed-agents/memory)、および[MCPトンネルリファレンス](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/reference#tunnels-api)を参照してください。 同じエンドポイントに適用されるエンドポイント固有のヘッダーは、常に組み合わせられるとは限りません。メモリストアのエンドポイントでは、`agent-memory-2026-07-22` が `managed-agents-2026-04-01` を置き換えます。同じリクエストで両方を送信すると `400` エラーが返されます。SDKは各エンドポイントに対して正しいヘッダーを自動的に送信します。 ### バージョン命名規則 ベータ機能名は通常 `feature-name-YYYY-MM-DD` というパターンに従い、日付はベータがリリースされた時期を示します。必ずドキュメントに記載されている正確なベータ機能名を使用してください。 ## エラー処理 無効なベータ名、または組織がアクセス権を持たないベータを使用した場合、`400` エラーレスポンスが返されます。 ```json Output { "type": "error", "error": { "type": "invalid_request_error", "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header." }, "request_id": "req_011CcnGfC9fELffo2EALu4Wd" } ``` ## サポートの利用 ベータ機能の更新情報については、[リリースノート](https://platform.claude.com/docs/ja/release-notes/overview)を参照してください。本番環境の問題に関するサポートについては、[サポート](https://support.claude.com/)にお問い合わせください。 ## 次のステップ Claude APIが返すHTTPステータスコード、エラーレスポンスの形式、リクエストIDを理解し、SDKの型付き例外でエラーを処理します。 現在ベータ版のAPIを含む、Claude APIの機能を確認します。