Claude Fable 5.1 Migration Guide

​

What’s New

1. Forced tool use is rejected — tool_choice: {"type": "any"} or a named tool returns a 400
2. Ephemeral mid-conversation system messages (beta) — one-turn reminders via clear_at that never invalidate the prompt cache
3. Per-turn effort changes (beta) — raise or lower effort mid-conversation without a cache bust
4. Mid-thinking display updates (beta) — request real-time progress summaries during long tool-using turns
5. Prefix-locked thinking — thinking blocks are bound to the transcript prefix that produced them; largely not enforced on requests through OpenRouter (see below)

​

Ephemeral Mid-Conversation System Messages (Beta)

// Messages API
{
  "model": "anthropic/claude-fable-5.1",
  "max_tokens": 4096,
  "messages": [
    { "role": "user", "content": "Run the analysis script." },
    { "role": "assistant", "content": "Running it now: ..." },
    {
      "role": "system",
      "clear_at": "next_user_message",
      "content": "Results have landed in your inbox; check it before running more code."
    },
    { "role": "user", "content": "What did we get?" }
  ]
}

​

Per-Turn Effort Changes (Beta)

// Messages API
{
  "model": "anthropic/claude-fable-5.1",
  "max_tokens": 4096,
  "output_config": { "effort": "high" },
  "messages": [
    { "role": "user", "content": "Plan the migration." },
    { "role": "assistant", "content": "Here's the plan: ..." },
    { "role": "system", "content": [], "output_config": { "effort": "low" } },
    { "role": "user", "content": "Now rename the config file." }
  ]
}

​

Forced Tool Use Is Rejected

• Steering toward a tool: use tool_choice: {"type": "auto"} and state the expectation in the prompt (e.g. “Use the get_weather tool to answer”). Fable 5.1 follows explicit tool instructions reliably, and thinking first improves argument quality.
• Extracting structured data: if you were forcing a tool call to get JSON back, use structured outputs instead, which constrain the response format without skipping thinking.

// Messages API — steer with auto + prompt instead of forcing
{
  "model": "anthropic/claude-fable-5.1",
  "max_tokens": 4096,
  "tools": [{ "name": "get_weather", "description": "...", "input_schema": {} }],
  "tool_choice": { "type": "auto" },
  "messages": [
    { "role": "user", "content": "Use the get_weather tool to check Tokyo, then summarize." }
  ]
}

​

Mid-Thinking Display Updates (Beta)

// Messages API
{
  "model": "anthropic/claude-fable-5.1",
  "max_tokens": 4096,
  "thinking": { "type": "adaptive", "display": "updates" },
  "tools": ["..."],
  "messages": [{ "role": "user", "content": "Review the PRs open against our billing service." }]
}

​

Prefix-Locked Thinking

// Messages API — drop mismatched thinking blocks instead of erroring
{
  "model": "anthropic/claude-fable-5.1",
  "max_tokens": 4096,
  "thinking": {
    "type": "adaptive",
    "block_binding": { "prefix_mismatch_behavior": "drop_block" }
  },
  "messages": ["...full history with thinking blocks replayed verbatim..."]
}

​

Migration Checklist

1. Swap the slug to anthropic/claude-fable-5.1.
2. Replace forced tool use (tool_choice: {"type": "any"} or a named tool) with {"type": "auto"} plus prompt instructions, or structured outputs for JSON extraction.
3. Replace per-turn reminder injection with clear_at ephemeral system messages, and whole-conversation effort switching with per-message output_config.
4. If your product shows progress during long agentic turns, try thinking: { "type": "adaptive", "display": "updates" } — and keep "summarized" where you need thinking text on every request.
5. Keep passing thinking blocks back unchanged. To audit transcript edits, use prefix_mismatch_behavior: "drop_block" with input_transformations logging.
6. Re-baseline cost: input/output pricing matches Fable 5, and prompt cache reads cost a quarter of the Fable 5 rate.

​

Breaking Changes

​

Resources

• Claude Opus 5 Migration Guide — mid-conversation tool changes, which Fable 5.1 also supports
• Reasoning Tokens
• Structured Outputs
• OpenRouter Messages API
• Anthropic Claude Fable 5.1 migration guide