| name | update-claude-model |
| description | Add a new Claude (Anthropic) model version to pidgin/data/models.json. Use when the user mentions a newly released claude-fable, claude-opus, claude-sonnet, or claude-haiku version (e.g. "opus 4.8 just dropped", "add the new sonnet", "bump fable", "bump haiku"). |
Update Claude model
Follow the universal recipe in update-model, with these Anthropic-specific details.
Families
Current Anthropic families, top-tier first:
- fable — public-facing flagship from the mythos line. 1M context.
- opus — high-capability tier. 1M context (current 4.x).
- sonnet — mid-tier workhorse. 1M context (current 4.x).
- haiku — fast/cheap tier. 200K context (current 4.x).
Notes:
- Mythos is a related limited-availability internal line and is not registered in
models.json. Fable is the publicly available mythos-class model. Do not add Mythos entries unless the user explicitly asks.
Conventions
- Key:
claude-<family>-<MAJOR>.<MINOR> — e.g. claude-opus-4.8, claude-sonnet-4.7, claude-haiku-5.0. Fable currently ships major-version-only (claude-fable-5); if a minor lands, follow the same pattern (claude-fable-5.1).
- display_name:
"Anthropic: Claude <Family> <MAJOR>.<MINOR>" — e.g. "Anthropic: Claude Opus 4.8", "Anthropic: Claude Fable 5".
- api.model_id: matches Anthropic's API id. Two patterns occur:
- Dateless:
claude-<family>-<MAJOR>-<MINOR> (e.g. claude-opus-4-8, claude-fable-5).
- Dated snapshot:
claude-<family>-<MAJOR>-<MINOR>-<YYYYMMDD> (e.g. claude-haiku-4-5-20251001).
- When the dateless id is available (which is usually the case for the current release), prefer it. Look at the Claude Code environment context block for the canonical id of the model you're running on; older Haiku-style entries may keep their dated snapshot.
- Family alias (
aliases field): fable, opus, sonnet, or haiku. The newest version in the family owns it; clear the previous owner's aliases to [].
Pricing defaults (per 1M tokens, USD)
| Family | input | output |
|---|
| fable | 1e-05 | 5e-05 |
| opus | 5e-06 | 2.5e-05 |
| sonnet | 3e-06 | 1.5e-05 |
| haiku | 1e-06 | 5e-06 |
Use these unless Anthropic has announced a change for the new release. Always confirm against Anthropic's pricing page if the user provides one.
Capabilities & limits
Copy from the previous entry in the same family — do not invent values. As of late Claude 4.x / Fable 5:
max_context_tokens: 1000000 for current Fable/Opus/Sonnet, 200000 for current Haiku.streaming, tool_calling, system_messages, json_mode: true.vision, extended_thinking, prompt_caching: vary by family; copy them verbatim from the previous entry rather than guessing.
If Anthropic has announced a new capability (e.g. vision newly enabled), update only that flag.
Recipe
- Locate the previous latest entry (e.g.
claude-opus-4.7) in pidgin/data/models.json.
- Edit its
aliases array down to [].
- Insert the new entry directly after it, cloned from its body, with the bumped key,
display_name, api.model_id, aliases: ["<family>"], and today's cost.last_updated.
- Validate and commit per the universal recipe in
update-model.
Commit message format: chore: add <new-key> and move <family> alias (e.g. chore: add claude-opus-4.8 and move opus alias).
