---
title: Migrasi ke versi API 2026-10-21
url: https://platform.claude.com/docs/id/api/migration-2026-10-21
description: "Tingkatkan integrasi Claude API dari versi API 2023-06-01 ke 2026-10-21: versi SDK yang perlu diinstal dan perubahan kode yang perlu dilakukan."
---
Panduan ini mencantumkan perubahan kode untuk berpindah dari versi API `2023-06-01` ke `2026-10-21`. [Langkah-langkah peningkatan](https://platform.claude.com/docs/id/api/migration-2026-10-21#migration-checklist) menjelaskan apa yang harus dilakukan, secara berurutan.
## Langkah-langkah peningkatan
Jika Anda menggunakan SDK, permintaan Anda menggunakan versi API yang berlaku saat versi mayor SDK Anda dirilis. Versi yang ditampilkan untuk bahasa Anda adalah yang pertama menggunakan `2026-10-21`, jadi tingkatkan ke versi tersebut. Jika Anda memanggil API tanpa SDK, atur header `anthropic-version` ke `2026-10-21`.
Atur header `anthropic-version` ke `2026-10-21`:
```bash
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'
```
Tingkatkan CLI `ant` ke versi 2.0.0. Perintah Homebrew dan unduhan rilis tetap sama.
Go mengharuskan path modul pada versi mayor 2 atau lebih baru diakhiri dengan versi tersebut, sehingga path modul CLI sekarang adalah `github.com/anthropics/anthropic-cli/v2`. Jika Anda menginstal dengan `go install`, tambahkan `/v2` ke path:
```bash
# Sebelum
go install 'github.com/anthropics/anthropic-cli/cmd/ant@latest'
# Sesudah
go install 'github.com/anthropics/anthropic-cli/v2/cmd/ant@latest'
```
Path lama tetap menginstal rilis v1 terbaru, tanpa error atau peringatan.
Tingkatkan paket `anthropic` ke versi 2.0.0.
Tingkatkan paket `@anthropic-ai/sdk` ke versi 1.0.0.
v1 dari `@anthropic-ai/bedrock-sdk`, `@anthropic-ai/vertex-sdk`, `@anthropic-ai/foundry-sdk`, `@anthropic-ai/aws-sdk`, dan `@anthropic-ai/google-cloud-sdk` memerlukan v1 dari `@anthropic-ai/sdk`, dan versi sebelumnya memerlukan versi di bawah 1. Jika Anda menggunakan salah satunya, pindahkan ke v1 dalam peningkatan yang sama. Jika tidak, package manager Anda akan menginstal salinan kedua `@anthropic-ai/sdk` yang lebih lama untuknya.
Tingkatkan paket `Anthropic` ke versi 13.0.0.
Tingkatkan ke versi 2.0.0 dari Go SDK, yang path modulnya adalah `github.com/anthropics/anthropic-sdk-go/v2`. Versi mayor baru dari modul Go memiliki path impor baru, jadi ubah setiap impor `github.com/anthropics/anthropic-sdk-go`, dan paket-paketnya seperti `github.com/anthropics/anthropic-sdk-go/option`, agar diawali dengan `github.com/anthropics/anthropic-sdk-go/v2`. Kemudian jalankan `go get github.com/anthropics/anthropic-sdk-go/v2`.
Tingkatkan artefak `com.anthropic:anthropic-java` ke versi 3.0.0.
Jalankan `composer require "anthropic-ai/sdk"` untuk meningkatkan paket ke versi 1.0.0. `composer update` saja tetap berada dalam batasan versi Anda saat ini.
Tingkatkan gem `anthropic` ke versi 2.0.0.
Di Amazon Bedrock, `2026-10-21` hanya tersedia untuk model Claude 4.7 dan yang lebih baru. Jika Anda memanggil model yang lebih lama di Bedrock, yang tercantum di [Claude di Amazon Bedrock (Opus 4.6 dan sebelumnya)](https://platform.claude.com/docs/id/build-with-claude/claude-on-amazon-bedrock-legacy), tetaplah pada versi SDK yang Anda gunakan saat ini, atau, jika Anda mengatur versi API sendiri, tetap kirimkan versi yang Anda kirim saat ini. Untuk memindahkan panggilan tersebut ke `2026-10-21`, alihkan terlebih dahulu ke model Claude 4.7 atau yang lebih baru.
Rilis peningkatan ini bersama dengan perbaikan Anda dari langkah berikutnya.
Tinjau [perubahan yang merusak kompatibilitas](https://platform.claude.com/docs/id/api/migration-2026-10-21#breaking-changes), dan perbarui kode Anda untuk setiap perubahan yang memengaruhi Anda. Lakukan juga [perubahan kode yang diperlukan oleh versi SDK atau CLI yang baru](https://platform.claude.com/docs/id/api/migration-2026-10-21#sdk-changes).
Uji integrasi Anda terhadap `2026-10-21` sebelum Anda merilis.
## Perubahan yang merusak kompatibilitas
### Messages API
Perubahan ini berlaku untuk permintaan ke Messages API (`POST /v1/messages`), untuk [penghitungan token](https://platform.claude.com/docs/id/build-with-claude/token-counting), dan untuk setiap permintaan dalam [Message Batch](https://platform.claude.com/docs/id/build-with-claude/batch-processing) yang dibuat dengan `2026-10-21`.
#### Blok dokumen dalam pesan assistant mengembalikan error
Memengaruhi Anda jika Anda mengirim blok `document` secara langsung dalam pesan `assistant`.
Di `2026-10-21`, permintaan yang menempatkan blok `document` secara langsung dalam pesan `assistant` mengembalikan error 400. Kirim dokumen dalam pesan `user` sebagai gantinya. Dokumen yang bersarang di dalam blok lain, seperti hasil alat web fetch yang dikembalikan Claude, tetap diterima.
#### Sitasi dalam pesan user mengembalikan error
Memengaruhi Anda jika Anda mengirim `citations` pada blok `text` dalam pesan `user`, termasuk di dalam blok `search_result`.
Di `2026-10-21`, permintaan yang mengirim blok `text` dengan array `citations` yang tidak kosong dalam pesan `user` mengembalikan error 400. Hapus `citations` dari blok-blok tersebut. Sitasi pada blok `text` dalam pesan `assistant`, seperti balasan Claude sebelumnya yang Anda kirim kembali, tetap diterima, begitu pula pengaturan `"citations": {"enabled": true}` pada dokumen dan hasil pencarian.
#### Parameter sampling dihapus
Memengaruhi Anda jika Anda mengirim `temperature`, `top_p`, atau `top_k` dalam permintaan Messages atau permintaan Message Batch.
Di `2026-10-21`, permintaan yang mengirim `temperature`, `top_p`, atau `top_k` mengembalikan error 400, bahkan pada nilai default parameter tersebut.
Hapus ketiga parameter tersebut dari permintaan Anda.
Sejak versi mayor terbaru, SDK dan CLI tidak lagi memiliki ketiga parameter tersebut.
Tanpa parameter ini, permintaan melakukan sampling dengan nilai default-nya, termasuk `temperature` sebesar 1.0, sama seperti permintaan `2023-06-01` yang tidak menyertakannya. Model yang sudah hanya menerima nilai default, seperti model Claude 4.7 dan yang lebih baru, melakukan sampling seperti sebelumnya. Pada model yang menerima nilai lain, seperti Claude Sonnet 4.6, permintaan yang menurunkan `temperature` untuk output yang lebih konsisten kehilangan efek tersebut. Tidak ada pengaturan lain yang menggantikannya. Jika suatu permintaan bergantung pada nilai non-default, hentikan pengiriman parameter tersebut, atau pertahankan permintaan itu pada `2023-06-01`.
### Admin API dan Claude Enterprise Analytics API
Memengaruhi Anda jika kode Anda membaca field respons Admin API atau Claude Enterprise Analytics API dalam tabel berikut.
Di `2026-10-21`, respons dari Admin API dan [Claude Enterprise Analytics API](https://platform.claude.com/docs/id/manage-claude/analytics-api) tidak lagi menyertakan nama lama dari field yang diganti namanya. Gunakan nama baru sebagai gantinya.
Admin API:
| Endpoint | Nama lama | Nama baru |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Grup RBAC](https://platform.claude.com/docs/id/api/beta/organization/rbac_groups/list): create, list, retrieve, dan update | `roles` | `role_ids` |
| [Anggota grup RBAC](https://platform.claude.com/docs/id/api/beta/organization/rbac_groups/members/list): list dan add, serta respons untuk [menghapus anggota](https://platform.claude.com/docs/id/api/beta/organization/rbac_groups/members/remove) | `group_id` | `rbac_group_id` |
| [Peran RBAC](https://platform.claude.com/docs/id/api/beta/organization/rbac_roles/list): list dan retrieve | `name` | `display_name` |
| Batas laju [organisasi](https://platform.claude.com/docs/id/api/organization/rate_limits/list) dan [workspace](https://platform.claude.com/docs/id/api/organization/workspaces/rate_limits/list): list, serta respons untuk mengatur batas laju workspace | `group_type` | `group.type` |
| [Kunci API](https://platform.claude.com/docs/id/api/organization/api_keys/list): list, retrieve, dan update | `workspace_id` | `scope` (nilai berbeda; lihat [`workspace_id` pada kunci API](https://platform.claude.com/docs/id/api/migration-2026-10-21#api-key-workspace-id)) |
Claude Enterprise Analytics API:
| Endpoint | Nama lama | Nama baru |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------- | --------------------- |
| Laporan [penggunaan](https://platform.claude.com/docs/id/api/beta/organization/analytics/user_usage_report/list) dan [biaya](https://platform.claude.com/docs/id/api/beta/organization/analytics/user_cost_report/list) per pengguna | `actor.email` | `actor.email_address` |
| [Ringkasan aktivitas](https://platform.claude.com/docs/id/api/beta/organization/analytics/summaries/list) | `summaries` | `data` |
Parameter kueri `group_type` pada endpoint list batas laju dan filter `workspace_id` pada endpoint list kunci API tidak berubah.
#### `workspace_id` pada kunci API
Memengaruhi Anda jika kode Anda membaca `workspace_id` pada kunci API.
Di `2023-06-01`, `workspace_id` dari kunci API adalah ID workspace tempat kunci tersebut terikat, atau `null` untuk kunci yang terikat ke Default Workspace dan untuk kunci yang tidak terikat ke satu workspace (kunci semua workspace).
Di `2026-10-21`, `workspace_id` dihapus. Baca `scope` sebagai gantinya: untuk kunci yang terikat ke workspace, termasuk Default Workspace, `scope.workspace_id` adalah ID sebenarnya dari workspace tersebut, dan kunci semua workspace memiliki `scope` berupa `{"type": "organization"}`, tanpa `workspace_id`.
Jika kode Anda memperlakukan `workspace_id` yang bernilai `null` sebagai Default Workspace, bandingkan `scope.workspace_id` dengan ID Default Workspace Anda sebagai gantinya. Untuk menemukan ID tersebut, panggil [List Workspaces](https://platform.claude.com/docs/id/api/organization/workspaces/list) dengan `include_default=true` dan ambil workspace bernama `"Default"`.
## Perubahan SDK dan CLI
Versi SDK dan CLI sebelumnya mengirim `anthropic-version: 2023-06-01` pada setiap permintaan. Versi di bawah [Beralih ke 2026-10-21](https://platform.claude.com/docs/id/api/migration-2026-10-21#upgrade) mengirim `2026-10-21`. Perubahan dalam [Perubahan yang merusak kompatibilitas](https://platform.claude.com/docs/id/api/migration-2026-10-21#breaking-changes) juga berlaku untuk versi tersebut: parameter yang dihapus dan nama field lama juga hilang dari tipe SDK serta dari flag dan output CLI.
### Versi API di Amazon Bedrock dan Google Cloud
Klien SDK untuk Google Cloud's Agent Platform menyebutkan versi di body permintaan, bukan di header. Klien ini mengirim `anthropic_version: 2026-10-21`, sedangkan versi sebelumnya mengirim `vertex-2023-10-16`, dan tidak mengirim header `anthropic-version`.
Klien Amazon Bedrock melakukan hal yang sama. Klien ini mengirim `anthropic_version: 2026-10-21`, sedangkan versi sebelumnya mengirim `bedrock-2023-05-31`, dan tidak mengirim header `anthropic-version`. Model yang lebih lama dari Claude Opus 4.7 belum mendukung versi API `2026-10-21` di Bedrock, dan permintaan yang menyebutkannya mungkin mendapatkan error 400. Jika Anda menggunakan salah satunya, tetaplah pada versi SDK sebelumnya untuk saat ini, atau tingkatkan dan kirim `bedrock-2023-05-31` sendiri.
Ini berlaku untuk `AnthropicVertex`, `AsyncAnthropicVertex`, `AnthropicBedrock`, dan `AsyncAnthropicBedrock`.
Untuk mengirim `bedrock-2023-05-31`, teruskan `extra_body={"anthropic_version": "bedrock-2023-05-31"}` pada setiap permintaan.
Ini berlaku untuk `AnthropicVertex` dan `AnthropicBedrock`. Jika Anda mengatur header `anthropic-version` pada klien atau pada permintaan, nilainya masuk ke body.
Untuk mengirim `bedrock-2023-05-31`, atur header `anthropic-version` ke `"bedrock-2023-05-31"` pada klien atau pada permintaan.
Ini berlaku untuk `AnthropicVertexClient` dan `AnthropicBedrockClient`. Jika Anda mengatur header `anthropic-version` melalui `ClientOptions.ExtraHeaders`, nilainya masuk ke body.
Untuk mengirim `bedrock-2023-05-31`, panggil `WithOptions` pada klien dan atur `anthropic-version` ke `bedrock-2023-05-31` di `ClientOptions.ExtraHeaders`.
Ini berlaku untuk paket `vertex` dan `bedrock`. Jika Anda mengatur header `anthropic-version` dengan `option.WithHeader`, nilainya masuk ke body. `vertex.DefaultVersion` dan `bedrock.DefaultVersion` dihapus.
Untuk mengirim `bedrock-2023-05-31`, teruskan `option.WithHeader("anthropic-version", "bedrock-2023-05-31")` ke klien atau ke permintaan.
Ini berlaku untuk `VertexBackend` dan `BedrockBackend`. Jika Anda mengatur header `anthropic-version` pada klien atau pada permintaan, nilainya masuk ke body.
Untuk mengirim `bedrock-2023-05-31`, atur header `anthropic-version` ke `bedrock-2023-05-31` pada klien atau pada permintaan.
Ini berlaku untuk `Anthropic\Vertex\Client` dan `Anthropic\Bedrock\Client`.
Untuk mengirim `bedrock-2023-05-31`, teruskan `'extraBodyParams' => ['anthropic_version' => 'bedrock-2023-05-31']` di `requestOptions`.
Ini berlaku untuk `Anthropic::VertexClient` dan `Anthropic::BedrockClient`. Jika Anda mengatur header `anthropic-version` melalui `extra_headers`, nilainya masuk ke body. `Anthropic::VertexClient::DEFAULT_VERSION` dan `Anthropic::BedrockClient::DEFAULT_VERSION` dihapus.
Untuk mengirim `bedrock-2023-05-31`, teruskan `extra_headers: {"anthropic-version" => "bedrock-2023-05-31"}` di `request_options`.
### `MessageParam` adalah union dengan satu tipe per peran
Pada versi sebelumnya, `MessageParam` adalah satu tipe untuk setiap peran. Setiap peran sekarang memiliki tipenya sendiri: `UserMessageParam`, `AssistantMessageParam`, dan `SystemMessageParam`. `BetaMessageParam` dipecah dengan cara yang sama, menjadi `BetaUserMessageParam`, `BetaAssistantMessageParam`, dan `BetaSystemMessageParam`. Permintaan yang dikirim SDK memiliki field dan nilai yang sama seperti sebelumnya.
Pesan yang ditulis sebagai literal dict, seperti `{"role": "user", "content": "Hello"}`, tidak memerlukan perubahan.
Di v1, `anthropic.types.MessageParam` adalah satu `TypedDict`. Di v2, ini adalah union dari ketiga tipe, dan `anthropic.types.beta.BetaMessageParam` adalah union dari ketiga tipenya. Kedua nama tersebut masih berfungsi dalam anotasi, seperti `list[MessageParam]`.
Memanggil salah satu nama tersebut sekarang memunculkan `TypeError`, dan type checker menandainya. Tulis pesan sebagai dict:
```python
# Sebelum
message = MessageParam(role="user", content="Hello")
# Sesudah
message: MessageParam = {"role": "user", "content": "Hello"}
```
Membuat subclass dari salah satu nama tersebut juga memunculkan `TypeError`. Buat subclass dari tipe untuk peran tersebut, seperti `UserMessageParam`.
Perubahan lainnya hanya memengaruhi pemeriksaan tipe. Dict yang `role`-nya berupa variabel yang dapat menampung lebih dari satu peran tidak cocok dengan tipe mana pun dalam union, jadi buat dict untuk satu peran pada satu waktu:
```python
# Sebelum
def to_message(role: Literal["user", "assistant"], text: str) -> MessageParam:
return {"role": role, "content": text}
# Sesudah
def to_message(role: Literal["user", "assistant"], text: str) -> MessageParam:
if role == "user":
return {"role": "user", "content": text}
return {"role": "assistant", "content": text}
```
Dua perubahan lagi hanya berlaku untuk `BetaMessageParam`:
* `clear_at` dan `output_config` adalah key dari `BetaSystemMessageParam`, sehingga pesan user atau assistant tidak dapat memilikinya.
* `content` bersifat opsional di `BetaSystemMessageParam`, sehingga pyright melaporkan `message["content"]`. Bacalah dengan `message.get("content")`, atau periksa terlebih dahulu bahwa `message["role"]` bukan `"system"`.
`MessageParam` dulunya adalah satu interface. Sekarang menjadi `UserMessageParam | AssistantMessageParam | SystemMessageParam`, dan `BetaMessageParam` adalah union yang sama dari ketiga tipenya. Hanya tipenya yang berubah. Literal pesan yang menyebutkan perannya, seperti `{ role: "user", content: "Hello, Claude" }`, lolos pemeriksaan tipe seperti sebelumnya, sehingga sebagian besar kode tidak memerlukan perubahan.
Tipe system berbeda dari dua tipe lainnya. `content`-nya berupa string atau blok teks, ditambah blok `tool_addition` dan `tool_removal` di `beta`, sehingga blok gambar di sana tidak lagi dapat dikompilasi. Di `beta`, hanya tipe ini yang memiliki `clear_at` dan `output_config`, dan `content`-nya bersifat opsional.
Kode yang menangani pesan dengan peran apa pun harus memeriksa `role` sebelum mengganti atau menambahkan blok konten, dan sebelum membaca `clear_at` atau `output_config`:
```typescript
// Sebelum
const copy: Anthropic.MessageParam = { ...message, content: blocks };
// Sesudah
const copy: Anthropic.MessageParam =
message.role === "system" ? message : { ...message, content: blocks };
```
`content` dari `BetaMessageParam` dapat bernilai `undefined`:
```typescript
// Sebelum
const types =
typeof message.content === "string" ? [] : message.content.map((block) => block.type);
// Sesudah
const types = Array.isArray(message.content) ? message.content.map((block) => block.type) : [];
```
Tipe `BetaMessageParam["content"]` juga mencakup `undefined`. Untuk konten pesan user atau assistant, gunakan `BetaMessageContentParam`.
Interface tidak dapat meng-extend union, dan class tidak dapat mengimplementasikannya. Gunakan type alias, atau sebutkan tipe dari satu peran sebagai gantinya.
```typescript
// Sebelum
interface StoredMessage extends Anthropic.MessageParam {
id: string;
}
// Sesudah
type StoredMessage = Anthropic.MessageParam & { id: string };
```
Di v12, `MessageParam` dan `BetaMessageParam` adalah class yang `Role` dan `Content`-nya Anda atur. Di v13, masing-masing adalah union dari tiga class untuk perannya, dan enum `Role` di `Anthropic.Models.Messages` dan `Anthropic.Models.Beta.Messages` telah dihapus.
Saat Anda membuat pesan, sebutkan class untuk perannya dan hapus `Role`. Setiap class dikonversi ke union secara implisit:
```csharp
// Sebelum
Messages = [new() { Role = Role.User, Content = "Hello, Claude" }],
// Sesudah
Messages = [new UserMessageParam { Content = "Hello, Claude" }],
```
`new UserMessageParam("Hello, Claude")` juga berfungsi.
Class yang menampung `Content` juga berubah:
* `MessageParamContent` sekarang menjadi `MessageContentParam`, dan `BetaMessageParamContent` sekarang menjadi `BetaMessageContentParam`.
* Pesan system memiliki class kontennya sendiri. `SystemMessageParamContent` menampung string atau list `TextBlockParam`, dan `BetaSystemMessageParamContent` menampung string atau list `SystemMessageContentBlock`. `List` atau `List` tidak lagi dikonversi ke class tersebut.
* `ClearAt` dan `OutputConfig` hanya ada di `BetaSystemMessageParam`.
Saat Anda membaca pesan, union masih memiliki `Role` dan `Content`, tetapi Anda tidak dapat mengaturnya, sehingga ekspresi `with` diterapkan pada class untuk peran tersebut. `Role` sekarang menampung `MessageParamRole` atau `BetaMessageParamRole`. `BetaMessageParam.Content` dapat bernilai `null`, karena `Content` bersifat opsional di `BetaSystemMessageParam`.
```csharp
// Sebelum
if (message.Role.Value() == Role.Assistant) { }
// Sesudah
if (message.Role.Value() == MessageParamRole.Assistant) { }
```
`TryPickUser`, `TryPickAssistant`, `TryPickSystem`, `Switch`, dan `Match` memberi Anda class untuk peran tersebut.
Di v1, `MessageParam` adalah satu struct dengan field `Role` dan `Content`. Di v2, ini adalah union: `OfUser` menampung `*UserMessageParam`, `OfAssistant` menampung `*AssistantMessageParam`, dan `OfSystem` menampung `*SystemMessageParam`. `BetaMessageParam` berubah dengan cara yang sama. SDK mengirim JSON yang sama seperti sebelumnya, kecuali urutan key dalam pesan system beta.
`NewUserMessage`, `NewAssistantMessage`, `NewBetaUserMessage`, dan metode `ToParam` dari `Message` dan `BetaMessage` berfungsi seperti sebelumnya, sehingga kode yang membuat pesannya dengan fungsi-fungsi tersebut tidak memerlukan perubahan.
Literal struct menyebutkan tipe untuk perannya. Jangan sertakan `Role`, karena setiap tipe melakukan marshal perannya sendiri:
```go
// Sebelum
anthropic.MessageParam{
Role: anthropic.MessageParamRoleAssistant,
Content: blocks,
}
// Sesudah
anthropic.MessageParam{OfAssistant: &anthropic.AssistantMessageParam{
Content: blocks,
}}
```
Kode yang membaca pesan memeriksa field mana yang diatur:
```go
// Sebelum
if message.Role == anthropic.MessageParamRoleUser {
blocks = message.Content
}
// Sesudah
if message.OfUser != nil {
blocks = message.OfUser.Content
}
```
* Tipe `MessageParamRole` dan `BetaMessageParamRole` beserta konstantanya telah dihapus. `message.GetRole()` mengembalikan pointer ke peran sebagai `string`, atau `nil` jika tidak ada field yang diatur.
* `ClearAt` dan `OutputConfig` dipindahkan dari `BetaMessageParam` ke `BetaSystemMessageParam`. Nama tipe `BetaMessageParamClearAt` dan konstantanya sekarang diawali dengan `BetaSystemMessageParamClearAt`.
* `SystemMessageParam.Content` adalah `[]TextBlockParam`. `BetaSystemMessageParam.Content` adalah `[]BetaSystemMessageParamContentUnion`, yang menampung blok `text`, `tool_addition`, dan `tool_removal`. `NewBetaSystemMessage` menerima blok dengan tipe tersebut, sehingga `anthropic.NewBetaTextBlock("Be brief.")` menjadi `anthropic.BetaSystemMessageParamContentUnion{OfText: &anthropic.BetaTextBlockParam{Text: "Be brief."}}`.
* Salinan `MessageParam` menunjuk ke pesan yang sama dengan aslinya. Mengatur `duplicate.OfUser.Content` mengubah keduanya, sedangkan mengatur `duplicate.Content` di v1 hanya mengubah salinannya.
* `mcp.ToMessage` mengembalikan `*mcp.UnsupportedValueError` untuk peran selain `user` atau `assistant`. v1 menyalin peran apa pun ke dalam pesan.
Di v2, `MessageParam` adalah satu class dengan `role` dan `content`. Di v3, ini adalah union dari ketiga class, dan `MessageParam.Content` sekarang menjadi `MessageContentParam` tingkat atas. `BetaMessageParam` berubah dengan cara yang sama, dan class-class-nya memiliki nama yang sama dengan prefiks `Beta`. JSON yang dikirim SDK sama, kecuali bahwa pesan system beta sekarang memiliki `role` sebelum `content`.
`addUserMessage`, `addAssistantMessage`, dan `addSystemMessage` dengan `String`, `addMessage` dengan `Message` atau `MessageParam`, dan `Message.toParam()` tidak berubah.
`MessageParam.builder()` dan `toBuilder()` telah dihapus. Panggil factory method untuk peran tersebut, yaitu `ofUser`, `ofAssistant`, atau `ofSystem`:
```java
// Sebelum
MessageParam message = MessageParam.builder()
.role(MessageParam.Role.USER)
.content("Hello, Claude")
.build();
// Sesudah
MessageParam message = MessageParam.ofUser("Hello, Claude");
```
Metode yang menerima list blok konten memiliki nama baru pada builder dari `MessageCreateParams`, `StructuredMessageCreateParams`, `MessageCountTokensParams`, dan `BatchCreateParams.Request.Params`:
| v2 | v2 beta | v3 |
| ---------------------------------- | --------------------------------------------- | ----------------------------------------- |
| `addUserMessageOfBlockParams` | `addUserMessageOfBetaContentBlockParams` | `addUserMessageOfContentBlockParams` |
| `addAssistantMessageOfBlockParams` | `addAssistantMessageOfBetaContentBlockParams` | `addAssistantMessageOfContentBlockParams` |
| `addSystemMessageOfBlockParams` | `addSystemMessageOfBetaContentBlockParams` | `addSystemMessageOfBlocks` |
Pada class konten, `BlockParams` (`BetaContentBlockParams` di beta) menjadi `ContentBlockParams` di `ofBlockParams`, `blockParams()`, `isBlockParams()`, `asBlockParams()`, dan `visitBlockParams` milik visitor.
Pesan system memiliki class kontennya sendiri, `SystemMessageParam.Content`, yang sekarang diterima oleh `addSystemMessage`. Bloknya adalah `TextBlockParam`, bukan `ContentBlockParam`. Di beta, bloknya adalah `BetaSystemMessageParam.Content.SystemMessageContentBlock`, yang memiliki `ofText`, `ofToolAddition`, dan `ofToolRemoval`.
```java
// Sebelum
builder.addSystemMessageOfBlockParams(List.of(ContentBlockParam.ofText(textBlock)));
// Sesudah
builder.addSystemMessageOfBlocks(List.of(textBlock));
```
Saat Anda membaca pesan, `role()` tidak berubah. `content()` mengembalikan `MessageContentParam`, atau `Optional` di beta, di mana pesan system dapat tidak memiliki konten. `_role()`, `_content()`, dan `_additionalProperties()` sekarang berada pada class untuk peran tersebut, yang dikembalikan oleh `asUser()`, `asAssistant()`, atau `asSystem()`.
Class-class tersebut berada di `Anthropic\Messages`, dan class beta di `Anthropic\Beta\Messages`. Pesan yang Anda tulis sebagai array tidak berubah, dan tetap memerlukan `'role'`-nya.
`MessageParam::with()` dan `BetaMessageParam::with()` tetap ada, dan mengembalikan class yang sesuai dengan `role`. Panggilan dengan named argument tidak memerlukan perubahan. `role` sekarang menjadi parameter pertama, jadi dalam panggilan posisional tukar `content` dan `role`, atau panggil `with()` pada class peran tersebut, yang tidak menerima `role`. Untuk argumen dalam urutan lama, PHP melempar `UnhandledMatchError`, yang tidak diperingatkan oleh PHPStan, atau `TypeError` jika `content` berupa list atau `role` berupa enum case.
```php
// Sebelum
MessageParam::with('Hello, Claude', 'user');
// Sesudah
UserMessageParam::with('Hello, Claude');
```
Tidak ada objek yang merupakan `MessageParam` lagi: `instanceof MessageParam` bernilai false, dan PHP melempar `TypeError` di mana tipe parameter atau tipe return menyebutkannya. Sebutkan ketiga class tersebut sebagai gantinya:
```php
// Sebelum
function send(MessageParam $message): void {}
// Sesudah
function send(UserMessageParam|AssistantMessageParam|SystemMessageParam $message): void {}
```
* `MessageParam::fromArray()` dan `(new MessageParam)->withContent()` melempar "Call to undefined method". Panggil keduanya pada class peran tersebut, yang mengatur `role` dengan sendirinya.
* `withRole()` sekarang hanya menerima string: PHP melempar `TypeError` untuk case `Role`. Untuk memberikan peran lain pada pesan, buat class dari peran tersebut.
* `clearAt` dan `outputConfig` hanya ada di `BetaSystemMessageParam`, dan `BetaMessageParam::with()` mengabaikannya untuk dua peran lainnya. Enum `BetaMessageParam\ClearAt` sekarang menjadi `BetaSystemMessageParam\ClearAt`.
* `MessageParam\Content` sekarang menjadi `MessageContentParam`, dan `BetaMessageParam\Content` sekarang menjadi `BetaMessageContentParam`. Tipe PHPStan-nya juga menggunakan nama baru: `ContentShape` sekarang menjadi `MessageContentParamShape`.
* Array yang `'role'`-nya berupa case `Role` masih berfungsi, tetapi PHPStan sekarang melaporkannya. Tulis string-nya.
Pesan yang Anda tulis sebagai hash tidak berubah.
Di v2, `Anthropic::MessageParam` adalah union dari `Anthropic::UserMessageParam`, `Anthropic::AssistantMessageParam`, dan `Anthropic::SystemMessageParam`. Dengan cara yang sama, `Anthropic::Beta::BetaMessageParam` adalah union dari ketiga class-nya.
`Anthropic::MessageParam.new(role: :user, content: "Hello, Claude")` masih berfungsi, dan mengembalikan instance dari class untuk peran tersebut. Anda juga dapat membuat class tersebut sendiri, tanpa `role:`, sebagai `Anthropic::UserMessageParam.new(content: "Hello, Claude")`. Empat hal berubah untuk kode yang membuat atau memeriksa instance ini:
* `MessageParam.new` hanya menerima keyword, jadi teruskan hash sebagai `MessageParam.new(**hash)`. Metode ini memunculkan `ArgumentError` ketika `role:` tidak ada atau bukan salah satu dari ketiga peran.
* `message.is_a?(Anthropic::MessageParam)` bernilai `false`. Cabang `when Anthropic::MessageParam` dan `messages.grep(Anthropic::MessageParam)` masih cocok.
* Instance yang dibuat dengan `.new` tidak memiliki `:role` dalam `to_h`-nya, dan `message[:role]` bernilai `nil`. `message.role` masih mengembalikan peran tersebut.
* Hanya `BetaSystemMessageParam` yang memiliki `clear_at` dan `output_config`. Pada pesan user atau assistant, keduanya dulu mengembalikan `nil`, dan sekarang memunculkan `NoMethodError`.
```ruby
# Sebelum
typed = messages.select { _1.is_a?(Anthropic::MessageParam) }
roles = typed.map { _1[:role] }
# Sesudah
typed = messages.grep(Anthropic::MessageParam)
roles = typed.map(&:role)
```
Modul enum `Role` tetap ada. Konstanta-konstanta berikut dipindahkan. Nama yang diawali dengan `Beta` berada di bawah `Anthropic::Beta`, dan yang lainnya berada di bawah `Anthropic`:
| Dihapus | Gunakan sebagai gantinya |
| --------------------------- | ------------------------------------------------------------------------------------ |
| `MessageParam::Content` | `MessageContentParam`, atau `SystemMessageParam::Content` untuk pesan system |
| `BetaMessageParam::Content` | `BetaMessageContentParam`, atau `BetaSystemMessageParam::Content` untuk pesan system |
| `BetaMessageParam::ClearAt` | `BetaSystemMessageParam::ClearAt` |
Jika Anda melakukan pemeriksaan tipe dengan Sorbet, `MessageParam::OrHash` telah dihapus, dan `Anthropic::MessageParam` sebagai tipe tidak lagi menerima instance. Gunakan `Anthropic::MessageParam::Variants` untuk ketiga class, yang masing-masing memiliki `OrHash`-nya sendiri. Di RBS, nilai bertipe `Anthropic::MessageParam` tidak memiliki `role` atau `content`. Gunakan alias `Anthropic::Models::message_param`, yang dulunya merupakan bentuk hash dari pesan dan sekarang merupakan union dari ketiga class. Nama beta-nya adalah `BetaMessageParam::Variants` dan `Anthropic::Models::Beta::beta_message_param`.
### Enum bernilai tunggal menjadi konstanta
Ini memengaruhi SDK C#, Go, Java, PHP, dan Ruby serta satu flag CLI. Pada versi sebelumnya, field wajib yang hanya dapat menampung satu nilai memiliki tipe enum tersendiri dengan satu anggota. Field-field ini sekarang menjadi konstanta, dan tipe enum tersebut telah dihapus. JSON yang dikirim dan dibaca oleh SDK tetap sama.
`--type` bersifat opsional pada `ant beta:sessions:resources add`. `file` adalah satu-satunya nilai yang dapat diambil `--type` di sana, sehingga v2 mengirimkannya untuk Anda. Perintah yang masih meneruskan `--type file` tetap berfungsi, jadi tidak ada yang perlu diubah.
Di v12, properti `required` semacam itu memiliki enum dengan satu anggota, seperti `BetaManagedAgentsTextBlockType.Text`. Hampir semuanya adalah properti `Type` dari sebuah kelas di bawah `Anthropic.Models.Beta`: `Agents`, `DeploymentRuns`, `Deployments`, `Dreams`, `Environments`, `MemoryStores`, `Sessions`, `UserProfiles`, dan `Vaults`. Di v13 properti-properti ini adalah `JsonElement` yang diisi oleh konstruktor, seperti halnya `TextBlockParam.Type` sebelumnya.
Properti opsional, seperti `BetaManagedAgentsGlobToolConfigParams.Type`, tetap mempertahankan enum-nya. Dua dari enum tersebut memiliki nama baru:
| v12 | v13 |
| ------------------------------------------- | ----------------------------------------- |
| `BetaManagedAgentsBashToolConfigParamsType` | `Anthropic.Models.Beta.Agents.Type` |
| `BetaPackagesType` | `Anthropic.Models.Beta.Environments.Type` |
Saat Anda membangun sebuah objek, hapus properti tersebut:
```csharp
// Sebelum
new BetaManagedAgentsTextBlock
{
Type = BetaManagedAgentsTextBlockType.Text,
Text = "Hello Claude!",
};
// Sesudah
new BetaManagedAgentsTextBlock { Text = "Hello Claude!" };
```
Kelas yang tersisa dengan satu properti wajib juga mendapatkan konstruktor yang menerimanya, sehingga `new BetaManagedAgentsTextBlock("Hello Claude!")` juga berfungsi. Kelas yang tidak tersisa properti wajib apa pun dibangun dengan `new BetaManagedAgentsAlwaysAllowPolicy()`.
Saat Anda membacanya, bandingkan dengan string:
```csharp
// Sebelum
if (message.Type.Value() == BetaManagedAgentsAgentMessageEventType.AgentMessage) { }
// Sesudah
if (message.Type.GetString() == "agent.message") { }
```
Untuk membedakan varian-varian dari sebuah union, tetap gunakan metode `TryPick*`, `Switch`, dan `Match`-nya, yang tidak berubah.
Contoh tipe enum semacam itu beserta konstantanya adalah `BetaManagedAgentsTextBlockType` dan `BetaManagedAgentsTextBlockTypeText`. Hampir semuanya adalah field `Type` dari sebuah struct di bawah `client.Beta`: Agents, Deployments, Deployment Runs, Dreams, Environments, Memory Stores, Sessions, User Profiles, dan Vaults. Di v2 field-field ini menggunakan tipe dari paket `shared/constant`, seperti halnya `TextBlockParam.Type` sebelumnya. Field opsional, seperti `BetaManagedAgentsBashToolConfigParams.Type`, tetap mempertahankan enum-nya.
Dalam request, hapus field tersebut. Field itu di-marshal sebagai satu-satunya nilainya ketika Anda menghilangkannya:
```go
// Sebelum
anthropic.BetaManagedAgentsTextBlockParam{
Type: anthropic.BetaManagedAgentsTextBlockTypeText,
Text: "Hello Claude!",
}
// Sesudah
anthropic.BetaManagedAgentsTextBlockParam{
Text: "Hello Claude!",
}
```
Struct yang satu-satunya field-nya adalah `Type` tersebut sekarang memiliki konstruktor, seperti `NewBetaManagedAgentsAlwaysAllowPolicyParam()`. Sebagai anggota union, pointer ke struct kosong juga berfungsi: `OfAlwaysAllow: &anthropic.BetaManagedAgentsAlwaysAllowPolicyParam{}`.
Dalam response, bandingkan dengan string:
```go
// Sebelum
switch event.Type {
case string(anthropic.BetaManagedAgentsAgentMessageEventTypeAgentMessage):
}
// Sesudah
switch event.Type {
case "agent.message":
}
```
Variabel, field, atau parameter milik Anda yang dideklarasikan dengan salah satu tipe yang dihapus mengambil tipe baru dari field tersebut, seperti `constant.AgentMessage`. `constant.ValueOf[constant.AgentMessage]()` mengembalikan nilainya.
Konstruktor union berubah seiring dengan field-field tersebut. Lima konstruktor berikut kehilangan argumen `type_`-nya:
* `BetaManagedAgentsEventParamsOfUserToolConfirmation`
* `BetaManagedAgentsEventParamsOfUserDefineOutcome`
* `BetaManagedAgentsDeploymentInitialEventParamsOfUserDefineOutcome`
* `BetaManagedAgentsMultiagentRosterEntryParamsOfBetaManagedAgentsAgents`
* `BetaManagedAgentsMultiagentRosterEntryParamsOfBetaManagedAgentsAdvisors`
Empat konstruktor berikut tidak menerima argumen lain, sehingga telah dihapus. Atur field union ke pointer ke struct kosong, seperti `BetaManagedAgentsEventParamsUnion{OfUserInterrupt: &anthropic.BetaManagedAgentsUserInterruptEventParams{}}`:
* `BetaManagedAgentsEventParamsOfUserInterrupt`
* `BetaManagedAgentsMultiagentRosterEntryParamsOfBetaManagedAgentsMultiagentSelfs`
* `BetaManagedAgentsCredentialNetworkingParamsOfUnrestricted`
* `BetaOutputBehaviorParamOfCreateNew`
Contoh enum semacam itu adalah kelas bersarang `BetaManagedAgentsTextBlock.Type`, dengan satu anggotanya `TEXT`. Hampir semuanya adalah `type` dari sebuah kelas di bawah `com.anthropic.models.beta`: `agents`, `deploymentruns`, `deployments`, `dreams`, `environments`, `memorystores`, `sessions`, `userprofiles`, dan `vaults`. Di v3 field-field ini adalah `JsonValue` yang diisi oleh builder, seperti halnya milik `TextBlockParam` sebelumnya. Field opsional, seperti `type` dari `BetaManagedAgentsBashToolConfigParams`, tetap mempertahankan enum-nya.
Saat Anda membangun sebuah objek, hapus pemanggilan tersebut:
```java
// Sebelum
BetaManagedAgentsTextBlock block = BetaManagedAgentsTextBlock.builder()
.type(BetaManagedAgentsTextBlock.Type.TEXT)
.text("Hello Claude!")
.build();
// Sesudah
BetaManagedAgentsTextBlock block = BetaManagedAgentsTextBlock.builder()
.text("Hello Claude!")
.build();
```
Kelas yang tersisa dengan satu field wajib juga mendapatkan factory method yang menerimanya, sehingga `BetaManagedAgentsTextBlock.of("Hello Claude!")` juga berfungsi. Kelas yang tidak tersisa field wajib apa pun kehilangan `of(type)`, dan union-nya kehilangan overload yang menerima enum, seperti `ofAlwaysAllow(type)`. Bangun kelas tersebut dengan `BetaManagedAgentsAlwaysAllowPolicy.builder().build()`.
Saat Anda membacanya, `type()` telah dihapus dan `_type()` mengembalikan `com.anthropic.core.JsonValue`:
```java
// Sebelum
if (message.type().equals(BetaManagedAgentsAgentMessageEvent.Type.AGENT_MESSAGE)) {}
// Sesudah
if (message._type().equals(JsonValue.from("agent.message"))) {}
```
Untuk membedakan varian-varian dari sebuah union, tetap gunakan metode `is*()` dan `as*()` serta visitor-nya, yang tidak berubah.
Contoh case enum semacam itu adalah `Anthropic\Beta\Sessions\Events\ManagedAgentsTextBlock\Type::TEXT`. Hampir semuanya adalah `type` dari sebuah kelas Managed Agents di bawah `Anthropic\Beta`. Properti-properti ini sekarang berupa string dengan satu nilai tersebut sebagai default-nya, seperti halnya `type` dari `Anthropic\Messages\TextBlockParam` sebelumnya. Properti opsional, seperti `type` dari `Anthropic\Beta\Environments\BetaPackages`, tetap mempertahankan enum-nya.
`with()` tidak lagi menerima `type`. Hapus argumen tersebut: PHP melempar "Unknown named parameter" untuk `type:` yang tersisa, dan dalam pemanggilan posisional, argumen-argumen setelahnya bergeser maju satu posisi.
```php
// Sebelum
ManagedAgentsTextBlock::with(text: 'Hello Claude!', type: Type::TEXT);
// Sesudah
ManagedAgentsTextBlock::with(text: 'Hello Claude!');
```
Di tempat Anda membandingkan dengan case enum, bandingkan dengan string:
```php
// Sebelum
$event->type === Type::AGENT_MESSAGE->value;
// Sesudah
$event->type === 'agent.message';
```
* `withType()` dan argumen `type` dari `$client->beta->sessions->resources->add()` sekarang hanya menerima string. Di `add()` nilai default-nya adalah `'file'`, sehingga Anda dapat menghilangkannya.
* Request yang Anda tulis sebagai array tidak berubah, dan tetap memerlukan `'type'`-nya.
Contoh konstanta enum semacam itu adalah `Anthropic::Beta::Sessions::BetaManagedAgentsTextBlock::Type::TEXT`. Hampir semuanya adalah `type` dari sebuah kelas Managed Agents di bawah `Anthropic::Beta`. Di v2 field-field ini dideklarasikan sebagai konstanta, seperti halnya `type` dari `Anthropic::TextBlockParam` sebelumnya. Field opsional, seperti `type` dari `Anthropic::Beta::BetaManagedAgentsGlobToolConfigParams`, tetap mempertahankan enum-nya.
Ganti konstanta yang dihapus dengan symbol-nya:
```ruby
# Sebelum
event.type == Anthropic::Beta::Sessions::BetaManagedAgentsAgentMessageEvent::Type::AGENT_MESSAGE
# Sesudah
event.type == :"agent.message"
```
Request yang Anda tulis sebagai hash tidak berubah, dan tetap memerlukan `type`-nya:
```ruby
client.beta.sessions.events.send_(
session.id,
events: [{type: "user.message", content: [{type: "text", text: "Hello Claude!"}]}]
)
```
Saat Anda membangun instance model, `type:` sekarang memiliki nilai default, sehingga Anda dapat menghilangkannya: `Anthropic::Beta::Sessions::BetaManagedAgentsTextBlock.new(text: "Hello Claude!")`. Hal yang sama berlaku untuk keyword `type:` dari `client.beta.sessions.resources.add`.
Jika Anda melakukan type-check dengan Sorbet, alias `Type::OrSymbol` dan `Type::TaggedSymbol` dari modul-modul ini ikut dihapus, dan field-field tersebut berupa `Symbol`. `OrSymbol` juga mengizinkan `String`, sehingga `.new(type: "text")` tidak lagi lolos type-check. Hapus keyword tersebut atau teruskan `:text`. Di RBS, alias `type_` dari setiap kelas telah dihapus, dan field tersebut berupa literal, seperti `:text`.
### Compaction sisi klien dihapus dari tool runner
Ini memengaruhi SDK TypeScript dan Ruby. "Client-side compaction" (pemadatan sisi klien) di tool runner telah dihapus dan digantikan oleh compaction sisi server, yang merangkum percakapan di dalam API alih-alih dengan request tambahan dari klien.
Opsi `compactionControl` dan modul `@anthropic-ai/sdk/lib/tools/CompactionControl` telah dihapus. Opsi tersebut berhenti berfungsi di v0.129.0, di mana meneruskannya akan melempar `AnthropicError`. Opsi tersebut tidak ada di tipe params, sehingga TypeScript melaporkannya sebagai properti yang tidak dikenal.
Untuk tetap melakukan compaction secara otomatis pada ambang batas token:
```typescript
// Sebelum
const runner = client.beta.messages.toolRunner({
// ...
compactionControl: { enabled: true, contextTokenThreshold: 100_000 }
});
// Sesudah
const runner = client.beta.messages.toolRunner({
// ...
betas: ["compact-2026-01-12"],
context_management: {
edits: [{ type: "compact_20260112", trigger: { type: "input_tokens", value: 100_000 } }]
}
});
```
Untuk memutuskan sendiri kapan percakapan dipadatkan, panggil [`runner.compactBeforeNextTurn()`](https://github.com/anthropics/anthropic-sdk-typescript/blob/main/helpers.md#compaction).
Opsi `compaction_control:` telah dihapus. Opsi tersebut berhenti berfungsi di v1.74.0, di mana meneruskannya akan memunculkan `ArgumentError`.
Untuk tetap melakukan compaction secara otomatis pada ambang batas token:
```ruby
# Sebelum
runner = client.beta.messages.tool_runner(
# ...
compaction_control: {enabled: true, context_token_threshold: 100_000}
)
# Sesudah
runner = client.beta.messages.tool_runner(
# ...
betas: ["compact-2026-01-12"],
context_management: {
edits: [{type: :compact_20260112, trigger: {type: :input_tokens, value: 100_000}}]
}
)
```
Untuk memutuskan sendiri kapan percakapan dipadatkan, panggil [`#compact_before_next_turn`](https://github.com/anthropics/anthropic-sdk-ruby/blob/main/helpers.md#compact_before_next_turn---compact-the-conversation) pada runner.
Ambang batas pemicu harus setidaknya 50.000 token. Lihat [compaction](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold) untuk opsi lainnya (`pause_after_compaction`, `instructions` kustom).
### Text Completions dihapus
Text Completions API lama dihapus dari SDK TypeScript, Go, Java, dan Ruby serta dari CLI. Model dan fitur yang lebih baru tidak mendukungnya. Gunakan [Messages API](https://platform.claude.com/docs/id/api/messages) sebagai gantinya.
Perintah `ant completions create` telah dihapus.
```bash
# Sebelum
ant completions create \
--model "$MODEL" \
--max-tokens-to-sample 1024 \
--prompt $'\n\nHuman: Hello, Claude\n\nAssistant:'
# Sesudah
ant messages create \
--model "$MODEL" \
--max-tokens 1024 \
--message '{role: user, content: "Hello, Claude"}'
```
Teks balasan berpindah dari field `completion` ke `content.0.text`, sehingga skrip yang meneruskan `--transform completion` kini meneruskan `--transform content.0.text` sebagai gantinya.
`ant messages create` juga menerima `--stream`, tetapi event-nya memiliki bentuk yang berbeda: teks tiba di `delta.text` dari event `content_block_delta`, sehingga `--transform content.0.text` tidak berlaku untuk stream.
`client.completions` telah dihapus, bersama dengan kelas resource `Completions` dan tipe `Completion`, `CompletionCreateParams`, `CompletionCreateParamsNonStreaming`, dan `CompletionCreateParamsStreaming`. `AnthropicBedrock` juga tidak lagi memiliki properti `completions`. Konstanta `HUMAN_PROMPT` dan `AI_PROMPT`, yang hanya digunakan oleh prompt Text Completions, juga telah dihapus, baik sebagai export maupun sebagai properti statis dari klien.
```typescript
// Sebelum
const completion = await client.completions.create({
model,
max_tokens_to_sample: 1024,
prompt: "\n\nHuman: Hello, Claude\n\nAssistant:"
});
console.log(completion.completion);
// Sesudah
const message = await client.messages.create({
model,
max_tokens: 1024,
messages: [{ role: "user", content: "Hello, Claude" }]
});
console.log(message.content);
```
`client.completions.create({ ..., stream: true })` menjadi `client.messages.create({ ..., stream: true })` atau `client.messages.stream({ ... })`.
`client.Completions` telah dihapus, bersama dengan `CompletionService`, `NewCompletionService`, `CompletionNewParams`, dan `Completion`. `aws.Client` juga tidak lagi memiliki field `Completions`. `bedrock.DefaultEndpoints` tidak lagi mencantumkan `/v1/complete`.
```go
// Sebelum
completion, err := client.Completions.New(ctx, anthropic.CompletionNewParams{
Model: model,
MaxTokensToSample: 1024,
Prompt: "\n\nHuman: Hello, Claude\n\nAssistant:",
})
fmt.Println(completion.Completion)
// Sesudah
message, err := client.Messages.New(ctx, anthropic.MessageNewParams{
Model: model,
MaxTokens: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")),
},
})
fmt.Println(message.Content[0].Text)
```
`client.Completions.NewStreaming` menjadi `client.Messages.NewStreaming`.
`client.completions()` telah dihapus dari `AnthropicClient` dan `AnthropicClientAsync`, bersama dengan `CompletionService`, `CompletionServiceAsync`, dan paket `com.anthropic.models.completions` (`CompletionCreateParams` dan `Completion`).
```java
// Sebelum
CompletionCreateParams params = CompletionCreateParams.builder()
.model(model)
.maxTokensToSample(1024)
.prompt("\n\nHuman: Hello, Claude\n\nAssistant:")
.build();
System.out.println(client.completions().create(params).completion());
// Sesudah
MessageCreateParams params = MessageCreateParams.builder()
.model(model)
.maxTokens(1024)
.addUserMessage("Hello, Claude")
.build();
client.messages().create(params).content().stream()
.flatMap(contentBlock -> contentBlock.text().stream())
.forEach(textBlock -> System.out.println(textBlock.text()));
```
`client.completions().createStreaming` menjadi `client.messages().createStreaming`.
`client.completions` telah dihapus, bersama dengan `Anthropic::Resources::Completions`, `Anthropic::CompletionCreateParams`, dan `Anthropic::Completion`. `Anthropic::BedrockClient` juga tidak lagi memiliki reader `completions`. Pada `Anthropic::BedrockMantleClient` dan `Anthropic::GoogleCloudClient`, di mana `completions` memunculkan `NotImplementedError`, metode tersebut tidak lagi ada.
```ruby
# Sebelum
completion = client.completions.create(
model: model,
max_tokens_to_sample: 1024,
prompt: "\n\nHuman: Hello, Claude\n\nAssistant:"
)
puts(completion.completion)
# Sesudah
message = client.messages.create(
model: model,
max_tokens: 1024,
messages: [{role: "user", content: "Hello, Claude"}]
)
puts(message.content)
```
`client.completions.create_streaming` menjadi `client.messages.stream`.
### `betas` dihapus dari metode Models non-beta
Metode Models non-beta tidak lagi menerima `betas` (csharp, go: `Betas`; java: `.addBeta()`), dan perintah `ant models` tidak lagi menerima `--beta`. Untuk mengirim header beta, panggil metode yang sama pada `client.beta.models` (csharp, go: `client.Beta.Models`; java: `client.beta().models()`; php: `$client->beta->models`), atau `ant beta:models` di CLI. Di SDK, metode-metode tersebut mengembalikan `BetaModelInfo` (ruby: `Anthropic::Beta::BetaModelInfo`) sedangkan metode non-beta mengembalikan `ModelInfo` (ruby: `Anthropic::ModelInfo`).
```bash
# Sebelum
ant models list --beta "$BETA"
# Sesudah
ant beta:models list --beta "$BETA"
```
`client.models.retrieve()` dan `client.models.list()` tidak lagi menerima `betas` (meneruskannya menghasilkan `TypeError`, dan type checker akan menandainya), dan `anthropic.types.ModelListParams` tidak lagi memiliki key `betas`.
```python
# Sebelum
page = client.models.list(betas=[beta])
# Sesudah
page = client.beta.models.list(betas=[beta])
```
`Anthropic.ModelRetrieveParams` dan `Anthropic.ModelListParams` tidak lagi memiliki properti `betas`.
```typescript
// Sebelum
const page = await client.models.list({ betas: [beta] });
// Sesudah
const page = await client.beta.models.list({ betas: [beta] });
```
`ModelRetrieveParams` dan `ModelListParams` di `Anthropic.Models.Models` tidak lagi memiliki properti `Betas`. Metode pada `client.Beta.Models` menerima kelas dengan nama yang sama di `Anthropic.Models.Beta.Models`.
```csharp
// Sebelum
using Anthropic.Models.Models;
var page = await client.Models.List(new ModelListParams { Betas = [beta] });
// Sesudah
using Anthropic.Models.Beta.Models;
var page = await client.Beta.Models.List(new ModelListParams { Betas = [beta] });
```
`ModelGetParams` dan `ModelListParams` tidak lagi memiliki field `Betas`.
```go
// Sebelum
page, err := client.Models.List(ctx, anthropic.ModelListParams{
Betas: []anthropic.AnthropicBeta{beta},
})
// Sesudah
page, err := client.Beta.Models.List(ctx, anthropic.BetaModelListParams{
Betas: []anthropic.AnthropicBeta{beta},
})
```
`ModelRetrieveParams` dan `ModelListParams` di `com.anthropic.models.models` tidak lagi memiliki `betas()`, dan builder-nya tidak lagi memiliki `betas` dan `addBeta`. Metode pada `client.beta().models()` menerima kelas dengan nama yang sama di `com.anthropic.models.beta.models`.
```java
// Sebelum
import com.anthropic.models.models.ModelListPage;
import com.anthropic.models.models.ModelListParams;
ModelListPage page = client.models().list(ModelListParams.builder().addBeta(beta).build());
// Sesudah
import com.anthropic.models.beta.models.ModelListPage;
import com.anthropic.models.beta.models.ModelListParams;
ModelListPage page = client.beta().models().list(ModelListParams.builder().addBeta(beta).build());
```
`$client->models->retrieve()` dan `$client->models->list()` tidak lagi menerima `betas` (meneruskannya akan melempar `Error: Unknown named parameter $betas`), dan `Anthropic\Models\ModelRetrieveParams` serta `Anthropic\Models\ModelListParams` tidak lagi memiliki properti `betas`.
```php
// Sebelum
$page = $client->models->list(betas: [$beta]);
// Sesudah
$page = $client->beta->models->list(betas: [$beta]);
```
Jika Anda meneruskan argumen berdasarkan posisi, `workspaceID` dan `requestOptions` masing-masing bergeser maju satu posisi di kedua metode.
`client.models.retrieve` dan `client.models.list` tidak lagi menerima `betas:`, dan `Anthropic::ModelRetrieveParams` serta `Anthropic::ModelListParams` tidak lagi memiliki field `betas`.
```ruby
# Sebelum
page = client.models.list(betas: [beta])
# Sesudah
page = client.beta.models.list(betas: [beta])
```
Meneruskan `betas:` ke `client.models` tidak memunculkan error, tetapi tidak lagi mengatur header `anthropic-beta`.
### Kunci API dikirim sebagai `Authorization: Bearer`
SDK dan CLI mengirim kunci API Anda sebagai `Authorization: Bearer ` alih-alih di header `X-Api-Key`, jadi ubah proxy atau gateway apa pun yang membaca atau mengatur `X-Api-Key` agar menggunakan `Authorization`, atau [kirim sendiri kunci tersebut di `X-Api-Key`](https://platform.claude.com/docs/id/api/migration-2026-10-21#sdk-proxy-x-api-key). Claude API menerima kunci di salah satu header tersebut, sehingga program yang berkomunikasi langsung dengan API tidak memerlukan perubahan.
```text wrap
# Before
X-Api-Key:
# After
Authorization: Bearer
```
Ini berlaku untuk kunci di `ANTHROPIC_API_KEY` dan kunci yang di-pipe ke `--api-key-stdin`.
Dengan `--debug`, log request sekarang menampilkan `Authorization: Bearer ` di tempat sebelumnya menampilkan `X-Api-Key: `.
`Authorization` adalah header yang sudah digunakan oleh `auth_token`.
Ini berlaku untuk argumen `api_key` dan variabel lingkungan `ANTHROPIC_API_KEY` dari `Anthropic` dan `AsyncAnthropic`, serta untuk `api_key` dan `ANTHROPIC_AWS_API_KEY` dari `AnthropicAWS`. `AnthropicFoundry` masih mengirim kuncinya sebagai `x-api-key`, dan `AnthropicBedrockMantle` sudah mengirim bearer token sebelumnya.
`Authorization` adalah header yang sudah digunakan oleh opsi `authToken`.
Ini berlaku untuk opsi `apiKey`, variabel lingkungan `ANTHROPIC_API_KEY`, serta `apiKey` dan `ANTHROPIC_AWS_API_KEY` di `@anthropic-ai/aws-sdk`. `apiKey` di `@anthropic-ai/foundry-sdk` masih dikirim sebagai `X-Api-Key`, dan `apiKey` di `@anthropic-ai/bedrock-sdk` sudah berupa bearer token sebelumnya.
Middleware atau `fetch` kustom yang membaca kunci dari header request `x-api-key` perlu membaca `authorization` sebagai gantinya, di mana kunci mengikuti `Bearer `.
`Authorization` adalah header yang sudah digunakan oleh `AuthToken`.
Ini berlaku untuk `ApiKey` pada `AnthropicClient` dan `ClientOptions` serta untuk variabel lingkungan `ANTHROPIC_API_KEY`. Pada rilis `Anthropic.Aws` yang bergantung pada v13, ini juga berlaku untuk `ApiKey` di `AwsClientOptions` dan untuk `ANTHROPIC_AWS_API_KEY`. `AnthropicFoundryApiKeyCredentials` masih mengirim kuncinya sebagai `x-api-key`, dan `ApiKey` di `MantleAwsClientOptions` sudah berupa bearer token sebelumnya.
Ini berlaku untuk `option.WithAPIKey`, variabel lingkungan `ANTHROPIC_API_KEY`, dan `APIKey` di `aws.ClientConfig` (atau `ANTHROPIC_AWS_API_KEY`). `APIKey` di `foundry.ClientConfig` (atau `ANTHROPIC_FOUNDRY_API_KEY`) masih dikirim sebagai `X-Api-Key`, dan `APIKey` di `bedrock.MantleClientConfig` sudah berupa bearer token sebelumnya.
`Authorization` adalah header yang sudah digunakan oleh `authToken`.
Ini berlaku untuk `apiKey` pada builder `AnthropicOkHttpClient`, `AnthropicOkHttpClientAsync`, dan `AnthropicBackend`, variabel lingkungan `ANTHROPIC_API_KEY`, dan system property `anthropic.apiKey`. `apiKey` pada builder `FoundryBackend` masih dikirim sebagai `x-api-key`. `apiKey` pada builder `AwsBackend`, `BedrockBackend`, dan `BedrockMantleBackend` sudah berupa bearer token sebelumnya.
Interceptor sekarang melihat kunci di `Authorization` alih-alih `X-Api-Key`.
`Authorization` adalah header yang sudah digunakan oleh `authToken`.
Ini berlaku untuk argumen `apiKey` dan variabel lingkungan `ANTHROPIC_API_KEY` dari `Anthropic\Client`, serta untuk `apiKey` dan `ANTHROPIC_AWS_API_KEY` dari `Anthropic\Aws\Client`. `Anthropic\Foundry\Client` masih mengirim kuncinya sebagai `x-api-key`, dan `Anthropic\Bedrock\MantleClient` sudah mengirim bearer token sebelumnya.
`Authorization` adalah header yang sudah digunakan oleh `auth_token:`.
Ini berlaku untuk argumen `api_key:` dan variabel lingkungan `ANTHROPIC_API_KEY` dari `Anthropic::Client`, serta untuk `api_key:` dan `ANTHROPIC_AWS_API_KEY` dari `Anthropic::AWSClient`. `Anthropic::BedrockMantleClient` sudah mengirim bearer token sebelumnya.
SDK membuang `Authorization` ketika mengikuti redirect ke origin lain, termasuk redirect dari `http` ke `https` pada host yang sama. Kunci sekarang juga dibuang dalam kasus tersebut.
#### Jika proxy atau gateway membaca `X-Api-Key`
Jika `--base-url` atau `ANTHROPIC_BASE_URL` mengarahkan `ant` ke proxy atau gateway yang membaca `X-Api-Key`, ubah proxy atau gateway tersebut agar membaca kunci dari `Authorization`. `ant` tidak memiliki flag atau variabel lingkungan untuk menambahkan header Anda sendiri, sehingga tidak dapat mengirim `X-Api-Key`.
Pindahkan kembali kunci dengan fungsi `auth` pada klien HTTP. Fungsi ini berjalan pada setiap request yang dikirim klien, termasuk retry:
```python
import httpx2
from anthropic import Anthropic, DefaultHttpxClient
def send_x_api_key(request: httpx2.Request) -> httpx2.Request:
if request.headers.get("Authorization") == f"Bearer {api_key}":
del request.headers["Authorization"]
request.headers["X-Api-Key"] = api_key
return request
client = Anthropic(api_key=api_key, http_client=DefaultHttpxClient(auth=send_x_api_key))
```
`AsyncAnthropic` menerima fungsi yang sama, dalam `http_client=DefaultAsyncHttpxClient(auth=send_x_api_key)`.
Atur header tersebut sendiri. `Authorization: null` juga mencegah kunci dikirim di sana:
```typescript
const client = new Anthropic({
apiKey,
defaultHeaders: { "X-Api-Key": apiKey, Authorization: null }
});
```
Jika proxy menambahkan kredensial dan klien Anda tidak memilikinya, v0 memungkinkan Anda menyatakannya dengan `"X-Api-Key": null` atau `Authorization: null` di `defaultHeaders`. v1 hanya menerima `Authorization: null`.
Poller dan worker environment work diberi kunci mereka sendiri, sehingga mereka tidak menyertakan default header `X-Api-Key` dan `Authorization` dalam request mereka sendiri.
Atur header tersebut sendiri dengan `ExtraHeaders`. Mengatur `ApiKey` dan `AuthToken` ke `null` juga mencegah kredensial yang ditemukan di `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN` dikirim:
```csharp
AnthropicClient client = new(
new ClientOptions
{
ApiKey = null,
AuthToken = null,
ExtraHeaders = new Dictionary { ["X-Api-Key"] = apiKey },
}
);
```
Atur header tersebut sendiri. `option.WithHeaderDel` juga mencegah kunci yang ditemukan di `ANTHROPIC_API_KEY` dikirim:
```go
client := anthropic.NewClient(
option.WithHeader("X-Api-Key", apiKey),
option.WithHeaderDel("Authorization"),
)
```
`environments.WorkPoller` dan `environments.EnvironmentWorker` diberi kunci mereka sendiri, sehingga mereka tidak menyertakan `X-Api-Key` yang diatur secara manual dalam request mereka sendiri.
Atur header tersebut sendiri alih-alih memanggil `apiKey`:
```java
AnthropicClient client = AnthropicOkHttpClient.builder()
.putHeader("X-Api-Key", apiKey)
.build();
```
Pindahkan kembali kunci dengan middleware:
```php
use Anthropic\Client;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;
$sendXApiKey = fn (RequestInterface $request, callable $next): ResponseInterface => $next(
$request->withoutHeader('Authorization')->withHeader('X-Api-Key', $apiKey)
);
$client = new Client(apiKey: $apiKey, requestOptions: ['middleware' => [$sendXApiKey]]);
```
Jangan gunakan `extraHeaders` milik klien untuk ini. Request yang memiliki `extraHeaders` sendiri akan menggantikan milik klien, dan setiap endpoint di bawah `$client->beta` yang memerlukan header beta memilikinya.
Pindahkan kembali kunci dengan middleware:
```ruby
send_x_api_key = lambda do |req, nxt|
next nxt.call(req) unless req.headers["authorization"] == "Bearer #{api_key}"
nxt.call(req.with(headers: {**req.headers.except("authorization"), "x-api-key" => api_key}))
end
client = Anthropic::Client.new(api_key: api_key, middleware: send_x_api_key)
```
Baris pertama membiarkan request apa adanya ketika request tersebut tidak membawa kunci, seperti request yang di-redirect ke origin lain.
`Anthropic::AWSClient` tidak menerima argumen `middleware:`. Teruskan middleware dengan setiap request sebagai gantinya, sebagai `request_options: {middleware: send_x_api_key}`.
#### Jika Anda mengatur atau menghapus `X-Api-Key` pada request
Ini memengaruhi SDK Python, TypeScript, Go, PHP, dan Ruby.
Jika Anda menghapus `X-Api-Key` agar request hanya mengirim auth token, hapus kode tersebut alih-alih mengubahnya, karena menghapus `Authorization` akan menghapus token. [Sebuah klien memegang satu kredensial](https://platform.claude.com/docs/id/api/migration-2026-10-21#sdk-one-credential), jadi pastikan kredensial tersebut adalah token: jika tidak ada yang diteruskan dalam kode dan `ANTHROPIC_API_KEY` serta `ANTHROPIC_AUTH_TOKEN` keduanya diatur, klien menggunakan kunci.
Kode yang meneruskan `extra_headers={"X-Api-Key": omit}` untuk mencegah kunci dikirim pada request tidak lagi melakukannya. Teruskan `extra_headers={"Authorization": omit}` sebagai gantinya.
`extra_headers={"X-Api-Key": other_key}` tidak lagi menggantikan kunci klien: kedua kunci dikirim. Untuk mengirim kunci lain dengan satu request, teruskan `extra_headers={"Authorization": f"Bearer {other_key}"}`.
`headers: { "X-Api-Key": otherKey }` dalam opsi request tidak lagi menggantikan kunci klien: kedua kunci dikirim. Untuk mengirim kunci lain dengan satu request, teruskan ``headers: { Authorization: `Bearer $\{otherKey}` }``.
`option.WithHeaderDel("X-Api-Key")` tidak lagi mencegah kunci dikirim pada request. Hapus `Authorization` sebagai gantinya:
```go
// Sebelum
client.Messages.New(ctx, params, option.WithHeaderDel("X-Api-Key"))
// Sesudah
client.Messages.New(ctx, params, option.WithHeaderDel("Authorization"))
```
`option.WithHeader("X-Api-Key", otherKey)` tidak lagi menggantikan kunci klien: kedua kunci dikirim. Untuk mengirim kunci lain dengan satu request, teruskan `option.WithAPIKey(otherKey)`.
`'extraHeaders' => ['X-Api-Key' => null]` tidak lagi mencegah kunci dikirim pada request. Untuk mengirim request tanpa kredensial, atur `Authorization` ke `null` sebagai gantinya, atau hapus di middleware jika Anda melakukan ini untuk seluruh klien.
`'extraHeaders' => ['X-Api-Key' => $otherKey]` tidak lagi menggantikan kunci klien: kedua kunci dikirim. Untuk mengirim kunci lain dengan satu request, atur `Authorization` ke `"Bearer {$otherKey}"`.
`extra_headers: {"x-api-key" => nil}` tidak lagi mencegah kunci dikirim pada request. Atur `"authorization"` ke `nil` sebagai gantinya. Untuk mengirim kunci lain dengan satu request, atur `"authorization"` ke `"Bearer #{other_key}"`, bukan `"x-api-key"`.
### Klien memegang satu kredensial
Kunci API dan token autentikasi kini berbagi satu header, sehingga klien SDK memegang satu kredensial. Jika tidak ada yang diteruskan dalam kode, klien mengikuti urutan [prioritas kredensial](https://platform.claude.com/docs/id/manage-claude/wif-reference#credential-precedence).
v1 mengirim kunci API dan token autentikasi sekaligus ketika klien memiliki keduanya, masing-masing dalam header-nya sendiri. Kredensial adalah salah satu dari `api_key`, `auth_token`, `credentials`, `config`, atau `profile`.
* **Teruskan paling banyak satu.** Dua atau lebih di konstruktor, atau dalam satu panggilan `copy()` atau `with_options()`, memunculkan `ValueError`. `None` tidak dihitung. v1 memunculkan `TypeError`, dan hanya untuk dua dari `credentials`, `config`, dan `profile`.
* **Yang Anda teruskan adalah satu-satunya.** Seperti di v1, klien tidak mencari kredensial lain di environment atau di disk.
* **Jika tidak ada yang diteruskan, hanya yang pertama dari berikut ini yang disetel yang digunakan:** `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, profil yang dinamai oleh `ANTHROPIC_PROFILE`, variabel "workload identity federation" (federasi identitas beban kerja), profil aktif di disk (yang dinamai oleh file `active_config`, jika tidak maka `default`). Ketika dua yang pertama sama-sama disetel, klien mencatat peringatan satu kali. v1 menggunakan profil aktif sebelum variabel federasi ketika `ANTHROPIC_CONFIG_DIR` disetel atau file `active_config` ada; setel `ANTHROPIC_PROFILE` untuk tetap menggunakannya.
* **`copy()` dan `with_options()` menggantikan.** Kredensial yang Anda teruskan menggantikan kredensial milik klien, apa pun jenis keduanya. Base URL dan header yang berasal dari config atau profil kredensial lama ikut terbuang, dan milik kredensial baru yang digunakan. Base URL yang Anda teruskan tetap dipertahankan.
```python
client = Anthropic(api_key=key, auth_token=token)
# Sebelum: mengirim `X-Api-Key: ` dan `Authorization: Bearer `
# Sesudah: memunculkan `ValueError`
```
Klien platform mempertahankan aturannya sendiri. `AnthropicAWS` menerima `auth_token` di samping `api_key` tanpa error, dan mengirim kuncinya.
Docstring dari `Anthropic.__init__` dan `Anthropic.copy` di [`_client.py`](https://github.com/anthropics/anthropic-sdk-python/blob/main/src/anthropic/_client.py) berisi detailnya.
Jika Anda mengandalkan pengiriman keduanya, misalnya token untuk gateway dan kunci untuk API di belakangnya, teruskan token sebagai `auth_token` dan setel `X-Api-Key` di `default_headers`. Minta gateway menghapus header `Authorization`-nya sebelum meneruskan permintaan. Claude API mengharapkan satu kredensial per permintaan.
Di v0, klien yang memiliki kunci API dan token autentikasi mengirim keduanya, masing-masing dalam header-nya sendiri. Kredensial adalah salah satu dari `apiKey`, `authToken`, `credentials`, `config`, atau `profile`.
* **Teruskan paling banyak satu.** Dua atau lebih di `new Anthropic()`, atau dalam satu panggilan `withOptions()`, melempar `TypeError`. `null` dan `undefined` tidak dihitung.
* **Yang Anda teruskan adalah satu-satunya.** Klien tidak mencari kredensial lain di environment atau di disk.
* **Jika tidak ada yang diteruskan, yang pertama dari berikut ini yang digunakan:** `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, profil yang dinamai oleh `ANTHROPIC_PROFILE`, variabel workload identity federation, profil aktif di disk (yang dinamai oleh file `active_config`, jika tidak maka `default`). Ketika dua yang pertama sama-sama disetel, klien mencatat peringatan satu kali. Di v0, profil aktif didahulukan sebelum variabel federasi. `ANTHROPIC_PROFILE` yang menamai profil yang tidak ada dilewati di v0, dan sekarang permintaan pertama melempar `AnthropicError`. `loadConfig()` tanpa argumen mengikuti urutan yang sama dan melempar error yang sama.
* **`withOptions` menggantikan.** Kredensial yang Anda teruskan menggantikan kredensial milik klien yang Anda salin, sehingga `client.withOptions({ authToken })` tidak lagi memerlukan `apiKey: null` di sampingnya.
* **Klien platform hanya menerima kredensial platformnya.** Klien AWS, Bedrock, dan Foundry serta `AnthropicVertex` melempar `AnthropicError` untuk opsi kredensial yang tidak mereka gunakan untuk autentikasi, seperti yang sudah dilakukan `AnthropicGoogleCloud`. Pada klien AWS dan Bedrock, `apiKey: null` kini menghapus kunci, sehingga klien menandatangani dengan kredensial AWS. `AnthropicBedrock` menyimpan kuncinya di `client.apiKey`, sedangkan v0 menyimpannya di `client.authToken`.
```typescript
// Sebelumnya: mengirim kunci API dan mengabaikan `credentials`
const client = new Anthropic({ apiKey, credentials });
// Sesudahnya: baris di atas melempar TypeError
const client = new Anthropic({ credentials });
```
Komentar dokumentasi pada [`ClientOptions`](https://github.com/anthropics/anthropic-sdk-typescript/blob/main/src/client.ts) menjelaskan perilaku setiap opsi, dan komentar dokumentasi pada konstruktor masing-masing klien platform tersebut mencantumkan opsi yang ditolaknya.
Jika Anda mengandalkan pengiriman keduanya, misalnya token untuk gateway dan kunci untuk API di belakangnya, setel `X-Api-Key` di `defaultHeaders` dan pertahankan `authToken`. Minta gateway menghapus header `Authorization`-nya sebelum meneruskan permintaan. Claude API mengharapkan satu kredensial per permintaan.
Di v12, klien yang memiliki kunci API dan token autentikasi mengirim keduanya, masing-masing dalam header-nya sendiri. Kredensial adalah salah satu dari `ApiKey`, `AuthToken`, atau `ClientOptions.Credentials`.
* **Meneruskan dua adalah error.** Menyetel yang kedua melempar `ArgumentException`. `null` tidak dihitung, jadi untuk menukar kredensial di `ClientOptions` yang Anda buat sendiri, setel yang lama ke `null` terlebih dahulu.
* **Meneruskan satu akan menggunakannya dan mengabaikan environment.** Tidak ada variabel environment kredensial atau profil di disk yang dibaca. Dengan cara yang sama, `AnthropicCredentials.Resolve(profile: "name")` kini mengembalikan kredensial profil tersebut ketika `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN` disetel.
* **Tidak meneruskan apa pun akan menggunakan kecocokan pertama di environment:** `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_PROFILE`, variabel workload identity federation, lalu profil aktif di disk. `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN` yang kosong dianggap tidak disetel. Ketika dua yang pertama sama-sama disetel, peringatan dikirim ke stderr satu kali. Klien mencari saat pertama kali digunakan, sehingga `ANTHROPIC_PROFILE` yang tidak ada kini melempar error dari permintaan pertama, bukan dari konstruktor.
* **`WithOptions` menggantikan.** Kredensial yang Anda teruskan di modifier menggantikan kredensial milik klien, apa pun jenisnya, sehingga `AuthToken = token` tidak lagi memerlukan `ApiKey = null` di sampingnya. Jika tidak ada yang diteruskan, salinan mempertahankan kredensial, `BaseUrl`, dan `ExtraHeaders` milik klien, bahkan ketika modifier mengembalikan `ClientOptions` baru.
```csharp
// Sebelumnya: keduanya dikirim, masing-masing dalam header-nya sendiri
AnthropicClient client = new() { ApiKey = apiKey, AuthToken = token };
// Sesudahnya: baris di atas melempar ArgumentException
AnthropicClient client = new() { AuthToken = token };
```
Dokumentasi XML pada ketiga properti [`ClientOptions`](https://github.com/anthropics/anthropic-sdk-csharp/blob/main/src/Anthropic/Core/ClientOptions.cs) tersebut berisi detailnya.
Klien platform cloud mempertahankan kredensial yang digunakan saat dibuat. Klien Bedrock, Bedrock Mantle, Foundry, Google Cloud, dan AWS serta `AnthropicVertexClient` menentukan cara autentikasi saat Anda membuatnya, dan sebagian besar menggunakan header `Authorization` untuk itu. Rilis paket-paket ini yang bergantung pada v13 mengabaikan `ApiKey` atau `AuthToken` yang Anda setel melalui `WithOptions`. Untuk menggunakan kunci lain dengan `AnthropicAwsClient`, buat klien baru dengan `ApiKey` di `AwsClientOptions`.
Jika Anda mengandalkan pengiriman keduanya, misalnya token untuk gateway dan kunci untuk API di belakangnya, setel `X-Api-Key` dengan `ExtraHeaders` dan pertahankan `AuthToken`. Minta gateway menghapus header `Authorization`-nya sebelum meneruskan permintaan. Claude API mengharapkan satu kredensial per permintaan.
Di v1, klien yang memiliki kunci API dan token autentikasi mengirim keduanya, masing-masing dalam header-nya sendiri. Kredensial berasal dari `option.WithAPIKey`, `option.WithAuthToken`, `option.WithConfig`, `option.WithProfile`, atau `option.WithFederationTokenProvider`.
* **Dua di antaranya yang diteruskan ke `anthropic.NewClient` adalah error.** `NewClient` tidak mengembalikan error, sehingga setiap permintaan yang dibuat klien gagal dengan error tersebut. `NewClient` sudah menerapkan `anthropic.DefaultClientOptions()`, jadi jangan teruskan hasilnya juga: kredensial yang ditemukannya di environment kemudian dihitung sebagai kredensial yang Anda teruskan.
* **Salah satunya digunakan apa adanya.** Tidak ada kredensial yang dibaca dari environment atau dari profil di disk. Di v1, `ANTHROPIC_API_KEY` dan `ANTHROPIC_AUTH_TOKEN` mengalahkan tiga yang terakhir.
* **Jika tidak ada satu pun, yang pertama dari berikut ini yang disetel yang digunakan,** dengan urutan yang sama seperti v1: `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_PROFILE`, variabel workload identity federation, profil aktif di disk. Ketika dua yang pertama sama-sama disetel, SDK mencatat peringatan satu kali.
* **Salah satunya pada sebuah permintaan menggantikan kredensial klien untuk permintaan tersebut,** sehingga `option.WithAuthToken` tidak lagi memerlukan `option.WithHeaderDel("X-Api-Key")` di sampingnya.
```go
// Sebelumnya: kunci API dikirim dan sebuah peringatan dicatat di log
client := anthropic.NewClient(
option.WithAPIKey(apiKey),
option.WithProfile("work"),
)
// Sesudahnya: setiap permintaan dari klien di atas gagal, jadi teruskan yang Anda inginkan
client := anthropic.NewClient(option.WithAPIKey(apiKey))
```
Peringatan yang dicatat v1 sudah dihapus, sehingga `option.WithConfigQuiet`, yang menekannya, kini melakukan hal yang sama dengan `option.WithConfig` dan sudah deprecated.
Komentar dokumentasi pada `anthropic.NewClient` dan `anthropic.DefaultClientOptions` di [`client.go`](https://github.com/anthropics/anthropic-sdk-go/blob/main/client.go) berisi detailnya.
Jika Anda mengandalkan pengiriman keduanya, misalnya token untuk gateway dan kunci untuk API di belakangnya, setel `X-Api-Key` dengan `option.WithHeader` dan pertahankan `option.WithAuthToken`. Minta gateway menghapus header `Authorization`-nya sebelum meneruskan permintaan. Claude API mengharapkan satu kredensial per permintaan.
`ANTHROPIC_CUSTOM_HEADERS` dan `ANTHROPIC_WEBHOOK_SIGNING_KEY` kini berlaku untuk setiap klien yang dibuat oleh `anthropic.NewClient`. Di v1, keduanya hanya dibaca ketika baik environment maupun profil di disk tidak menyimpan kredensial.
Di v2, klien yang memiliki kunci API dan token autentikasi mengirim keduanya, masing-masing dalam header-nya sendiri. Kredensial adalah salah satu dari `apiKey`, `authToken`, atau `configurationProvider` pada builder `AnthropicOkHttpClient`, `AnthropicOkHttpClientAsync`, dan `AnthropicBackend`.
* **Setel paling banyak satu.** Dengan dua pada satu builder, `build()` melempar `IllegalStateException` yang menyebutkan keduanya. `null` atau `Optional` kosong tidak dihitung.
* **Yang Anda setel adalah satu-satunya.** `fromEnv()`, yang dipanggil sebelum atau sesudahnya, tidak mengambil kredensial dari environment atau dari profil di disk. Di v2, kunci atau token yang ditemukan `fromEnv()` dapat dikirim juga, atau sebagai gantinya.
* **Jika tidak ada yang disetel, `fromEnv()` menggunakan yang pertama dari berikut ini yang ditemukannya:** `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_PROFILE`, variabel workload identity federation, profil aktif di disk. Ketika dua yang pertama sama-sama disetel, peringatan dikirim ke `System.err` satu kali. System property `anthropic.apiKey` dan `anthropic.authToken` dihitung sebagai environment. Kunci atau token yang kosong, dalam variabel atau system property, dianggap tidak disetel. Di v2, `fromEnv()` menggunakan nilai kosong sebagai kunci atau token.
```java
// Sebelumnya: keduanya dikirim. Di v3, build() melempar IllegalStateException
AnthropicClient client = AnthropicOkHttpClient.builder()
.apiKey(apiKey)
.authToken(authToken)
.build();
// Sesudahnya
AnthropicClient client = AnthropicOkHttpClient.builder()
.apiKey(apiKey)
.build();
```
Dokumentasi `fromEnv()` pada builder-builder tersebut berisi detailnya.
Jika Anda mengandalkan pengiriman keduanya, misalnya token untuk gateway dan kunci untuk API di belakangnya, setel kedua header sendiri:
```java
AnthropicClient client = AnthropicOkHttpClient.builder()
.putHeader("Authorization", "Bearer " + gatewayToken)
.putHeader("X-Api-Key", apiKey)
.build();
```
Minta gateway menghapus header `Authorization`-nya sebelum meneruskan permintaan. Claude API mengharapkan satu kredensial per permintaan.
Versi sebelumnya mengirim kunci API dan token autentikasi sekaligus ketika klien memiliki keduanya, masing-masing dalam header-nya sendiri. `Anthropic\Client` menerima satu kredensial, dari `apiKey`, `authToken`, atau `credentials`:
* Meneruskan lebih dari satu di antaranya melempar `\InvalidArgumentException`. Hanya `null` yang dianggap tidak diteruskan. String kosong dianggap diteruskan, sehingga `new Client(apiKey: '')` tidak mengirim kredensial.
* Meneruskan satu akan menggunakannya, dan tidak ada kredensial yang dibaca dari environment atau dari profil di disk. Dengan `ANTHROPIC_API_KEY` disetel, `new Client(authToken: $token)` mengirim token. Versi sebelumnya mengirim kunci dari environment bersamanya.
* Tidak meneruskan apa pun akan menggunakan yang pertama dari berikut ini yang disetel: `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, profil yang dinamai oleh `ANTHROPIC_PROFILE`, variabel workload identity federation, profil aktif di disk (yang dinamai oleh file `active_config`, jika tidak maka `default`). Versi sebelumnya menggunakan profil aktif sebelum variabel federasi, dan tidak menggunakan profil apa pun ketika tidak ada file `active_config`. Versi tersebut juga melewati `ANTHROPIC_PROFILE` yang menamai profil yang tidak ada atau tidak valid. Untuk kasus itu, `new Client()` kini melempar `Anthropic\Core\Exceptions\AnthropicException`. Dengan `ANTHROPIC_API_KEY` dan `ANTHROPIC_AUTH_TOKEN` sama-sama disetel, klien mengirim kunci dan properti `authToken`-nya kosong. Klien pertama yang dibuat dengan cara itu juga menulis peringatan dengan `error_log()`, satu kali per proses, yang pada server web berarti satu kali per permintaan: `Anthropic: ANTHROPIC_API_KEY and ANTHROPIC_AUTH_TOKEN are both set. Using ANTHROPIC_API_KEY.` Untuk menghentikannya, hapus variabel yang tidak Anda gunakan.
```php
// Sebelumnya: mengirim kunci sebagai X-Api-Key dan token sebagai Authorization.
// Sesudahnya: melempar "Pass at most one of `apiKey`, `authToken`, or `credentials`. Received `apiKey`, `authToken`."
$client = new Client(apiKey: $key, authToken: $token);
```
Jika Anda mengandalkan pengiriman keduanya, misalnya token untuk gateway dan kunci untuk API di belakangnya, teruskan token sebagai `authToken` dan tambahkan `X-Api-Key` dalam middleware seperti yang ada di bagian [Jika proxy atau gateway membaca `X-Api-Key`](https://platform.claude.com/docs/id/api/migration-2026-10-21#sdk-proxy-x-api-key), tanpa panggilan `withoutHeader`. Minta gateway menghapus header `Authorization`-nya sebelum meneruskan permintaan. Claude API mengharapkan satu kredensial per permintaan.
Argumen kredensial dari `Anthropic::Client.new` adalah `api_key:`, `auth_token:`, `credentials:`, dan `config:`. Argumen `nil` dianggap tidak diteruskan. Klien platform mempertahankan aturannya sendiri.
* **Dua atau lebih diteruskan:** `Anthropic::Client.new` memunculkan `ArgumentError`. Versi sebelumnya hanya memunculkan error untuk `credentials:` bersama `config:`, dan selain itu mengirim kunci jika ada, lalu token.
* **Satu diteruskan:** Klien menggunakannya, dan tidak beralih ke kredensial dari environment atau dari profil di disk.
* **Tidak ada yang diteruskan:** Klien menggunakan yang pertama dari berikut ini yang ditemukannya: `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_PROFILE`, variabel workload identity federation, profil aktif di disk. Urutannya tidak berubah, tetapi dengan `ANTHROPIC_API_KEY` dan `ANTHROPIC_AUTH_TOKEN` sama-sama disetel, `client.auth_token` kini bernilai `nil`. `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN` yang kosong kini dianggap tidak disetel, sedangkan versi sebelumnya membiarkan `ANTHROPIC_API_KEY` yang kosong menyembunyikan token dan semua yang ada setelahnya.
Ketika tidak ada kredensial yang diteruskan dan `ANTHROPIC_API_KEY` serta `ANTHROPIC_AUTH_TOKEN` sama-sama disetel, SDK juga memberi peringatan satu kali per proses, pada standard error melalui `Kernel#warn`: `Anthropic: ANTHROPIC_API_KEY and ANTHROPIC_AUTH_TOKEN are both set. Using ANTHROPIC_API_KEY.` Hapus variabel yang tidak Anda gunakan untuk membungkamnya.
```ruby
# Sebelumnya: mengirim kunci dan mengabaikan token.
# Sesudahnya: ArgumentError, "Pass at most one of `api_key:`, `auth_token:`, `credentials:`, or `config:`. Received `api_key:`, `auth_token:`."
Anthropic::Client.new(api_key: api_key, auth_token: auth_token)
# Teruskan hanya yang ingin Anda kirim.
Anthropic::Client.new(api_key: api_key)
```
### Perubahan pada satu SDK atau CLI
Masing-masing perubahan ini memengaruhi satu SDK atau CLI.
**`--api-key` dan `--auth-token` dihapus.** `ant` tidak lagi menerima kunci API atau token autentikasi sebagai nilai flag, karena nilai di baris perintah terlihat di riwayat shell dan daftar proses. Kedua flag telah mencetak peringatan deprecation sejak v1.27.0. Perintah yang masih meneruskan salah satunya akan berhenti dengan `flag provided but not defined`.
| Dihapus | Gunakan sebagai gantinya |
| ---------------------- | ------------------------------------------------------------- |
| `--api-key ` | `ANTHROPIC_API_KEY`, `--api-key-stdin`, atau `ant auth login` |
| `--auth-token ` | `ANTHROPIC_AUTH_TOKEN` atau `--auth-token-stdin` |
```bash
# Sebelum
ant --api-key "$KEY" models list
# Sesudah, dari environment
export ANTHROPIC_API_KEY="$KEY"
ant models list
# Sesudah, dari secret manager
op read op://vault/anthropic/api-key | ant --api-key-stdin models list
```
`--api-key-stdin` dan `--auth-token-stdin` membaca seluruh standard input, sehingga perintah yang menggunakan salah satunya mengambil body permintaannya dari flag.
`ant auth status`, prompt pertama kali dari `ant apply`, dan catatan tentang beberapa sumber autentikasi kini menyebut kredensial ini `ANTHROPIC_API_KEY` dan `ANTHROPIC_AUTH_TOKEN`, sedangkan sebelumnya mencetak `--api-key / ANTHROPIC_API_KEY` dan `--auth-token / ANTHROPIC_AUTH_TOKEN`.
**`Type` dari union adalah enum.** Di v12, properti `Type` dari kelas union, seperti `ContentBlock.Type` atau `RawMessageStreamEvent.Type`, adalah `JsonElement`. Di v13, properti tersebut adalah `ApiEnum`, dengan `T` adalah enum baru yang memiliki satu anggota untuk setiap varian, seperti `ContentBlockType`. Beberapa union dibedakan berdasarkan `Name` atau `Command`, seperti `BetaMemoryTool20250818Command.Command`, dan properti tersebut berubah dengan cara yang sama. `Type` dari kelas varian, seperti `TextBlock.Type`, tetap berupa `JsonElement`.
```csharp
// Sebelum
if (block.Type.GetString() == "tool_use") { }
// Sesudah
if (block.Type.Value() == ContentBlockType.ToolUse) { }
```
`block.Type.Raw()` mengembalikan string, termasuk string yang tidak memiliki anggota enum di versi SDK ini.
**`IChatClient` mengabaikan opsi sampling.** Adapter `IChatClient` (`AsIChatClient()`) kini mengabaikan `ChatOptions.Temperature`, `ChatOptions.TopK`, dan `ChatOptions.TopP`. Lihat [Parameter sampling dihapus](https://platform.claude.com/docs/id/api/migration-2026-10-21#sampling-parameters).
**Getter yang kini mengembalikan `Optional`.** `apiKey()` dan `authToken()` pada `AnthropicBackend` kini mengembalikan `Optional`, seperti yang sudah dilakukan `apiKey()` pada `AwsBackend` dan `BedrockMantleBackend`. Di v2, masing-masing mengembalikan `String`, yang bernilai `null` ketika backend tidak memiliki kredensial jenis tersebut.
```java
// Sebelum
String apiKey = backend.apiKey();
if (apiKey != null) {}
// Sesudah
Optional apiKey = backend.apiKey();
if (apiKey.isPresent()) {}
```
Getter berikut kini juga mengembalikan `Optional`. Di v2, masing-masing mengembalikan nilainya sendiri, yang bernilai `null` ketika tidak ada:
* `apiKey()` dan `awsCredentialsProvider()` pada `BedrockBackend`
* `filename()` dan `mimeType()` pada `McpResourceFile`
* `detail()` pada `CredentialSource`
* `body()` pada `HttpRequest`
* `resource()` pada `FoundryBackend`, yang sebelumnya `getResource()`
* `responseValidation()`, `timeout()`, `followRedirects()`, `fallbackState()`, dan `openTelemetry()` pada `RequestOptions`, yang sebelumnya `getResponseValidation()`, `getTimeout()`, `getFollowRedirects()`, `getFallbackState()`, dan `getOpenTelemetry()`
```java
// Sebelum
String filename = file.filename();
if (filename != null) {}
String resource = backend.getResource();
// Sesudah
Optional filename = file.filename();
if (filename.isPresent()) {}
Optional resource = backend.resource();
```
`getBaseUrl()` pada `FoundryBackend` dihapus. Panggil `baseUrl()`, yang mengembalikan URL tujuan permintaan. Itu adalah base URL yang Anda setel, atau yang dibangun dari resource, dan diakhiri dengan `/anthropic`.
`getBaseUrl()` pada `AnthropicBackend` juga dihapus. Panggil `baseUrl()`, yang mengembalikan nilai yang sama.
**`HttpRequest` memerlukan base URL.** Jika Anda membuat `HttpRequest` sendiri, seperti dalam pengujian interceptor, setel base URL-nya. Tanpanya, `build()` kini melempar `IllegalStateException`. Di v2, metode ini mengembalikan permintaan yang `baseUrl()`-nya bernilai `null`. Permintaan yang dibuat SDK sudah memilikinya.
```java
// Sebelum
HttpRequest request = HttpRequest.builder()
.method(HttpMethod.GET)
.build();
// Sesudah
HttpRequest request = HttpRequest.builder()
.method(HttpMethod.GET)
.baseUrl("https://api.anthropic.com")
.build();
```
`baseUrl()` tetap mengembalikan `String`, yang kini tidak pernah `null`. Pada builder, `baseUrl(Optional)` dihapus dan `baseUrl(String)` tidak lagi menerima `null`.
**Interceptor melihat `anthropic-version`.** Klien kini menambahkan header `anthropic-version` default sebelum interceptor berjalan. Di v2, backend menambahkannya setelah interceptor. Jika interceptor Anda menyetel versinya sendiri, panggil `replaceHeaders`, karena `putHeader` kini menambahkan nilai kedua:
```java
// Sebelum
request.toBuilder().putHeader("anthropic-version", version).build();
// Sesudah
request.toBuilder().replaceHeaders("anthropic-version", version).build();
```
**Case enum yang Anda teruskan dibaca kembali sebagai nilainya.** `with()` dan setter seperti `withAllowedCallers()` tetap menerima case enum atau nilainya. Versi sebelumnya menyimpan case sebagaimana Anda meneruskannya. v1 menyimpan nilai case tersebut, yang memang sudah dideklarasikan oleh tipe properti. Objek yang dibuat SDK dari respons tidak berubah, dan JSON yang dikirim SDK tetap sama. Jika Anda membaca kembali sebuah properti dan membandingkannya dengan case, perbandingan tersebut kini bernilai false dan tidak ada yang dilempar, jadi bandingkan dengan nilai case tersebut:
```php
$tool = CodeExecutionTool20250825::with(allowedCallers: [AllowedCaller::DIRECT]);
// Sebelum
in_array(AllowedCaller::DIRECT, $tool->allowedCallers, true);
// Sesudah
in_array(AllowedCaller::DIRECT->value, $tool->allowedCallers, true);
```
### Lisensinya adalah Apache 2.0
Mulai dari versi-versi ini, SDK dan CLI dilisensikan di bawah Apache License, Version 2.0. Versi sebelumnya tetap di bawah MIT License. Tidak ada perubahan kode yang diperlukan. Jika Anda melacak lisensi dependensi Anda, perbarui entri-entrinya.
* **TypeScript:** Paket platform (`@anthropic-ai/bedrock-sdk`, `@anthropic-ai/vertex-sdk`, `@anthropic-ai/foundry-sdk`, `@anthropic-ai/aws-sdk`, dan `@anthropic-ai/google-cloud-sdk`) berganti lisensi dalam rilis 1.0.0 masing-masing.
* **C#:** Paket lainnya (`Anthropic.Bedrock`, `Anthropic.Vertex`, `Anthropic.Foundry`, `Anthropic.Aws`, `Anthropic.GoogleCloud`, dan `Anthropic.Mcp`) berganti lisensi dalam rilis 1.0.0 masing-masing.
* **Java:** Perubahan ini mencakup setiap artefak `com.anthropic`.