Opus 5
Move an app from Claude Opus 4.8 to Claude Opus 5: the model IDModel IDThe name a request calls a model by, lab/model, copied from Models.More on Models → changes, and reasoning turns on by default.
- Change the model ID.
- Update the request.
- Read the answer.
- Set the effort.
- Compare before you switch.
1. Change the model ID
| From | To | |
|---|---|---|
| Model ID | anthropic/claude-opus-4.8 | anthropic/claude-opus-5 |
| Context | 1 000 000 tokens | 1 000 000 tokens |
| Longest answer | 128 000 tokens | 128 000 tokens |
| Reasoning | off unless you ask: default_enabled is false | on unless you turn it off: default_enabled is true |
| Effort levels | low · medium · high · xhigh · max | the same five |
GET /v1/model/{lab}/{model} answers each model's entry: its context, its longest answer, its reasoning. The request keeps its shape; model changes.
{
"model": "anthropic/claude-opus-5",
"messages": [
{
"role": "user",
"content": "Summarise this contract in five points."
}
]
}2. Update the request
| You send today | On Opus 5 | Send instead |
|---|---|---|
| no reasoning setting | the model reasons | nothing, or reasoning turned off, as below |
reasoning off, with effort xhigh or max | refused | reasoning on at those levels, or effort high or lower |
To keep Opus 4.8's behaviour, turn reasoning off in the request, at effort high or lower.
| Route | Reasoning off |
|---|---|
/v1/chat/completions | reasoning: {"enabled": false} |
/v1/messages | thinking: {"type": "disabled"} |
{
"model": "anthropic/claude-opus-5",
"reasoning": {
"enabled": false,
"effort": "high"
},
"messages": [
{
"role": "user",
"content": "Summarise this contract in five points."
}
]
}Two additions, both on /v1/messages and both in beta at Anthropic, keep the start of the conversation unchanged, so a cached prompt stays cached: see Caching.
| To | Add |
|---|---|
| change the effort for one turn | a system message with empty content and output_config.effort, before that turn |
| add or remove a tool mid-conversation | a system message holding a tool_addition or tool_removal block that names the tool |
3. Read the answer
With reasoning on, every answer carries it, and the reasoning shares the ceiling with the reply.
| Route | Where the reasoning lands | Change |
|---|---|---|
/v1/chat/completions | choices[0].message.reasoning, counted in usage.completion_tokens_details.reasoning_tokens | raise max_tokens: too low a ceiling ends with no text |
/v1/messages | thinking blocks, ahead of the text block | read blocks by type, never content[0]; send thinking blocks back unchanged with tool results |
Reasoning also takes time before the first word: check your timeouts. Both routes: Chat · Messages.
4. Set the effort
| Route | Field |
|---|---|
/v1/chat/completions | reasoning.effort, or reasoning_effort |
/v1/messages | output_config.effort |
Anthropic gives high as the default. Set the level in every request: lower it where answers hold, and use xhigh for long coding and agent work.
At xhigh or max, Anthropic's advice is a max_tokens of 64 000 to start: the reasoning and the reply both fit.
5. Compare before you switch
Send the same set of real prompts to both IDs, and compare three things.
| Compare | Where |
|---|---|
| the answers | your own check: a test suite, a reviewer, the task's pass rate |
| what each cost | usage.cost, in DADAThe Algerian dinar, the one currency the docs show.More on Balance and charges →, on every answer |
| how much each reasoned | usage.completion_tokens_details.reasoning_tokens |
The script sends one task three ways and prints one line per run: how the answer ended, what the prompt counted, what the model reasoned, and the charge in DA, then the first words of the answer.
| Run | Model | Reasoning |
|---|---|---|
old | MODEL | no setting: the model's own default |
new, default | CANDIDATE | no setting: the model's own default |
new, off | CANDIDATE | off, at effort high |
import os
from openai import OpenAI
API_KEY = os.environ["OPENDUNES_API_KEY"]
BASE_URL = "https://opendunes.com/v1"
MODEL = "anthropic/claude-sonnet-4.5"
CANDIDATE = "anthropic/claude-sonnet-4.5"
MAX_TOKENS = 8000
TASK = (
"Summarise this contract in five points.\n\n"
"The supplier delivers 200 kilos of dates to Biskra each month. "
"Payment is due 30 days after delivery, and a late payment adds "
"a fee. Either side may end the contract with 60 days' notice."
)
DEFAULT = {}
OFF = {"reasoning": {"enabled": False, "effort": "high"}}
RUNS = [
("old", MODEL, DEFAULT),
("new, default", CANDIDATE, DEFAULT),
("new, off", CANDIDATE, OFF),
]
client = OpenAI(base_url=BASE_URL, api_key=API_KEY)
for label, model, fields in RUNS:
reply = client.chat.completions.create(
model=model,
max_tokens=MAX_TOKENS,
messages=[{"role": "user", "content": TASK}],
extra_body=fields,
)
usage = reply.usage
details = usage.completion_tokens_details
thought = details.reasoning_tokens if details else 0
print(
f"{label:13} {reply.choices[0].finish_reason:7}",
f"in {usage.prompt_tokens}",
f"thought {thought}",
f"cost {usage.cost}",
)
print(" ", (reply.choices[0].message.content or "")[:60])The samples put anthropic/claude-sonnet-4.5 in both seats, so they run as they stand. Set MODEL to anthropic/claude-opus-4.8 and CANDIDATE to anthropic/claude-opus-5.
The first two lines differ in the model alone: thought shows the change of default, from none to some. The third line is Opus 4.8's behaviour kept on Opus 5, at an effort high or lower.
Switch once the new ID holds; going back is the same one-line change. Run your red-team suite on the new ID too: Red teaming.
Last modified on