Claude Opus 5
Claude Opus 5 is the latest model in Anthropic's Opus family, with gains over Claude Opus 4.8 in agentic coding, professional knowledge work, and long-horizon reasoning. Claude Opus 5 is available on AI Gateway via Anthropic, Bedrock, Google Vertex AI, Claude Platform on AWS with reasoning on by default and configurable effort.
View API reference- Input and output price
- Prices from: Input $5, Output $25, Per 1M tokens
- 24h uptime
- Loading AI Gateway uptime
import { streamText } from 'ai'
const result = streamText({ model: 'anthropic/claude-opus-5', prompt: 'Why is the sky blue?'})Copy link to headingPlayground
Try out Claude Opus 5 by Anthropic. Usage is billed to your team at API rates. Free users (those who haven't made a payment) get $5 of credits every 30 days.
Claude Opus 5
Copy link to headingProviders
Route requests across multiple providers. Copy a provider slug to set your preference. Visit the docs for more info. Using a provider means you agree to their terms, listed under Legal.
| Provider |
|---|
Copy link to headingUptime24 hours
Direct request success rate on AI Gateway and per-provider. Visit the docs for more info.
Copy link to headingThroughput24 hours
P50 throughput on live AI Gateway traffic, in tokens per second (TPS). Visit the docs for more info.
Copy link to headingLatency24 hours
P50 time to first token (TTFT) on live AI Gateway traffic, in milliseconds. View the docs for more info.
Getting started
Call Claude Opus 5 through AI Gateway with the AI SDK generateText and streamText functions, or through the OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages APIs by changing the base URL. AI Gateway authenticates the request and routes it to an available provider.
Install the AI SDK (pnpm add ai dotenv), create an API key from the API Keys page, and set it as AI_GATEWAY_API_KEY in your environment. Full setup is covered in the text generation quickstart.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', prompt: 'Why is the sky blue?', });
console.log(result.text);}
main().catch(console.error);Top-level parameters
The same Claude Opus 5 request in each API format AI Gateway supports.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', system: 'You are a concise technical assistant.', prompt: 'Summarize the tradeoffs between static generation and SSR.', maxOutputTokens: 1024, });
console.log(result.text);}
main().catch(console.error);Standard parameters like prompt, messages, temperature, and tools work as documented in the AI SDK docs. These are the parameters with model-specific behavior.
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model ID in the form creator/model, e.g. anthropic/claude-opus-5. AI Gateway routes the request to an available provider. |
maxOutputTokens | number | No | Hard cap on generated tokens. Claude Opus 5 supports up to 128,000 output tokens. Reasoning tokens count toward this limit. |
reasoning | 'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | No | Provider-agnostic reasoning effort, available in AI SDK 7 or later. Maps to the provider’s native reasoning configuration; reasoning settings under providerOptions take precedence when both are set. See the Reasoning section below. |
providerOptions | Record<string, JSONValue> | No | AI Gateway routing options under gateway, plus any provider-native options under the provider’s own namespace — see the table below. |
Input limits
| Input | Formats | Sources | Max count | Max size | Limits |
|---|---|---|---|---|---|
| Text | — | — | — | — | Prompt and response share the 1M-token context window |
| Image | — | URL, base64, Uint8Array | — | — | Sent as image parts in messages; counts as input tokens |
| — | URL, base64, Uint8Array | — | — | Sent as file parts in messages; counts as input tokens |
Provider options
Set AI Gateway routing options under providerOptions.gateway. For provider-specific options, pass them under the provider’s namespace as documented by the AI SDK.
Learn more in the AI SDK anthropic provider docs.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', prompt: 'Why is the sky blue?', providerOptions: { gateway: { only: ['anthropic', 'bedrock'], }, }, });
console.log(result.text);}
main().catch(console.error);These AI Gateway routing options apply to every model. Provider-specific options pass through under the provider’s own namespace (for example providerOptions.anthropic) exactly as documented by the AI SDK.
| Parameter | Type | Required | Description |
|---|---|---|---|
providerOptions.gateway.only | string[] | No | Restrict routing to these provider slugs. Requests fail over only within the listed providers. |
providerOptions.gateway.order | string[] | No | Preferred provider order. Listed providers are tried first; unlisted providers remain available as fallbacks. |
providerOptions.gateway.sort | 'cost' | 'ttft' | 'tps' | No | Rank candidate providers by price, time to first token, or tokens per second instead of the default routing order. |
providerOptions.gateway.zeroDataRetention | boolean | No | Route only to providers with a zero-data-retention policy for this model. |
Routing across providers
AI Gateway serves the same model through multiple providers and fails over automatically. order expresses a preference while keeping every provider eligible; only is a hard allowlist — if none of the listed providers are available the request fails instead of falling back.
Options under a provider's own namespace (for example providerOptions.anthropic) are forwarded to that provider with the request. Providers ignore option namespaces that don't apply to them, so it is safe to set provider options alongside gateway routing options.
Reasoning
AI Gateway bridges reasoning across every API format. The AI SDK exposes a provider-agnostic top-level reasoning level (none, minimal, low, medium, high, or xhigh); the Chat Completions and Responses formats take the same effort under reasoning.effort; and the Anthropic Messages format uses a native thinking token budget. Whichever you send, the gateway maps it to the target model’s native configuration, converting between effort levels and token budgets as needed. Reasoning-related settings under providerOptions take full precedence over the top-level reasoning value and are never merged. Reasoning tokens typically count toward your output-token usage, though how they’re reported and billed varies by provider.
Learn more in the AI Gateway reasoning guide.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', prompt: 'Explain the Monty Hall problem step by step.', reasoning: 'high', });
console.log(result.text);}
main().catch(console.error);Image input
Send images alongside text as message parts. Images count as input tokens.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', messages: [ { role: 'user', content: [ { type: 'text', text: 'Describe this image.' }, { type: 'image', image: 'https://example.com/photo.jpg' }, ], }, ], });
console.log(result.text);}
main().catch(console.error);PDF input
Attach PDFs as file parts. Their contents count as input tokens.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', messages: [ { role: 'user', content: [ { type: 'text', text: 'Summarize this document.' }, { type: 'file', mediaType: 'application/pdf', data: 'https://example.com/document.pdf', }, ], }, ], });
console.log(result.text);}
main().catch(console.error);Tool calling
Expose tools the model can call. Define each tool’s inputs with a Zod schema.
import { generateText, tool } from 'ai';import { z } from 'zod';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5', prompt: 'What is the weather in San Francisco?', tools: { getWeather: tool({ description: 'Get the current weather for a location', inputSchema: z.object({ location: z.string() }), execute: async ({ location }) => ({ location, temperatureC: 18 }), }), }, });
console.log(result.text);}
main().catch(console.error);Fast mode
Claude Opus 5 can run in fast mode for lower latency by appending -fast to the model ID.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'anthropic/claude-opus-5-fast', prompt: 'Why is the sky blue?', });
console.log(result.text);}
main().catch(console.error);Copy link to headingAbout Claude Opus 5
Claude Opus 5 became available on AI Gateway on July 24, 2026 as the latest model in Anthropic's Opus family. Claude Opus 5 improves on Claude Opus 4.8 in agentic coding, professional knowledge work, and long-horizon reasoning. The coding gains show up on multi-file features, larger refactors, and end-to-end feature work, where Claude Opus 5 completes full tasks rather than leaving stubs or placeholders behind.
Reasoning is on by default. In AI SDK 7, set the depth with the top-level reasoning option, from minimal up to xhigh, or none to turn reasoning off. Claude Opus 5 is effective at low and medium effort, which produce quality output while spending fewer tokens than higher settings, so mixed workloads don't need to run at the top of the range.
Vision is stronger on charts, documents, diagrams, and UI replication. Claude Opus 5 uses tools to analyze, crop, and verify visual work, which helps on tasks that pair screenshots or design files with code. Claude Opus 5 also coordinates teams of subagents well, which suits multi-agent pipelines that need one model to plan and delegate.
Elevated cybersecurity safeguards ship with Claude Opus 5, matching Claude Fable 5. Benign security work can occasionally trigger a safety classifier and get blocked. Add a backstop by listing backup models such as Claude Opus 4.8 and Claude Sonnet 5 in a models array under providerOptions.gateway. AI Gateway tries them in order when the primary model fails, and the option works across every AI Gateway API format. Fast mode is available separately: pass speed: 'fast' under providerOptions.anthropic.
Through AI Gateway, Claude Opus 5 is available with the standard unified API, observability, retries, and failover across Anthropic, Bedrock, Google Vertex AI, Claude Platform on AWS. Set the model to anthropic/claude-opus-5 in the AI SDK, Chat Completions API, Responses API, Messages API, or other API formats, from TypeScript or Python. AI Gateway mirrors provider pricing with no markup and adds no platform fee on inference, including for Bring Your Own Key requests.
Copy link to headingWhat To Consider When Choosing a Provider
- Configuration: Reasoning is on by default, and Claude Opus 5 works well at low and medium effort, which spend fewer tokens than higher settings. Start low and raise the effort level only where output quality falls short.
- Configuration: Claude Opus 5 ships with elevated cybersecurity safeguards, so benign security work can occasionally trigger a safety classifier and get blocked. List backup models in a
modelsarray underproviderOptions.gateway, and AI Gateway tries them in order when the primary model fails. - Zero Data Retention: Zero Data Retention is available for this model. It is offered on a per-provider and model basis. See the documentation for details.
- Authentication: AI Gateway authenticates requests using an API key or OIDC token. You do not need to manage provider credentials directly.
Copy link to headingWhen to Use Claude Opus 5
Best for
- Long-Horizon Agentic Coding: Multi-file features, larger refactors, and end-to-end work spanning many turns
- Complete Task Execution: Finished implementations instead of stubs and placeholder code left for a human
- Visual and Document Analysis: Charts, diagrams, documents, and UI replication where the model inspects images with tools
- Multi-Agent Orchestration: Subagent teams that each own part of a larger task and report back
- Cost-Aware Reasoning Depth: Low and medium effort cover most requests before you reach for higher settings
Consider alternatives when
- Cost-Sensitive Production Traffic: Claude Sonnet 5 delivers strong agentic performance at a lower per-token price
- Latency-Critical Simple Requests: Claude Haiku 4.5 is faster and cheaper on well-bounded, high-throughput calls
- Simpler Refusal Handling: Models without elevated cybersecurity safeguards keep fallback configuration out of your integration
Copy link to headingConclusion
Claude Opus 5 extends the Opus family toward agentic coding that finishes the job: multi-file features, larger refactors, and end-to-end work. Start at low or medium effort, raise it where quality gaps appear, and configure model fallbacks so blocked security requests still return an answer.
Copy link to headingFrequently Asked Questions
What is Claude Opus 5 built for?
Claude Opus 5 is built for long-horizon agentic coding. Claude Opus 5 handles multi-file features, larger refactors, and end-to-end feature work, and it completes full tasks rather than leaving stubs or placeholders. Anthropic also reports gains over Claude Opus 4.8 in professional knowledge work and long-horizon reasoning.
How do I set the reasoning effort for Claude Opus 5?
Reasoning is on by default. In AI SDK 7, set the top-level
reasoningoption to a level fromminimalup toxhigh, or tononeto turn reasoning off.Which effort level should I start with on Claude Opus 5?
Start at low or medium. Claude Opus 5 is effective at both, and they produce quality output while spending fewer tokens than higher settings. Raise the effort level for the requests where output quality falls short.
What improved in vision on Claude Opus 5?
Charts, documents, diagrams, and UI replication. Claude Opus 5 also uses tools to analyze, crop, and verify visual work, which suits tasks that pair screenshots or design files with code changes.
How do I enable fast mode for Claude Opus 5?
Pass
speed: 'fast'in theanthropicprovider options. In the AI SDK, setproviderOptions.anthropic.speedto'fast'on the request.What happens when a safety classifier blocks a request to Claude Opus 5?
The request fails, and AI Gateway falls back to the next model you configured. Claude Opus 5 ships with elevated cybersecurity safeguards, so benign security work can occasionally trigger a classifier. List backup models such as Claude Opus 4.8 and Claude Sonnet 5 in a
modelsarray underproviderOptions.gateway. The option works across every AI Gateway API format.Which providers back Claude Opus 5 on AI Gateway?
AI Gateway routes Claude Opus 5 through Anthropic, Bedrock, Google Vertex AI, Claude Platform on AWS, with retries and automatic failover. Call
/v1/models/anthropic/claude-opus-5/endpointsonai-gateway.vercel.shto list every provider serving Claude Opus 5, along with per-provider pricing, supported parameters, uptime, throughput, and latency.Does AI Gateway support Zero Data Retention for Claude Opus 5?
Yes, Zero Data Retention is available for this model. Zero Data Retention is offered on a per-provider basis. See https://vercel.com/docs/ai-gateway/capabilities/zdr for details.
What is the pricing for Claude Opus 5?
AI Gateway mirrors provider pricing with no markup and adds no platform fee on inference. Rates are listed on this page and shift when providers update their pricing.
How do I call Claude Opus 5 through AI Gateway?
Set the model to
anthropic/claude-opus-5in the AI SDK, Chat Completions API, Responses API, Messages API, or other API formats, from TypeScript or Python. AI Gateway handles authentication, retries, and failover acrossanthropic,bedrock,vertex,claudeaws.
Your use is subject to Anthropic's Terms & Privacy Policies.