1,488 pages for read.

extended-thinking Claude Developer Platform · in the page build-with-claude/extended-thinking …akdown appears only on the final `message_delta` event. When you are ready to move off manual budgets, see [Migrating to adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/exten… fallback-credit Claude Developer Platform · in the page build-with-claude/fallback-credit …s a request and you retry on another model, the conversation prefix already cached for the first model must be written into the new model's cache in full. Cache writes cost more than cache reads. Fall… files Claude Developer Platform · in the page build-with-claude/files …urces: a user-supplied file ID would let one user of your application read content that another user uploaded. Treat file IDs as server-side references, and keep the mapping between your users and the… handling-stop-reasons Claude Developer Platform · in the page build-with-claude/handling-stop-reasons …| Claude emitted one of your `stop_sequences`. | Read `stop_sequence` to see which one fired.… mid-conversation-effort-example Claude Developer Platform · in the page build-with-claude/mid-conversation-effort-example …shutil import subprocess import sys import tempfile import threading import anthropic client = anthropic.Anthropic() MODEL = "claude-opus-5-5" EFFORT = "xhigh" SYSTEM_PROMPT = (… mid-conversation-system-messages Claude Developer Platform · in the page build-with-claude/mid-conversation-system-messages …m` field. The cached prefix stays the same, so the next request still reads it from cache, and the new instruction is still applied as a system instruction rather than as ordinary user text. <Note>… overview Claude Developer Platform · in the page build-with-claude/overview …with-claude/overview#tools). Return to the other sections when you're ready to optimize cost, latency, or scale. For administration and governance, see the [Admin API](https://platform.claude.com/doc… pdf-support Claude Developer Platform · in the page build-with-claude/pdf-support …ment.pdf", "rb") as f: # pdf_data = base64.standard_b64encode(f.read()).decode("utf-8") # Send to Claude using base64 encoding client = anthropic.Anthropic() message = client.messages.cre… preserved-thinking Claude Developer Platform · in the page build-with-claude/preserved-thinking …API checks the block's `signature` for two things: * **The model can read the block.** Each model reads its own thinking blocks and those of a fixed set of other models. Claude Fable 5.1 reads blocks… Request 2 caches its request content (not the response) Claude Developer Platform · in the page build-with-claude/prompt-caching …m checks if a prompt prefix, up to a specified cache breakpoint, is already cached from a recent query. 2. If found, it uses the cached version, reducing processing time and costs. 3. Otherwise, it pr… claude-prompting-best-practices Claude Developer Platform · in the page build-with-claude/prompt-engineering/claude-prompting-best-practices …l-specific guidance Each of these models has its own prompting page. Read the one for your model first, then the techniques that follow. | Model | Guide… overview Claude Developer Platform · in the page build-with-claude/prompt-engineering/overview …heets prompting tutorial" icon="link" href="https://docs.google.com/spreadsheets/d/19jzLgRruG9kjUQNKtCg1ZjdD6l6weA6qRXG5zLIAhC8"> A lighter-weight version of the prompt engineering tutorial, as an… prompting-claude-fable-5 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-fable-5 …cope, and produces professional-grade output on financial analysis, spreadsheets, slides, and documents. * **Code review and debugging.** Bug-finding recall (outside the cybersecurity domains the safe… Delivering work Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-fable-5-1 …before the work is done, or the model asks permission for work you already requested: [Finish the whole task](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude… prompting-claude-opus-4-8 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-opus-4-8 …directly in a single response (e.g. refactoring a function you can already see). Spawn multiple subagents in the same turn when fanning out across items or reading multiple files. ``` ## Design and… prompting-claude-opus-5 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-opus-5 …tasks:** Claude Opus 5 generates and works with complex, multisheet spreadsheets with non-trivial formulas, and it produces well-structured slide decks. Prompt it with any specific styles or templates… prompting-claude-opus-5-5 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-opus-5-5 …are easy to miss in large inputs, such as a date in a long planning thread that falls on the wrong weekday or a chart in a slide deck that doesn't match the underlying figures. The spreadsheets, slide… prompting-claude-sonnet-5 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-sonnet-5 …y default and reaches for tools and runs self-verification loops more readily. With thinking disabled, the model is less likely to reach for tools or consider searching; if you rely on tool calls with… prompting-claude-sonnet-5-5 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5 …ly that the model writes internal XML tags in its visible output. * **Read the response by block type.** With adaptive thinking, a response can start with a `thinking` block, whose `thinking` field is… refusals-and-fallback Claude Developer Platform · in the page build-with-claude/refusals-and-fallback …e shows you how to recognize a refusal and how to set up that retry. Read this page when you build on any of these models and want declined requests to fall through to another model automatically. It… search-results Claude Developer Platform · in the page build-with-claude/search-results …op-level search (Method 2) * **Pre-fetched content:** Use when you already have search results * **Batch processing:** Use for processing multiple search results at once * **Testing:** Use for testin… skills-guide Claude Developer Platform · in the page build-with-claude/skills-guide …look at the architecture and real-world applications of Agent Skills, read the engineering blog post: [Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equi… streaming Claude Developer Platform · in the page build-with-claude/streaming …l,"usage":{"input_tokens":2679,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":3}}} event: content_block_start data: {"type":"content_block_start","index":0,"content_block… structured-outputs Claude Developer Platform · in the page build-with-claude/structured-outputs …son_schema"`. SDK helpers set this for you. </Step> <Step title="Read the response"> Claude returns valid JSON that matches your schema in the response's text content block. SDK helpers parse… task-budgets Claude Developer Platform · in the page build-with-claude/task-budgets …The two are complementary: effort tunes depth, and task budgets tune breadth. * **[Adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking):** Task budgets include thinking t… thinking Claude Developer Platform · in the page build-with-claude/thinking …ing description: "Understand how Claude's thinking works: turn it on, read thinking output, steer thinking depth with effort, and use thinking with tools, caching, and streaming." --- <Note> To lea… thinking-steering-and-cost Claude Developer Platform · in the page build-with-claude/thinking-steering-and-cost …aries from step to step. To learn how to turn thinking on and how to read thinking output, see the [Thinking](https://platform.claude.com/docs/en/build-with-claude/thinking) overview. This page cover… thinking-tool-workflows Claude Developer Platform · in the page build-with-claude/thinking-tool-workflows …uts continuation ``` </CodeGroup> </Step> <Step title="Read the final response"> You should see Claude complete the turn with text. Because [interleaved thinking](https://platform.c… thinking-troubleshooting Claude Developer Platform · in the page build-with-claude/thinking-troubleshooting …"` is not supported The request fails with a 400 error whose message reads: ```text wrap "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effo… token-counting Claude Developer Platform · in the page build-with-claude/token-counting …log(response); ``` ```csharp C# using System; using System.Threading.Tasks; using Anthropic; using Anthropic.Models.Messages; AnthropicClient client = new(); var parameters = new Me… vision Claude Developer Platform · in the page build-with-claude/vision …load = await anthropic.files.upload({ file: await toFile(fs.createReadStream("vision-example.jpg"), undefined, { type: "image/jpeg" }) }); // Use the uploaded file in a message co… vision-coordinates Claude Developer Platform · in the page build-with-claude/vision-coordinates …malize in your own code if you need to. To get coordinates as machine-readable JSON instead of prose, define a schema with [structured outputs](https://platform.claude.com/docs/en/build-with-claude/st… working-with-messages Claude Developer Platform · in the page build-with-claude/working-with-messages …_tokens": 42, "output_tokens": 1 } } ``` ## Vision Claude can read both text and images in requests. You can supply images using the `base64`, `url`, or `file` source types. The `file` source… API usage primer for Claude Claude Developer Platform · in the page claude_api_primer …t(message.content[0].text) ``` </CodeGroup> ### Vision Claude can read both text and images in requests. Both `base64` and `url` source types are supported for images, along with the `image/jpeg`,… apply Claude Developer Platform · in the page cli-sdks-libraries/cli/apply …ds these resources instead of creating them again, and it's where you read an agent's ID to [start a session](https://platform.claude.com/docs/en/managed-agents/sessions). The two hashes fingerprint w… On a remote host without a browser: Claude Developer Platform · in the page cli-sdks-libraries/cli/authentication …ne commands never run with elevated access. ## API key The CLI also reads your API key from the `ANTHROPIC_API_KEY` environment variable. Get a key from the [Claude Console](https://platform.claude.… quickstart Claude Developer Platform · in the page cli-sdks-libraries/cli/quickstart …placed in `$(go env GOPATH)/bin`. Add it to your `PATH` if it isn't already: ```bash export PATH="$PATH:$(go env GOPATH)/bin" ``` </Tab> </Tabs> Check the installation: ```bash ant --… scripting Claude Developer Platform · in the page cli-sdks-libraries/cli/scripting …and environment IDs to the session create command. After `ant apply`, read them from `claude-lock.json`: each entry under `resources` has an `id`, and for the project in [Manage resources as code with… sessions-connect Claude Developer Platform · in the page cli-sdks-libraries/cli/sessions-connect …ent-orchestration) sessions, the view follows the session's primary thread, which includes the messages exchanged between the agent that the session runs and the agents it delegates to. | Key… using Claude Developer Platform · in the page cli-sdks-libraries/cli/using …| | `--api-key-stdin` | Read the API key from standard input. The flag reads all of standard input, so pass the request body with [flags](https://platform… openai-sdk Claude Developer Platform · in the page cli-sdks-libraries/libraries/openai-sdk …e model capabilities, and is not considered a long-term or production-ready solution for most use cases. Although it is intended to remain fully functional and not have breaking changes, the priority… csharp Claude Developer Platform · in the page cli-sdks-libraries/sdks/csharp …odified client configuration, while reusing the same connection and thread pools, call `WithOptions` on any client or service: ```csharp using System; var message = await client .WithOptions(opt… go Claude Developer Platform · in the page cli-sdks-libraries/sdks/go …hat correspond to file uploads in multipart requests are typed as `io.Reader`. The contents of the `io.Reader` are sent by default as a multipart form part with the file name of `anonymous_file` and c… java Claude Developer Platform · in the page cli-sdks-libraries/sdks/java …ient in the same application. Each client has a connection pool and thread pools, which are more efficient to share between requests. </Tip> ### Modifying configuration To temporarily use a modified… php Claude Developer Platform · in the page cli-sdks-libraries/sdks/php …properties You can send undocumented parameters to any endpoint, and read undocumented response properties, as follows: <Note> The `extra*` parameters of the same name override the documented para… For Amazon Bedrock support Claude Developer Platform · in the page cli-sdks-libraries/sdks/python …e interface. If you pass a `PathLike` instance, the file contents are read asynchronously automatically. ## Handling errors When the library is unable to connect to the API, or if the API returns a… Automatically handles tool execution loop Claude Developer Platform · in the page cli-sdks-libraries/sdks/ruby …StringIO` directly: file_metadata = anthropic.files.upload(file: File.read("/path/to/file")) # Or, to control the file name, the content type, or both: file = Anthropic::FilePart.new(File.read("/path… typescript Claude Developer Platform · in the page cli-sdks-libraries/sdks/typescript …t); // Use MCP resources as content const resource = await mcpClient.readResource({ uri: "file:///path/to/doc.txt" }); await anthropic.beta.messages.create({ model: "claude-opus-5-5", max_tokens:… get-api-key Claude Developer Platform · in the page get-api-key …SDK](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) reads `ANTHROPIC_API_KEY` automatically. Direct HTTP requests send the key as `Authorization: Bearer <key>`. If your API key isn't… get-started Claude Developer Platform · in the page get-started …ey as an environment variable. The cURL command in the following step reads it from `$ANTHROPIC_API_KEY`. ```bash export ANTHROPIC_API_KEY="your-api-key-here" ``` </Step…