Claude Architect · Aula

A Família de Modelos Claude

Escolha o modelo adequado para custo, velocidade e capacidade.

A Família de Modelos Claude é uma aula grátis de Claude Architect no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Claude Architect, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Claude Architect inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

Meet the Model Family

Every Claude API request begins with one decision: which model? That single field sets your cost, your latency, and your intelligence ceiling for the whole call.

The current family spans three tiers:

Opus — the most capable, for the hardest, long-horizon work.
Sonnet — the best balance of speed and intelligence.
Haiku — the fastest and cheapest, for simple high-volume tasks.

As a Claude Certified Architect, picking the right tier per workload is a core skill. Let's build the decision framework.

The model field is just a string

You select a model by passing its model ID as a string. The request also keeps no state — the model is stateless, so you send the full message history on every turn.

The exact ID strings matter. A typo (for example claude-sonnet-4.6 instead of claude-sonnet-4-6) returns a 404 not_found_error, not a silent fallback.

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(response.content[0].text)

Opus — top of the family

Claude Opus 4.8 (claude-opus-4-8) is the most capable model. Reach for it when correctness on a hard problem outweighs cost and speed:

Large multi-step refactors and overnight coding runs.
Deep research and long-horizon agentic loops.
Complex reasoning where a cheaper model would degrade quality.

It offers a 1M-token context window at standard pricing and up to 128K output tokens. Pricing: $5 / 1M input, $25 / 1M output.

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Refactor this service end to end."}],
)

Sonnet — the balanced workhorse

Claude Sonnet 4.6 (claude-sonnet-4-6) is the best combination of speed and intelligence. It's the default choice for most production traffic:

Chat, classification, content generation, extraction.
Tool-heavy workflows that need fast turnaround.
Anything where Opus would be overkill but Haiku might miss nuance.

It has a 1M-token context window and up to 64K output tokens. Pricing: $3 / 1M input, $15 / 1M output — cheaper than Opus on both ends.

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    messages=[{"role": "user", "content": "Classify this support ticket."}],
)

Haiku — fast and cheap at scale

Claude Haiku 4.5 (claude-haiku-4-5) is the fastest and most cost-effective model. Use it for simple, high-volume tasks where latency and price dominate:

Lightweight classification and routing.
Short summaries and formatting fixes.
Sub-agents doing narrow, well-scoped work.

Its context window is 200K tokens (smaller than the 1M of Opus and Sonnet), with up to 64K output tokens. Pricing: $1 / 1M input, $5 / 1M output — the cheapest tier.

response = client.messages.create(
    model="claude-haiku-4-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Is this email spam? Answer yes or no."}],
)

The three-way tradeoff

Picking a model is always a tradeoff across three axes:

Capability — Opus > Sonnet > Haiku for hard reasoning.
Speed — Haiku is fastest, Opus is most deliberate.
Cost — Haiku ($1/$5) < Sonnet ($3/$15) < Opus ($5/$25) per 1M tokens.

The architect's instinct: start at the cheapest tier that meets the quality bar, then move up only where evals show you need it. Don't reflexively default everything to Opus — you'll burn budget on tasks Sonnet or Haiku handle just as well.

Match the tier to the task

A practical routing heuristic for a multi-stage system:

Coordinator / planner doing complex decomposition → Opus.
Main worker handling tool calls and synthesis → Sonnet.
Narrow sub-agents (classify, grep-and-summarize) → Haiku.

This mirrors how production agents stay affordable: spend Opus-level intelligence only where the decision is hard, and push routine, parallel work down to cheaper models.

Don't switch models mid-conversation

Models are cache-scoped. Prompt caching is a prefix match, and the cache is keyed per model — so switching the model string mid-conversation invalidates the entire cache and you reprocess everything at full price.

The architect-grade pattern: keep one model on the main loop, and if a sub-task needs a cheaper model, spawn a sub-agent for it rather than swapping the model on the live thread.

# Main loop stays on Opus; cheap discovery work goes to a Haiku sub-agent
main = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    messages=history,  # cached prefix preserved
)

scout = client.messages.create(
    model="claude-haiku-4-5",  # separate call, separate cache
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize these 5 files."}],
)

Control cost with effort, not model swaps

You don't always have to change the model to change cost. On Opus 4.8 and Sonnet 4.6, the effort parameter tunes how much the model thinks and spends, inside output_config:

low — terse, fewer tool calls, latency-friendly.
high — the default; thorough.
max — Opus-tier only, when correctness beats cost.

Pair it with adaptive thinking (thinking={"type": "adaptive"}) and let the model decide how much to reason per request. Note: budget_tokens is removed on these models — use adaptive thinking instead.

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    thinking={"type": "adaptive"},
    output_config={"effort": "low"},  # cut cost without dropping a tier
    messages=[{"role": "user", "content": "Draft a release note."}],
)

Mind the context window and output cap

Capability isn't only intelligence — it's also how much the model can hold and produce:

Opus 4.8 / Sonnet 4.6: 1M-token context window.
Haiku 4.5: 200K-token context window.

If a workload must reason over a very large codebase or document set in a single call, Haiku's smaller window may rule it out regardless of cost. Also stream any request with large max_tokens (above ~16K) — non-streaming calls risk SDK HTTP timeouts.

with client.messages.stream(
    model="claude-opus-4-8",
    max_tokens=128000,  # large output -> must stream
    messages=[{"role": "user", "content": "Generate the full migration plan."}],
) as stream:
    message = stream.get_final_message()

Batch API: a cost lever, not a model tier

Cost optimization isn't only about model choice. The Message Batches API runs requests at 50% off, within a window of up to 24 hours.

The catch — it's not for blocking or time-sensitive work: there is no latency SLA, and multi-turn tool calling isn't supported. Use it for overnight reports and audits; never for a pre-merge check or anything a user is waiting on. For those, pick a fast model (often Haiku or Sonnet) on the standard API instead.

batch = client.messages.batches.create(
    requests=[
        {"custom_id": "row-1", "params": {
            "model": "claude-haiku-4-5",
            "max_tokens": 256,
            "messages": [{"role": "user", "content": "Classify row 1"}],
        }},
    ],
)

Quick Check: choosing a model

A scenario-style question on matching the model to the constraint.

Recap: choosing across the family

Key takeaways for the exam and for production:

Opus 4.8 ($5/$25, 1M context) — hardest reasoning, long-horizon agents; use sparingly.
Sonnet 4.6 ($3/$15, 1M context) — the balanced default for most traffic.
Haiku 4.5 ($1/$5, 200K context) — fast, cheap, high-volume simple tasks.
Start at the cheapest tier that meets the quality bar; move up only where evals demand it.
Tune cost with effort and adaptive thinking before swapping tiers.
Don't switch models mid-conversation — it invalidates the cache; spawn a cheaper sub-agent instead.
Use the Batches API (50% off) for non-blocking jobs only — never for time-sensitive checks.

Perguntas Frequentes

A aula “A Família de Modelos Claude” é grátis?

Sim — o texto completo de “A Família de Modelos Claude” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Claude Architect, atualize para CoddyKit PRO. O curso de Claude Architect inclui 4 aulas no total.

O que vou aprender em “A Família de Modelos Claude”?

Escolha o modelo adequado para custo, velocidade e capacidade. Você pratica Claude Architect com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Claude Architect?

Nenhuma experiência prévia é necessária. Claude Architect no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “A Família de Modelos Claude”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Claude Architect?

Sim. Cada aula de Claude Architect inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Claude Architect