Adaptive Thinking Killed My Token Budget Code: Migrating Off budget_tokens

An engineer migrating from Claude Opus 4.5 to Opus 4.8 found that the fixed `budget_tokens` parameter for thinking has been replaced by adaptive thinking with an `effort` knob. The developer adapted by removing token budget calculations and instead selecting effort levels per workload, discovering that higher effort often reduced total cost on agentic tasks. The migration also required handling new defaults for streaming thinking blocks and removing deprecated parameters like temperature.

I had a tidy little helper that computed a thinking budget based on input size. Something like "give the model 30% of the context as thinking room." It worked great on Opus 4.5. Then I tried to point it at Opus 4.8 and got a 400. The whole concept I had built around is gone in the current models. Here is what replaced it and how I migrated. The old pattern looked like this: js // Opus 4.5 and earlier const response = await client.messages.create { model: "claude-opus-4-5", max tokens: 16000, thinking: { type: "enabled", budget tokens: 8000 }, messages, } ; On Opus 4.7, 4.8, and Fable 5, thinking: { type: "enabled", budget tokens: N } returns a 400. The fixed token budget is dead. The replacement is adaptive thinking, where the model decides how much to think, plus an effort knob that controls overall token spend. js // Opus 4.8 const response = await client.messages.create { model: "claude-opus-4-8", max tokens: 16000, thinking: { type: "adaptive" }, output config: { effort: "high" }, // low | medium | high | xhigh | max messages, } ; My old budget code was a guess dressed up as a calculation. I had no real basis for "30% of context." I picked it because it felt reasonable and the outputs looked fine. Adaptive thinking moves that decision to the model, which sees the actual problem. The mental model shift: budget tokens controlled how much the model could think. effort controls how much it thinks and acts . They are not the same axis, so there is no clean 1:1 mapping. I stopped trying to translate "8000 tokens" into an effort level and instead picked based on the workload. After running my own evals, here is where I landed: | Workload | Effort | Notes | |---|---|---| | Classification, routing | low | Fast, scoped, not intelligence-sensitive | | Most app traffic | medium to high | The balance point | | Coding and agentic loops | xhigh | Best for these; it is the Claude Code default | | Correctness-critical, latency-insensitive | max | When being wrong costs more than tokens | One thing that surprised me: higher effort up front often reduced total cost on agentic work because the model planned better and took fewer turns. I had assumed max always meant more tokens. On multi-step tasks, it sometimes meant fewer. budget tokens across the codebase. thinking: { type: "enabled", budget tokens: N } with thinking: { type: "adaptive" } . output config: { effort: "..." } and pick a level per call site, not one global value. temperature / top p / top k params those also 400 on 4.7+ . response.model . js const r = await client.messages.create { model: "claude-opus-4-8", max tokens: 64, thinking: { type: "adaptive" }, messages: { role: "user", content: "ping" } , } ; console.assert r.model.startsWith "claude-opus-4-8" , r.model ; On Opus 4.7+ and Fable 5, thinking blocks still stream but their text is empty by default. If you were rendering reasoning to a UI, you now see a long pause instead of progress. Opt back in: thinking: { type: "adaptive", display: "summarized" } I missed this for an afternoon and thought streaming was broken. It was just the new default omitted . I built abstraction on top of a parameter that the platform later removed. That is the risk of wrapping a vendor knob in your own logic before you understand whether the knob is fundamental or incidental. budget tokens was incidental. The fundamental thing was "let the model think when it helps," and adaptive thinking expresses that directly. Less of my code, more of theirs, and the outputs got better. I will take that trade.