Update Models

Check which Claude models are configured in the project and update to the latest versions.

Steps

1. Find current model references by searching the codebase for model ID patterns:

   • src/shared/lib/config/settings.ts — default model settings (agentModel, browserModel, summarizerModel)
   • src/renderer/components/settings/llm-tab.tsx — model dropdown options and fallback values
   • src/renderer/components/settings/browser-tab.tsx — browser model dropdown options and fallback values
   • agent-container/src/claude-code.ts — model alias mapping (toModelAlias function)
   • Search broadly for any other hardcoded model IDs: grep -r "claude-.*-[0-9]" src/ agent-container/src/

2. Check latest available models by searching the web for:

   • Latest Claude model family versions (Opus, Sonnet, Haiku)
   • Latest model IDs on the Anthropic API
   • Any new model tiers or capabilities

3. Present findings showing:

   • Current model IDs used in each file
   • Latest available model IDs
   • What changed (new capabilities, context window, pricing changes)

4. Ask the user which models to update before making changes.

How model resolution works

The codebase stores full model IDs (e.g., claude-opus-4-6) in settings and UI dropdowns. In agent-container/src/claude-code.ts, the toModelAlias() function maps these to SDK aliases (opus, sonnet, haiku). The Claude Agent SDK then resolves aliases to the actual latest model version.

This means:

• UI dropdowns and defaults: Use full model IDs for display (e.g., claude-opus-4-6, label Claude 4.6 Opus)
• SDK calls: Full model IDs get mapped to aliases via toModelAlias() — the SDK handles version resolution
• Summarizer model (summarizerModel in settings.ts): Uses @anthropic-ai/sdk directly with client.messages.create() — this takes the full model ID string as-is

Key files to update

• src/shared/lib/config/settings.ts — default model values (DEFAULT_SETTINGS.models)
• src/shared/lib/llm-provider/*-provider.ts — each provider's getAvailableModels() dropdown list and getDefaultModel() (anthropic, platform, bedrock, openrouter). Note Bedrock uses region-prefixed IDs (us.anthropic.claude-opus-4-8) and OpenRouter may use its own format.
• src/renderer/components/messages/composer-options-popover.tsx — FAMILY_LABEL display strings (e.g. opus: 'Opus 4.8')
• src/shared/lib/services/model-pricing.json — add a pricing entry for every new model ID (see pricing note below)
• Tests that assert defaults/labels: settings.test.ts (default-model assertions), composer-options-popover.test.tsx (trigger-label assertions)

Important notes

• Always add the new model ID to src/shared/lib/services/model-pricing.json. Usage costing falls back to this table when a JSONL entry has no costUSD field, and calculateCost() in usage-service.ts returns 0 for any model not in the table — so a missing entry makes the new model's spend show as $0 in the usage dashboard, silently. Mirror the previous version's pricing if the new model's pricing is unchanged (e.g. Opus 4.8 reused Opus 4.7's $5/$25 in/out, 6.25/0.5 cache). Use the exact response model ID (e.g. claude-opus-4-8).
• The toModelAlias() function in agent-container/src/claude-code.ts maps any string containing "opus"/"sonnet"/"haiku" to the alias — so the exact version number in the model ID doesn't affect which model the agent runs (the bundled CLI resolves the alias), but it does affect what the user sees in the UI and how usage is costed. The agent's actual model version is determined by the bundled Claude Code CLI's alias table, not by our pinned ID — to change the agent's Opus version you must bump @anthropic-ai/claude-agent-sdk to a CLI whose opus alias points at the new version, then rebuild the container image. Verify the alias mapping offline: LC_ALL=C grep -aoE '(sonnet|haiku|opus)[0-9]*:"claude-[a-z]+-4-[0-9]+' agent-container/node_modules/@anthropic-ai/claude-agent-sdk-<os>-<arch>/claude | sort -u
• Haiku may not have a newer version when Opus/Sonnet do — check each independently
• Do NOT run npm build — use typecheck + lint to verify changes