One read of Claude Developer Platformapi-20261104T153709Z
26 pages moved out of 847 read.
Pages moved
26
significant first
Pages read
847
in this capture
Captured
15:37 UTC
Corpus hash
7e27d8c13b59
corpus-hash
What this read moved
1-25 of 26, page 1 of 2This capture is too large to show at once. Changes 1-25 of 26 are below, significant first; the rest are on the following screens.
agents-and-tools/agent-skills/quickstart Changed · +127 / -5 lines
## Before you begin ## Prerequisites
from line 6
66
77This tutorial shows you how to use Agent Skills to create a PowerPoint presentation. You’ll learn how to enable Skills, make a request, and access the generated file.
88
9## Prerequisites
9## Before you begin
1010
11* A [Claude API key](https://platform.claude.com/settings/keys) from the Claude Console, or a logged-in [ant CLI](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication)
12* A [client SDK](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) for your language, or `curl` and `jq`
13* Basic familiarity with making API requests
11You need a [client SDK](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) for your language, or `curl` and `jq`, and basic familiarity with making API requests.
12
13<Steps continues>
14 <Step title="Create a Claude Console account">
15 [Sign up](https://platform.claude.com/) for a Claude Console account, or sign in to the one you have.
16 </Step>
17
18 <Step title="Choose how to authenticate">
19 Signing in with the CLI is recommended for local development.
20
21 Follow the steps for one of the following options.
22 </Step>
23</Steps>
24
25**CLI**
26
27<Steps continued>
28 <Step title="Install the CLI" stepNumber={3}>
29 <Tabs noDeepLinks>
30 <Tab title="Homebrew (macOS)">
31 ```bash
32 brew install anthropics/tap/ant
33 ```
34 </Tab>
35
36 <Tab title="curl (Linux/WSL)">
37 For Linux environments, download the release binary directly.
38
39 ```bash
40 VERSION=2.5.0
41 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
42 case $(uname -m) in
43 x86_64) ARCH=amd64 ;;
44 aarch64) ARCH=arm64 ;;
45 esac
46 curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
47 | sudo tar -xz -C /usr/local/bin ant
48 ```
49
50 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
51 </Tab>
52
53 <Tab title="go install">
54 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
55
56 ```bash
57 go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
58 ```
59
60 The binary is placed in `$(go env GOPATH)/bin`. Add it to your `PATH` if it isn’t already:
61
62 ```bash
63 export PATH="$PATH:$(go env GOPATH)/bin"
64 ```
65 </Tab>
66 </Tabs>
67 </Step>
68
69 <Step title="Sign in" stepNumber={4}>
70 ```bash
71 ant auth login
72 ```
73
74 Once login is completed, the SDKs and CLI will pick up your credentials automatically.
75 </Step>
76</Steps>
77
78**API key**
79
80<Steps continued>
81 <Step title="Create an API key" stepNumber={3}>
82 Create an [API key](https://platform.claude.com/settings/keys) in the Claude Console.
83 </Step>
84
85 <Step title="Set the environment variable" stepNumber={4}>
86 The SDKs and CLI read your key from `ANTHROPIC_API_KEY`:
87
88 ```bash
89 export ANTHROPIC_API_KEY="your-api-key-here"
90 ```
91 </Step>
92</Steps>
93
94**API key**
95
96To run the CLI examples, install the CLI:
97
98<Tabs noDeepLinks>
99 <Tab title="Homebrew (macOS)">
100 ```bash
101 brew install anthropics/tap/ant
102 ```
103 </Tab>
104
105 <Tab title="curl (Linux/WSL)">
106 For Linux environments, download the release binary directly.
107
108 ```bash
109 VERSION=2.5.0
110 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
111 case $(uname -m) in
112 x86_64) ARCH=amd64 ;;
113 aarch64) ARCH=arm64 ;;
114 esac
115 curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
116 | sudo tar -xz -C /usr/local/bin ant
117 ```
118
119 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
120 </Tab>
121
122 <Tab title="go install">
123 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
124
125 ```bash
126 go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
127 ```
128
129 The binary is placed in `$(go env GOPATH)/bin`. Add it to your `PATH` if it isn’t already:
130
131 ```bash
132 export PATH="$PATH:$(go env GOPATH)/bin"
133 ```
134 </Tab>
135</Tabs>
14136
15137## Agent Skills overview
16138
build-with-claude/claude-in-microsoft-foundry Changed · +2 / -9 lines
from line 82
8282 ```kotlin
8383 implementation("com.anthropic:anthropic-java:3.4.0")
8484 implementation("com.anthropic:anthropic-java-foundry:3.4.0")
85
86 // For Entra ID authentication, also add the Azure Identity library
87 implementation("com.azure:azure-identity:1.18.3")
8885 ```
8986 </Tab>
9087
from line 97
10097 <artifactId>anthropic-java-foundry</artifactId>
10198 <version>3.4.0</version>
10299 </dependency>
103 <!-- For Entra ID authentication, also add the Azure Identity library -->
104 <dependency>
105 <groupId>com.azure</groupId>
106 <artifactId>azure-identity</artifactId>
107 <version>1.18.3</version>
108 </dependency>
109100 ```
110101 </Tab>
111102 </Tabs>
103
104 For Entra ID authentication, also add the Azure Identity library (`com.azure:azure-identity`) to your build, at the latest version on [Maven Central](https://central.sonatype.com/artifact/com.azure/azure-identity).
112105 </Tab>
113106
114107 <Tab title="PHP">
build-with-claude/claude-models-on-google-cloud/anthropic-managed Changed · +24 / -18 lines
from line 169
169169
170170 <Tab title="Go">
171171 ```bash
172 go get github.com/anthropics/anthropic-sdk-go/v2
172 go get github.com/anthropics/anthropic-sdk-go/v2/googlecloud
173173 ```
174174 </Tab>
175175
176176 <Tab title="Java">
177 ```kotlin Gradle
178 implementation("com.anthropic:anthropic-java:3.4.0")
179 implementation("com.anthropic:anthropic-java-google-cloud:3.4.0")
180 ```
177 <Tabs>
178 <Tab title="Gradle">
179 ```kotlin
180 implementation("com.anthropic:anthropic-java:3.4.0")
181 implementation("com.anthropic:anthropic-java-google-cloud:3.4.0")
182 ```
183 </Tab>
181184
182 ```xml Maven
183 <dependency>
184 <groupId>com.anthropic</groupId>
185 <artifactId>anthropic-java</artifactId>
186 <version>3.4.0</version>
187 </dependency>
188 <dependency>
189 <groupId>com.anthropic</groupId>
190 <artifactId>anthropic-java-google-cloud</artifactId>
191 <version>3.4.0</version>
192 </dependency>
193 ```
185 <Tab title="Maven">
186 ```xml
187 <dependency>
188 <groupId>com.anthropic</groupId>
189 <artifactId>anthropic-java</artifactId>
190 <version>3.4.0</version>
191 </dependency>
192 <dependency>
193 <groupId>com.anthropic</groupId>
194 <artifactId>anthropic-java-google-cloud</artifactId>
195 <version>3.4.0</version>
196 </dependency>
197 ```
198 </Tab>
199 </Tabs>
194200 </Tab>
195201
196202 <Tab title="PHP">
build-with-claude/claude-models-on-google-cloud/google-managed Changed · +24 / -19 lines
from line 41
4141 <Tab title="Go">
4242 ```bash
4343 go get github.com/anthropics/anthropic-sdk-go/v2
44 go get github.com/anthropics/anthropic-sdk-go/v2/vertex
4445 ```
4546 </Tab>
4647
4748 <Tab title="Java">
48 <CodeGroup exclude="shell, python, typescript, csharp, go, php, ruby">
49 ```groovy Gradle
50 implementation("com.anthropic:anthropic-java:3.4.0")
51 implementation("com.anthropic:anthropic-java-vertex:3.4.0")
52 ```
49 <Tabs>
50 <Tab title="Gradle">
51 ```kotlin
52 implementation("com.anthropic:anthropic-java:3.4.0")
53 implementation("com.anthropic:anthropic-java-vertex:3.4.0")
54 ```
55 </Tab>
5356
54 ```xml Maven
55 <dependency>
56 <groupId>com.anthropic</groupId>
57 <artifactId>anthropic-java</artifactId>
58 <version>3.4.0</version>
59 </dependency>
60 <dependency>
61 <groupId>com.anthropic</groupId>
62 <artifactId>anthropic-java-vertex</artifactId>
63 <version>3.4.0</version>
64 </dependency>
65 ```
66 </CodeGroup>
57 <Tab title="Maven">
58 ```xml
59 <dependency>
60 <groupId>com.anthropic</groupId>
61 <artifactId>anthropic-java</artifactId>
62 <version>3.4.0</version>
63 </dependency>
64 <dependency>
65 <groupId>com.anthropic</groupId>
66 <artifactId>anthropic-java-vertex</artifactId>
67 <version>3.4.0</version>
68 </dependency>
69 ```
70 </Tab>
71 </Tabs>
6772 </Tab>
6873
6974 <Tab title="PHP">
build-with-claude/claude-platform-on-aws Changed · +37 / -31 lines
from line 234
234234 ```
235235
236236 ```java Java
237 import software.amazon.awsexternalanthropic.TokenGenerator;
237 import software.amazon.awsexternalanthropic.token.TokenGenerator;
238238 import software.amazon.awssdk.regions.Region;
239239 import com.anthropic.aws.backends.AwsBackend;
240240 import com.anthropic.client.AnthropicClient;
from line 304
304304
305305 <Tab title="Go">
306306 ```bash
307 go get github.com/anthropics/anthropic-sdk-go/v2
307 go get github.com/anthropics/anthropic-sdk-go/v2/aws
308308 ```
309309 </Tab>
310310
311311 <Tab title="Java">
312 ```kotlin Gradle
313 implementation("com.anthropic:anthropic-java:3.4.0")
314 implementation("com.anthropic:anthropic-java-aws:3.4.0")
315 ```
312 <Tabs>
313 <Tab title="Gradle">
314 ```kotlin
315 implementation("com.anthropic:anthropic-java:3.4.0")
316 implementation("com.anthropic:anthropic-java-aws:3.4.0")
317 ```
318 </Tab>
316319
317 ```xml Maven
318 <dependency>
319 <groupId>com.anthropic</groupId>
320 <artifactId>anthropic-java</artifactId>
321 <version>3.4.0</version>
322 </dependency>
323 <dependency>
324 <groupId>com.anthropic</groupId>
325 <artifactId>anthropic-java-aws</artifactId>
326 <version>3.4.0</version>
327 </dependency>
328 ```
320 <Tab title="Maven">
321 ```xml
322 <dependency>
323 <groupId>com.anthropic</groupId>
324 <artifactId>anthropic-java</artifactId>
325 <version>3.4.0</version>
326 </dependency>
327 <dependency>
328 <groupId>com.anthropic</groupId>
329 <artifactId>anthropic-java-aws</artifactId>
330 <version>3.4.0</version>
331 </dependency>
332 ```
333 </Tab>
334 </Tabs>
329335 </Tab>
330336
331337 <Tab title="PHP">
from line 1111
11051111
11061112The migration delta depends on which Bedrock integration you’re coming from. The following table shows both the [current Bedrock integration](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) (Messages API at `bedrock-mantle.{region}.api.aws`) and the [legacy InvokeModel integration](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy).
11071113
1108| Aspect | From [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) | From [Amazon Bedrock (Opus 4.6 and earlier)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) | To Claude Platform on AWS |
1109| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1110| **Base URL** | `bedrock-mantle.{region}.api.aws` | `bedrock-runtime.{region}.amazonaws.com` | `aws-external-anthropic.{region}.api.aws` |
1111| **API format** | Messages API at `/anthropic/v1/messages` | Bedrock Converse / InvokeModel | Claude API (`/v1/{endpoint}`) |
1112| **Model IDs** | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-4-5-20251001-v1:0 (with a `us.` or `global.` inference profile prefix) | claude-haiku-4-5 |
1113| **SDK client** | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK | Platform-specific client (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk)), in beta |
1114| **SDK package** | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/v2/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`) | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/v2/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`), or the AWS SDK | `anthropic[aws]` (typescript: `@anthropic-ai/aws-sdk`; csharp: `Anthropic.Aws`; go: `github.com/anthropics/anthropic-sdk-go/v2/aws`; java: `com.anthropic:anthropic-java-aws`; php: `anthropic-ai/sdk`; ruby: `anthropic`) (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk)) |
1115| **SigV4 service name** | `bedrock-mantle` | `bedrock` | `aws-external-anthropic` |
1116| **Streaming format** | SSE | AWS EventStream | SSE (same as Claude API) |
1117| **Workspace header** | Not applicable | Not applicable | `anthropic-workspace-id`, required on inference and resource requests |
1118| **Region availability** | See [Amazon Bedrock regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html) | See [Amazon Bedrock regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html) | All AWS commercial regions |
1119| **Anthropic organization** | None required | None required | New organization created at sign-up. Existing organizations can’t be converted (see [Moving from an existing Anthropic organization](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#moving-from-an-existing-anthropic-organization)) |
1114| Aspect | From [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) | From [Amazon Bedrock (Opus 4.6 and earlier)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) | To Claude Platform on AWS |
1115| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1116| **Base URL** | `bedrock-mantle.{region}.api.aws` | `bedrock-runtime.{region}.amazonaws.com` | `aws-external-anthropic.{region}.api.aws` |
1117| **API format** | Messages API at `/anthropic/v1/messages` | Bedrock Converse / InvokeModel | Claude API (`/v1/{endpoint}`) |
1118| **Model IDs** | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-4-5-20251001-v1:0 (with a `us.` or `global.` inference profile prefix) | claude-haiku-4-5 |
1119| **SDK client** | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK | Platform-specific client (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk)), in beta |
1120| **SDK package** | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/v2/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`) | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`), or the AWS SDK | `anthropic[aws]` (typescript: `@anthropic-ai/aws-sdk`; csharp: `Anthropic.Aws`; go: `github.com/anthropics/anthropic-sdk-go/v2/aws`; java: `com.anthropic:anthropic-java-aws`; php: `anthropic-ai/sdk`; ruby: `anthropic`) (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk)) |
1121| **SigV4 service name** | `bedrock-mantle` | `bedrock` | `aws-external-anthropic` |
1122| **Streaming format** | SSE | AWS EventStream | SSE (same as Claude API) |
1123| **Workspace header** | Not applicable | Not applicable | `anthropic-workspace-id`, required on inference and resource requests |
1124| **Region availability** | See [Amazon Bedrock regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html) | See [Amazon Bedrock regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html) | All AWS commercial regions |
1125| **Anthropic organization** | None required | None required | New organization created at sign-up. Existing organizations can’t be converted (see [Moving from an existing Anthropic organization](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#moving-from-an-existing-anthropic-organization)) |
11201126
11211127If you’re on the current Bedrock integration, the request body format is already the Messages API. The changes are the base URL, SigV4 service name, model IDs, and the added `anthropic-workspace-id` header. If you’re on the legacy InvokeModel or Converse API, you’ll also rewrite the request and response shapes to the Messages API format. See [Claude on Amazon Bedrock (Opus 4.6 and earlier)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) for the request-shape mapping.
11221128
build-with-claude/handling-stop-reasons Changed · +12 / -5 lines
from line 1930
19301930 ```
19311931
19321932 ```python Python
1933 client = anthropic.Anthropic()
1934
19331935 # Request with maximum tokens to get as much as possible
19341936 response = client.beta.messages.create(
19351937 model="claude-opus-5-5",
from line 1948
19461948 ```
19471949
19481950 ```typescript TypeScript
1951 const client = new Anthropic();
1952
19491953 // Request with maximum tokens to get as much as possible
19501954 const response = await client.beta.messages.create({
19511955 model: "claude-opus-5-5",
from line 1965
19611965 ```
19621966
19631967 ```csharp C#
1964 using Anthropic.Models.Beta.Messages;
1965 using Model = Anthropic.Models.Messages.Model;
1968 AnthropicClient client = new();
19661969
19671970 // Request with maximum tokens to get as much as possible
19681971 var response = await client.Beta.Messages.Create(new MessageCreateParams
from line 1984
19811984 ```
19821985
19831986 ```go Go
1987 client := anthropic.NewClient()
1988
19841989 // Request with maximum tokens to get as much as possible
19851990 response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{
19861991 Model: anthropic.ModelClaudeOpus5_5,
from line 2006
20012006 ```
20022007
20032008 ```java Java
2004 import com.anthropic.models.beta.messages.BetaMessage;
2005 import com.anthropic.models.beta.messages.BetaStopReason;
2006 import com.anthropic.models.beta.messages.MessageCreateParams;
2009 AnthropicClient client = AnthropicOkHttpClient.fromEnv();
20072010
20082011 // Request with maximum tokens to get as much as possible
20092012 BetaMessage response = client.beta().messages().create(
from line 2025
20222025 ```
20232026
20242027 ```php PHP
2028 $client = new Client();
2029
20252030 // Request with maximum tokens to get as much as possible
20262031 $response = $client->beta->messages->create(
20272032 maxTokens: 20000,
from line 2042
20372042 ```
20382043
20392044 ```ruby Ruby
2045 client = Anthropic::Client.new
2046
20402047 # Request with maximum tokens to get as much as possible
20412048 response = client.beta.messages.create(
20422049 model: "claude-opus-5-5",
build-with-claude/prompt-caching Changed · +5 / -5 lines
from line 890
890890
891891You can use both 1-hour and 5-minute cache controls in the same request, but with an important constraint: Cache entries with longer TTL must appear before shorter TTLs (that is, a 1-hour cache entry must appear before any 5-minute cache entries).
892892
893When mixing TTLs, the API determines three billing locations in your prompt:
893When mixing TTLs, the Claude API determines three billing locations in your prompt:
894894
8951. Position `A`: The token count at the highest cache hit (or 0 if no hits).
8962. Position `B`: The token count at the highest 1-hour `cache_control` block after `A` (or equals `A` if none exist).
8951. Position `A`: The token count at the last cache hit in your prompt (or 0 if no hits). A hit on an entry cached with a 5-minute TTL doesn’t count if a 1-hour `cache_control` block after it is a cache miss.
8962. Position `B`: The token count at the last 1-hour `cache_control` block after `A` (or equals `A` if none exist).
8978973. Position `C`: The token count at the last `cache_control` block.
898898
899899<Note>
900 If `B` or `C` is larger than `A`, it is necessarily a cache miss, because `A` is the highest cache hit.
900 If `B` or `C` is larger than `A`, it is necessarily a cache miss.
901901</Note>
902902
903903You are charged for:
cli-sdks-libraries/sdks/java Changed · +41 / -1 lines
### Add-ons
from line 30
3030 </Tab>
3131</Tabs>
3232
33### Add-ons
34
35Cloud platform integrations and the client-side MCP helpers ship as separate add-on artifacts. Install an add-on alongside `anthropic-java`, which provides `AnthropicOkHttpClient`. Use the same version for both. This example adds the client-side MCP helpers:
36
37<Tabs>
38 <Tab title="Gradle">
39 ```kotlin
40 implementation("com.anthropic:anthropic-java:3.4.0")
41 implementation("com.anthropic:anthropic-java-mcp:3.4.0")
42 ```
43 </Tab>
44
45 <Tab title="Maven">
46 ```xml
47 <dependency>
48 <groupId>com.anthropic</groupId>
49 <artifactId>anthropic-java</artifactId>
50 <version>3.4.0</version>
51 </dependency>
52 <dependency>
53 <groupId>com.anthropic</groupId>
54 <artifactId>anthropic-java-mcp</artifactId>
55 <version>3.4.0</version>
56 </dependency>
57 ```
58 </Tab>
59</Tabs>
60
61For another add-on, replace `anthropic-java-mcp` with its artifact name. [Platform integrations](https://platform.claude.com/docs/en/cli-sdks-libraries/sdks/java#platform-integrations) lists the artifact for each cloud platform. [Client-side MCP helpers](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector#client-side-mcp-helpers) covers `anthropic-java-mcp` and the Java version it requires.
62
3363## Requirements
3464
3565This library requires Java 8 or later.
from line 151
121151
122152```java
123153import com.anthropic.client.AnthropicClient;
154import com.anthropic.client.okhttp.AnthropicOkHttpClient;
124155
156AnthropicClient client = AnthropicOkHttpClient.fromEnv();
157
125158AnthropicClient clientWithOptions = client.withOptions(optionsBuilder -> {
126159 optionsBuilder.baseUrl("https://example.com");
127160 optionsBuilder.maxRetries(42);
from line 834
801834Each class in the SDK has an associated builder for constructing it. Each class is immutable once constructed. If the class has an associated builder, then it has a `toBuilder()` method, which can be used to convert it back to a builder for making a modified copy.
802835
803836```java
837import com.anthropic.models.messages.MessageCreateParams;
838import com.anthropic.models.messages.Model;
839
804840MessageCreateParams params = MessageCreateParams.builder()
805841 .maxTokens(1024L)
806842 .addUserMessage("Hello, Claude")
from line 1135
10991135
11001136The Java SDK also supports Claude Models on Google Cloud (Anthropic managed) through `GoogleCloudBackend`, from the `com.anthropic:anthropic-java-google-cloud` dependency. This backend is in beta. Create it with `GoogleCloudBackend.builder()` or `GoogleCloudBackend.fromEnv()`. `fromEnv()` reads `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`, `ANTHROPIC_GOOGLE_CLOUD_PROJECT`, and Google Application Default Credentials. See [Project, location, and workspace resolution](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution).
11011137
1102The platform artifacts are add-ons to the base `com.anthropic:anthropic-java` dependency, which provides `AnthropicOkHttpClient`, so install both. Each `Backend` implementation is passed to the client with `.backend()` on `AnthropicOkHttpClient.builder()`. Each cloud backend pulls in its respective cloud-platform SDK classes as transitive dependencies.
1138Install each platform artifact alongside the base `anthropic-java` dependency, as shown in [Add-ons](https://platform.claude.com/docs/en/cli-sdks-libraries/sdks/java#add-ons). Each `Backend` implementation is passed to the client with `.backend()` on `AnthropicOkHttpClient.builder()`.
11031139
11041140## Advanced usage
11051141
from line 1144
11081144To access HTTP headers, status codes, and the raw response body, prefix any HTTP method call with `withRawResponse()`:
11091145
11101146```java
1147import com.anthropic.client.AnthropicClient;
1148import com.anthropic.client.okhttp.AnthropicOkHttpClient;
11111149import com.anthropic.core.http.Headers;
11121150import com.anthropic.core.http.HttpResponseFor;
11131151import com.anthropic.models.messages.Message;
11141152import com.anthropic.models.messages.MessageCreateParams;
11151153import com.anthropic.models.messages.Model;
1154
1155AnthropicClient client = AnthropicOkHttpClient.fromEnv();
11161156
11171157MessageCreateParams params = MessageCreateParams.builder()
11181158 .maxTokens(1024L)
get-started Changed · +171 / -117 lines
## Before you begin ## Prerequisites
from line 4
44description: Make your first API call to Claude and build a simple web search assistant.
55---
66
7## Prerequisites
7## Before you begin
88
9* A [Claude Console account](https://platform.claude.com/)
10* An [API key](https://platform.claude.com/docs/en/get-api-key)
9<Steps continues>
10 <Step title="Create a Claude Console account">
11 [Sign up](https://platform.claude.com/) for a Claude Console account, or sign in to the one you have.
12 </Step>
1113
14 <Step title="Choose how to authenticate">
15 Signing in with the CLI is recommended for local development.
16
17 Follow the steps for one of the following options.
18 </Step>
19</Steps>
20
21**CLI**
22
23<Steps continued>
24 <Step title="Install the CLI" stepNumber={3}>
25 <Tabs noDeepLinks>
26 <Tab title="Homebrew (macOS)">
27 ```bash
28 brew install anthropics/tap/ant
29 ```
30 </Tab>
31
32 <Tab title="curl (Linux/WSL)">
33 For Linux environments, download the release binary directly.
34
35 ```bash
36 VERSION=2.5.0
37 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
38 case $(uname -m) in
39 x86_64) ARCH=amd64 ;;
40 aarch64) ARCH=arm64 ;;
41 esac
42 curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
43 | sudo tar -xz -C /usr/local/bin ant
44 ```
45
46 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
47 </Tab>
48
49 <Tab title="go install">
50 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
51
52 ```bash
53 go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
54 ```
55
56 The binary is placed in `$(go env GOPATH)/bin`. Add it to your `PATH` if it isn’t already:
57
58 ```bash
59 export PATH="$PATH:$(go env GOPATH)/bin"
60 ```
61 </Tab>
62 </Tabs>
63 </Step>
64
65 <Step title="Sign in" stepNumber={4}>
66 ```bash
67 ant auth login
68 ```
69
70 Once login is completed, the SDKs and CLI will pick up your credentials automatically.
71 </Step>
72</Steps>
73
74**API key**
75
76<Steps continued>
77 <Step title="Create an API key" stepNumber={3}>
78 Create an [API key](https://platform.claude.com/settings/keys) in the Claude Console.
79 </Step>
80
81 <Step title="Set the environment variable" stepNumber={4}>
82 The SDKs and CLI read your key from `ANTHROPIC_API_KEY`:
83
84 ```bash
85 export ANTHROPIC_API_KEY="your-api-key-here"
86 ```
87 </Step>
88</Steps>
89
1290## Call the API
1391
1492<Tabs>
1593 <Tab title="cURL">
1694 <Steps>
17 <Step title="Set your API key">
18 Export your API key as an environment variable. The cURL command in the following step reads it from `$ANTHROPIC_API_KEY`.
95 <Step title="Make your first API call" stepNumber={5}>
96 **CLI**
1997
20 ```bash
21 export ANTHROPIC_API_KEY="your-api-key-here"
98 Send a `POST` request to the Messages API, with [the access token from your CLI sign-in](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/scripting#authenticate-curl-requests-with-cli-credentials) as a bearer token:
99
100 ```bash cURL
101 curl https://api.anthropic.com/v1/messages \
102 -H "content-type: application/json" \
103 -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
104 -H "anthropic-version: 2026-10-21" \
105 -d '{
106 "model": "claude-opus-5-5",
107 "max_tokens": 1000,
108 "messages": [
109 {
110 "role": "user",
111 "content": "What should I search for to find the latest developments in renewable energy?"
112 }
113 ]
114 }'
22115 ```
23 </Step>
24116
25 <Step title="Make your first API call">
117 **API key**
118
26119 Send a `POST` request to the Messages API:
27120
28121 ```bash cURL
from line 164
71164
72165 <Tab title="CLI">
73166 <Steps>
74 <Step title="Install the CLI">
75 Install the Anthropic CLI with Homebrew:
167 <Step title="Make your first API call" stepNumber={5}>
168 **API key**
76169
77 ```bash
78 brew install anthropics/tap/ant
79 ```
170 If you chose API key earlier, install the CLI first:
80171
81 For other installation methods, see [Installation](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart#installation) in the CLI quickstart.
82 </Step>
172 <Tabs noDeepLinks>
173 <Tab title="Homebrew (macOS)">
174 ```bash
175 brew install anthropics/tap/ant
176 ```
177 </Tab>
83178
84 <Step title="Authenticate">
85 Log in with your Anthropic account:
179 <Tab title="curl (Linux/WSL)">
180 For Linux environments, download the release binary directly.
86181
87 ```bash
88 ant auth login
89 ```
182 ```bash
183 VERSION=2.5.0
184 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
185 case $(uname -m) in
186 x86_64) ARCH=amd64 ;;
187 aarch64) ARCH=arm64 ;;
188 esac
189 curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
190 | sudo tar -xz -C /usr/local/bin ant
191 ```
90192
91 This opens a browser-based OAuth flow. After authorizing, confirm your credential with:
193 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
194 </Tab>
92195
93 ```bash
94 ant auth status
95 ```
196 <Tab title="go install">
197 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
96198
97 On a remote host without a browser, pass `--no-browser` to get a URL you can open on another device, then paste the returned code back into the terminal. For non-interactive environments such as CI, see [CLI authentication options](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication).
98 </Step>
199 ```bash
200 go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
201 ```
99202
100 <Step title="Make your first API call">
203 The binary is placed in `$(go env GOPATH)/bin`. Add it to your `PATH` if it isn’t already:
204
205 ```bash
206 export PATH="$PATH:$(go env GOPATH)/bin"
207 ```
208 </Tab>
209 </Tabs>
210
101211 Run `ant messages create` from your terminal:
102212
103213 ```bash CLI
from line 246
136246
137247 <Tab title="Python">
138248 <Steps>
139 <Step title="Set your API key">
140 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
141
249 <Step title="Create a project and install the SDK" stepNumber={5}>
142250 ```bash
143 export ANTHROPIC_API_KEY="your-api-key-here"
144 ```
145 </Step>
146
147 <Step title="Create a project and install the SDK">
148 ```bash
149251 mkdir claude-quickstart && cd claude-quickstart
150252 python3 -m venv .venv && source .venv/bin/activate
151253 pip install anthropic
from line 254
152254 ```
153255 </Step>
154256
155 <Step title="Create your code">
257 <Step title="Create your code" stepNumber={6}>
156258 Create a file called `quickstart.py`:
157259
158260 ```python Python
from line 279
177279 ```
178280 </Step>
179281
180 <Step title="Run your code">
282 <Step title="Run your code" stepNumber={7}>
181283 ```bash
182284 python quickstart.py
183285 ```
from line 297
195297
196298 <Tab title="TypeScript">
197299 <Steps>
198 <Step title="Set your API key">
199 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
200
300 <Step title="Create a project and install the SDK" stepNumber={5}>
201301 ```bash
202 export ANTHROPIC_API_KEY="your-api-key-here"
203 ```
204 </Step>
205
206 <Step title="Create a project and install the SDK">
207 ```bash
208302 mkdir claude-quickstart && cd claude-quickstart
209303 npm init -y
210304 npm pkg set type=module
from line 306
212306 ```
213307 </Step>
214308
215 <Step title="Create your code">
309 <Step title="Create your code" stepNumber={6}>
216310 Create a file called `quickstart.ts`:
217311
218312 ```typescript TypeScript
from line 333
239333 ```
240334 </Step>
241335
242 <Step title="Run your code">
336 <Step title="Run your code" stepNumber={7}>
243337 ```bash
244338 npx tsx quickstart.ts
245339 ```
from line 351
257351
258352 <Tab title="C#">
259353 <Steps>
260 <Step title="Set your API key">
261 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
262
263 ```bash
264 export ANTHROPIC_API_KEY="your-api-key-here"
265 ```
266 </Step>
267
268 <Step title="Create a project and install the SDK">
354 <Step title="Create a project and install the SDK" stepNumber={5}>
269355 Create a new console project and add the Anthropic package:
270356
271357 ```bash
from line 361
275361 ```
276362 </Step>
277363
278 <Step title="Create your code">
364 <Step title="Create your code" stepNumber={6}>
279365 Replace the contents of `Program.cs`:
280366
281367 ```csharp C#
from line 393
307393 ```
308394 </Step>
309395
310 <Step title="Run your code">
396 <Step title="Run your code" stepNumber={7}>
311397 ```bash
312398 dotnet run
313399 ```
from line 411
325411
326412 <Tab title="Go">
327413 <Steps>
328 <Step title="Set your API key">
329 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
330
331 ```bash
332 export ANTHROPIC_API_KEY="your-api-key-here"
333 ```
334 </Step>
335
336 <Step title="Create a project and install the SDK">
414 <Step title="Create a project and install the SDK" stepNumber={5}>
337415 Create a new module and add the Anthropic SDK:
338416
339417 ```bash
from line 421
343421 ```
344422 </Step>
345423
346 <Step title="Create your code">
424 <Step title="Create your code" stepNumber={6}>
347425 Create a file called `main.go`:
348426
349427 ```go Go
from line 458
380458 ```
381459 </Step>
382460
383 <Step title="Run your code">
461 <Step title="Run your code" stepNumber={7}>
384462 ```bash
385463 go run .
386464 ```
from line 476
398476
399477 <Tab title="Java">
400478 <Steps>
401 <Step title="Set your API key">
402 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
403
404 ```bash
405 export ANTHROPIC_API_KEY="your-api-key-here"
406 ```
407 </Step>
408
409 <Step title="Set up your project">
479 <Step title="Set up your project" stepNumber={5}>
410480 You need a JDK (25 or later) and either [Gradle](https://gradle.org/install/) or [Maven](https://maven.apache.org/install.html) on your `PATH`. Create a directory for your project with a Java source directory inside it:
411481
412482 ```bash
from line 540
470540 </Tabs>
471541 </Step>
472542
473 <Step title="Create your code">
543 <Step title="Create your code" stepNumber={6}>
474544 Save this as `QuickStart.java` in your project’s Java source directory (usually `src/main/java/`):
475545
476546 ```java Java
from line 568
498568 ```
499569 </Step>
500570
501 <Step title="Run your code">
571 <Step title="Run your code" stepNumber={7}>
502572 <Tabs>
503573 <Tab title="Gradle">
504574 ```bash
from line 596
526596
527597 <Tab title="PHP">
528598 <Steps>
529 <Step title="Set your API key">
530 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
531
599 <Step title="Create a project and install the SDK" stepNumber={5}>
532600 ```bash
533 export ANTHROPIC_API_KEY="your-api-key-here"
534 ```
535 </Step>
536
537 <Step title="Create a project and install the SDK">
538 ```bash
539601 mkdir claude-quickstart && cd claude-quickstart
540602 composer require "anthropic-ai/sdk" "guzzlehttp/guzzle:^7"
541603 ```
542604 </Step>
543605
544 <Step title="Create your code">
606 <Step title="Create your code" stepNumber={6}>
545607 Create a file called `quickstart.php`:
546608
547609 ```php PHP
from line 635
573635 ```
574636 </Step>
575637
576 <Step title="Run your code">
638 <Step title="Run your code" stepNumber={7}>
577639 ```bash
578640 php quickstart.php
579641 ```
from line 653
591653
592654 <Tab title="Ruby">
593655 <Steps>
594 <Step title="Set your API key">
595 Export your API key as an environment variable. The SDK reads `ANTHROPIC_API_KEY` automatically.
596
656 <Step title="Create a project and install the SDK" stepNumber={5}>
597657 ```bash
598 export ANTHROPIC_API_KEY="your-api-key-here"
599 ```
600 </Step>
601
602 <Step title="Create a project and install the SDK">
603 ```bash
604658 mkdir claude-quickstart && cd claude-quickstart
605659 bundle init
606660 bundle add anthropic
from line 661
607661 ```
608662 </Step>
609663
610 <Step title="Create your code">
664 <Step title="Create your code" stepNumber={6}>
611665 Create a file called `quickstart.rb`:
612666
613667 ```ruby Ruby
from line 686
632686 ```
633687 </Step>
634688
635 <Step title="Run your code">
689 <Step title="Run your code" stepNumber={7}>
636690 ```bash
637691 bundle exec ruby quickstart.rb
638692 ```
manage-claude/opentelemetry/sdk Changed · +17 / -13 lines
from line 98
9898 <Tab title="Java">
9999 Add the Claude SDK to your dependencies, or update it to at least the following version if your build file already declares it:
100100
101 <CodeGroup exclude="shell, python, typescript, csharp, go, php, ruby">
102 ```kotlin Gradle
103 implementation("com.anthropic:anthropic-java:3.4.0")
104 ```
101 <Tabs>
102 <Tab title="Gradle">
103 ```kotlin
104 implementation("com.anthropic:anthropic-java:3.4.0")
105 ```
106 </Tab>
105107
106 ```xml Maven
107 <dependency>
108 <groupId>com.anthropic</groupId>
109 <artifactId>anthropic-java</artifactId>
110 <version>3.4.0</version>
111 </dependency>
112 ```
113 </CodeGroup>
108 <Tab title="Maven">
109 ```xml
110 <dependency>
111 <groupId>com.anthropic</groupId>
112 <artifactId>anthropic-java</artifactId>
113 <version>3.4.0</version>
114 </dependency>
115 ```
116 </Tab>
117 </Tabs>
114118
115119 If your application doesn’t use the OpenTelemetry SDK yet, install it with a console exporter, which you use in the next step to print spans. Add `io.opentelemetry:opentelemetry-sdk` and `io.opentelemetry:opentelemetry-exporter-logging` to your build, both at the latest version on [Maven Central](https://central.sonatype.com/artifact/io.opentelemetry/opentelemetry-sdk).
116120 </Tab>
managed-agents/quickstart Changed · +106 / -24 lines
## Before you begin ## Prerequisites ## Install the CLI
from line 52
5252| **Session** | A running agent instance within an environment, performing a specific task and generating outputs |
5353| **Events** | Messages exchanged between your application and the agent (user turns, tool results, status updates) |
5454
55## Prerequisites
55## Before you begin
5656
57* A [Claude Console account](https://platform.claude.com/)
58* An [API key](https://platform.claude.com/settings/keys) from the Console
57<Steps continues>
58 <Step title="Create a Claude Console account">
59 [Sign up](https://platform.claude.com/) for a Claude Console account, or sign in to the one you have.
60 </Step>
5961
60## Install the CLI
62 <Step title="Choose how to authenticate">
63 Signing in with the CLI is recommended for local development.
6164
62<Tabs>
65 Follow the steps for one of the following options.
66 </Step>
67</Steps>
68
69**CLI**
70
71<Steps continued>
72 <Step title="Install the CLI" stepNumber={3}>
73 <Tabs noDeepLinks>
74 <Tab title="Homebrew (macOS)">
75 ```bash
76 brew install anthropics/tap/ant
77 ```
78 </Tab>
79
80 <Tab title="curl (Linux/WSL)">
81 For Linux environments, download the release binary directly.
82
83 ```bash
84 VERSION=2.5.0
85 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
86 case $(uname -m) in
87 x86_64) ARCH=amd64 ;;
88 aarch64) ARCH=arm64 ;;
89 esac
90 curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
91 | sudo tar -xz -C /usr/local/bin ant
92 ```
93
94 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
95 </Tab>
96
97 <Tab title="go install">
98 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
99
100 ```bash
101 go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
102 ```
103
104 The binary is placed in `$(go env GOPATH)/bin`. Add it to your `PATH` if it isn’t already:
105
106 ```bash
107 export PATH="$PATH:$(go env GOPATH)/bin"
108 ```
109 </Tab>
110 </Tabs>
111 </Step>
112
113 <Step title="Sign in" stepNumber={4}>
114 ```bash
115 ant auth login
116 ```
117
118 Once login is completed, the SDKs and CLI will pick up your credentials automatically.
119 </Step>
120</Steps>
121
122**API key**
123
124<Steps continued>
125 <Step title="Create an API key" stepNumber={3}>
126 Create an [API key](https://platform.claude.com/settings/keys) in the Claude Console.
127 </Step>
128
129 <Step title="Set the environment variable" stepNumber={4}>
130 The SDKs and CLI read your key from `ANTHROPIC_API_KEY`:
131
132 ```bash
133 export ANTHROPIC_API_KEY="your-api-key-here"
134 ```
135 </Step>
136</Steps>
137
138**API key**
139
140To run the CLI examples, install the CLI:
141
142<Tabs noDeepLinks>
63143 <Tab title="Homebrew (macOS)">
64144 ```bash
65145 brew install anthropics/tap/ant
from line 163
83163 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
84164 </Tab>
85165
86 <Tab title="Go">
166 <Tab title="go install">
87167 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
88168
89169 ```bash
from line 178
98178 </Tab>
99179</Tabs>
100180
101Check the installation:
102
103```bash
104ant --version
105```
106
107181## Install the SDK
108182
109183<Tabs>
from line 194
120194 </Tab>
121195
122196 <Tab title="Java">
123 ```groovy Gradle
124 implementation("com.anthropic:anthropic-java:3.4.0")
125 ```
197 <Tabs>
198 <Tab title="Gradle">
199 ```kotlin
200 implementation("com.anthropic:anthropic-java:3.4.0")
201 ```
202 </Tab>
203
204 <Tab title="Maven">
205 ```xml
206 <dependency>
207 <groupId>com.anthropic</groupId>
208 <artifactId>anthropic-java</artifactId>
209 <version>3.4.0</version>
210 </dependency>
211 ```
212 </Tab>
213 </Tabs>
126214 </Tab>
127215
128216 <Tab title="Go">
from line 237
149237 ```
150238 </Tab>
151239</Tabs>
152
153Set your API key as an environment variable:
154
155```bash
156export ANTHROPIC_API_KEY="your-api-key-here"
157```
158240
159241## Create your first session
160242
models/opus-5-5/overview Changed · +1 / -10 lines
from line 16
1616
1717## Overview
1818
19Claude Opus 5.5 is built for long-running agentic coding and knowledge work, priced at $4 / $20 USD per million input / output tokens. Four breaking changes can affect code already running on Claude Opus 5:
20
21* [Thinking can’t be disabled](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled).
22* [Forced tool use returns an error](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#forced-tool-use-is-not-supported).
23* [Thinking blocks are tied to the model and the conversation](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them).
24* [Some computer use tool versions are not supported](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported).
25
26The first three also apply on Claude Fable 5.1. A further change alters the response shape without failing any request: [text between tool calls comes back in `thinking` blocks](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#text-between-tool-calls) whose text is empty at the default `display` setting. An application that streams that text to its users as progress updates goes quiet between tool calls until it sets a `display` value that returns the text.
27
28[What’s new in Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5)
19Claude Opus 5.5 is built for long-running agentic coding and knowledge work. Typical uses include multihour autonomous coding agents, large-scale refactoring, complex systems engineering, vision-heavy workflows, and computer use.
2920
3021## How it compares
3122
models/sonnet-5-5/overview Changed · +1 / -11 lines
from line 16
1616
1717## Overview
1818
19Claude Sonnet 5.5 offers the best combination of speed and intelligence. Five breaking changes can affect code already running on Claude Sonnet 5:
20
21* [Turn off up-front thinking with `between_tools`](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking).
22* [Forced tool use returns an error](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5#forced-tool-use-is-not-supported).
23* [Thinking blocks are tied to the model and the conversation](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them).
24* [Some computer use tool versions are not supported](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5#computer-20251124-is-not-supported).
25* [The advisor tool rejects four models as advisors](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings): Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5, and Claude Haiku 5.5.
26
27One more change alters the response shape without failing any request: [text between tool calls comes back in `thinking` blocks](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5#text-between-tool-calls). An application that streams that text to its users goes quiet between tool calls until it sets a `display` value that returns the text, or turns off up-front thinking with `between_tools`.
28
29[What’s new in Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5)
19Claude Sonnet 5.5 offers the best combination of speed and intelligence. It’s built for everyday coding, agent, and enterprise workloads, such as code generation, data analysis, content creation, visual understanding, and agentic tool use.
3020
3121## How it compares
3222
about-claude/api-credits-for-subscribers Changed · +1 / -1 lines
from line 131
131131| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
132132| Cancel, downgrade to an ineligible plan, or refund | New credits stop when your plan ends. Credits you already have stay usable until they expire. |
133133| Upgrade from Max to Ultra | You receive prorated API credits right away, then $200 USD each billing cycle. If you subscribe through Google Play, the $200 USD credit arrives later, by your next renewal at the latest. |
134| Upgrade from Max or Ultra to Team | The link to your Max or Ultra plan ends. A Team owner can claim the team's credits after the Team plan has been active for 7 days. |
134| Upgrade from Max or Ultra to Team | The link to your Max or Ultra plan ends. A Team owner can claim the team’s credits after the Team plan has been active for 7 days. |
135135| Add or remove Team seats | Seats added to your plan count from the next billing month’s credit. Seats you remove stay on your plan until it renews, so the credit might be lower after that. The pool stays capped at $500 USD. |
136136
137137## Use your credits efficiently
agents-and-tools/agent-skills/overview Changed · +1 / -1 lines
from line 208
208208
209209**Pre-built Agent Skills:** These Skills are active when you create documents. Claude uses them with no setup required.
210210
211**Custom Skills:** Upload your own Skills as zip files through Settings > Features. Available on Pro, Max, Ultra, Team, and Enterprise plans with [code execution enabled](https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude). Custom Skills are individual to each user. They are not shared organization-wide and cannot be centrally managed by admins.
211**Custom Skills:** Upload your own Skills as zip files through **Settings > Features**. Available on Pro, Max, Ultra, Team, and Enterprise plans with [code execution enabled](https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude). Custom Skills are individual to each user. They are not shared organization-wide and cannot be centrally managed by admins.
212212
213213To learn more about using Skills in claude.ai, see the following resources in the Claude Help Center:
214214
cli-sdks-libraries/cli/quickstart Changed · +2 / -2 lines
from line 21
2121
2222## Installation
2323
24<Tabs>
24<Tabs noDeepLinks>
2525 <Tab title="Homebrew (macOS)">
2626 ```bash
2727 brew install anthropics/tap/ant
from line 45
4545 You can find all releases on the [GitHub releases page](https://github.com/anthropics/anthropic-cli/releases).
4646 </Tab>
4747
48 <Tab title="Go">
48 <Tab title="go install">
4949 You can also install the CLI from source using `go install`. Requires Go 1.25 or later.
5050
5151 ```bash
cli-sdks-libraries/sdks/csharp Changed · +3 / -0 lines
from line 118
118118
119119```csharp
120120using System;
121using Anthropic;
121122using Anthropic.Models.Messages;
123
124AnthropicClient client = new();
122125
123126MessageCreateParams parameters = new()
124127{
cli-sdks-libraries/sdks/python Changed · +3 / -1 lines
from line 506
506506first_page = await client.messages.batches.list(limit=20)
507507
508508if first_page.has_next_page():
509 print(f"will fetch next page using these details: {first_page.next_page_info()}")
509 print(
510 f"will fetch next page using these details: {first_page.next_page_info()}"
511 )
510512 next_page = await first_page.get_next_page()
511513 print(f"number of items we just fetched: {len(next_page.data)}")
512514
manage-claude/api-and-data-retention Changed · +1 / -1 lines
from line 35
3535
3636* **Claude Console:** Any usage in the Claude Console, including playground.
3737* **Claude Managed Agents:** Claude Managed Agents is a stateful resource; session transcripts persist until you delete them.
38* **Claude consumer products:** Claude Free, Pro, Max, and Ultra plans, including when customers on those plans use Claude's web, desktop, or mobile apps or Claude Code.
38* **Claude consumer products:** Claude Free, Pro, Max, and Ultra plans, including when customers on those plans use Claude’s web, desktop, or mobile apps or Claude Code.
3939* **Claude Teams and Claude Enterprise product interfaces:** These interfaces are not ZDR-eligible. The one exception is Claude Code on Claude Enterprise, which has its own ZDR offering, separate from the ZDR arrangement described on this page. That offering is available only to qualified accounts on Claude Enterprise and requires separate enablement by Anthropic. See the [Claude Code ZDR documentation](https://code.claude.com/docs/en/zero-data-retention), which applies to Claude Enterprise organizations only.
4040* **Claude for Excel:** Not currently ZDR-eligible.
4141* **Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, and Claude Mythos 5:** These models require 30-day data retention and are not available under ZDR unless expressly authorized by Anthropic. See [Model-specific data retention requirements](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements).
manage-claude/wif-providers/aws Changed · +1 / -1 lines
from line 494
494494 <Step title="Find your cluster’s OIDC issuer URL">
495495 Each EKS cluster has a unique OIDC issuer. Retrieve it with the AWS CLI:
496496
497 ```bash CLI
497 ```bash
498498 aws eks describe-cluster \
499499 --name <cluster-name> \
500500 --query "cluster.identity.oidc.issuer" \
manage-claude/wif-providers/gcp Changed · +2 / -2 lines
from line 23
2323 <Tab title="Cloud Run, Cloud Functions, App Engine, GCE">
2424 Attach a dedicated service account to your service or instance:
2525
26 ```bash CLI
26 ```bash
2727 gcloud run deploy my-service \
2929 ```
from line 37
3737
3838 Or, with the gcloud CLI:
3939
40 ```bash CLI
40 ```bash
4141 gcloud auth print-identity-token \
4242 --audiences="https://api.anthropic.com" \
4343 --include-email
manage-claude/wif-providers/kubernetes Changed · +2 / -2 lines
from line 6
66
77Self-managed Kubernetes clusters (kubeadm, k3s, OpenShift, and on-premise distributions) sign OIDC JSON Web Tokens (JWTs) for every pod through [projected service account tokens](https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#serviceaccount-token-volume-projection). The cluster’s API server acts as the OIDC issuer, and each token’s `sub` claim follows the form `system:serviceaccount:<namespace>:<service-account>`. You can find your cluster’s issuer URL by reading its discovery document:
88
9```bash cURL
9```bash
1010kubectl get --raw /.well-known/openid-configuration | jq -r .issuer
1111```
1212
from line 77
7777
7878**Federation issuer:** Many self-managed clusters use an issuer URL such as `https://kubernetes.default.svc.cluster.local` that is not reachable from the public internet. If that applies to your cluster, choose the **inline** JWKS source and paste the cluster’s keys. Fetch them from inside the cluster:
7979
80```bash cURL
80```bash
8181kubectl get --raw /openid/v1/jwks
8282```
8383
manage-claude/wif-providers/spiffe Changed · +2 / -2 lines
from line 87
8787
8888Each workload that calls the Claude API needs a SPIRE registration entry that maps its runtime selectors to a SPIFFE ID. If the workload is already registered, note its SPIFFE ID, which you use in the federation rule’s `subject_prefix`. If not, register it. For a Kubernetes pod, the selectors are typically the namespace and Kubernetes service account:
8989
90```bash CLI
90```bash
9191# Replace NODE_UID with the node's UID:
9292# kubectl get node <node-name> -o jsonpath='{.metadata.uid}'
9393spire-server entry create \
from line 457
457457 The Workload API attests the calling process. For a Kubernetes registration entry, run this command inside a pod that satisfies the entry’s selectors and has the agent socket mounted (for example, by using `kubectl exec`). On VMs and bare metal, run it as the user or process that matches the entry’s `unix:` selectors. Running from an unattested host shell returns `no identity issued`, which is the most common verify-step failure.
458458</Note>
459459
460```bash CLI
460```bash
461461spire-agent api fetch jwt \
462462 -audience https://api.anthropic.com \
463463 -socketPath /run/spire/sockets/agent.sock \
manage-claude/wif-reference Changed · +1 / -1 lines
from line 258
258258 <Step title="Decode the JWT">
259259 Decode the assertion you sent so you can compare each claim against your issuer and rule configuration:
260260
261 ```bash cURL
261 ```bash
262262 jq -rR 'split(".")[1] | gsub("-";"+") | gsub("_";"/") | @base64d | fromjson' <<< "$JWT"
263263 ```
264264 </Step>
managed-agents/agent-setup Changed · +1 / -1 lines
from line 54
5454
5555The following example defines a coding agent that uses the newest Claude Opus model with access to the pre-built agent toolset. The toolset lets the agent write code, read files, search the web, and more. See the [agent tools reference](https://platform.claude.com/docs/en/managed-agents/tools) for the full list of supported tools.
5656
57The examples use curl, the `ant` CLI, or the SDK. If you haven’t set one up, the [quickstart](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-cli) covers installation and client setup.
57The examples use curl, the `ant` CLI, or the SDK. If you haven’t set one up, the [quickstart](https://platform.claude.com/docs/en/managed-agents/quickstart#before-you-begin) covers installation and client setup.
5858
5959<CodeGroup defaultLanguage="CLI">
6060 ```bash cURL