Frameworks 2026 — Claude Agent SDK, LangGraph, AutoGen, CrewAI

TL;DR

O ecossistema de frameworks para agents em 2026 estabilizou em 5 grandes opções: Claude Agent SDK (oficial Anthropic), LangGraph (mais popular para workflows complexos), CrewAI (multi-agent role-based), AutoGen (Microsoft, conversational), Pydantic AI (TypeScript/Python type-safe). Mas o movimento crescente é “sem framework”: SDK raw + 500 linhas de código próprio. Frameworks engessam, mudam frequentemente, são difíceis de debugar. Use framework quando o pain de não ter excede o pain de ter.

O panorama em uma tabela

FrameworkLinguagemForte emQuando usar
Claude Agent SDKPythonIntegração nativa Claude, MCPComprometido com Claude
LangChain / LangGraphPython, JSEcossistema enorme, workflows complexosMúltiplas integrações + state graph
CrewAIPythonMulti-agent role-basedProtótipos multi-agent
AutoGenPythonConversational multi-agentPesquisa, experimental
Pydantic AIPythonType-safe, structured outputsTimes type-first
Vercel AI SDKTypeScriptFrontend Next.js/React + LLMSPA/webapp com IA
Sem frameworkQualquerControle total, debug fácilTime experiente, use case estável

Claude Agent SDK

Framework oficial da Anthropic para construir agents com Claude.

from anthropic import Anthropic
# (Claude Agent SDK abstrai o loop, tools, observabilidade)
 
agent = Agent(
    model="claude-sonnet-4-6",
    tools=[search_tool, read_tool],
    max_steps=15,
    observability=langfuse_client
)
 
result = agent.run("Pesquise X e sintetize")

Prós:

  • Integração nativa com Claude (tool use otimizado)
  • Observabilidade built-in
  • Suporte nativo a MCP

Contras:

  • Lock-in Anthropic (otimizado para Claude)
  • Menos maduro que LangChain

Use quando: comprometido com Claude e quer o melhor do Claude.

LangChain / LangGraph

O framework mais popular para agents em Python/JS.

  • LangChain: abstrações de “chain” e “agent”, muitas integrações
  • LangGraph: layer para grafos de execução, stateful workflows, cycles, branches
from langgraph.graph import StateGraph
 
class AgentState(TypedDict):
    messages: list
    findings: list
 
graph = StateGraph(AgentState)
graph.add_node("researcher", researcher_fn)
graph.add_node("writer", writer_fn)
graph.add_edge("researcher", "writer")

Prós:

  • Ecossistema enorme, integra com tudo
  • LangSmith para observabilidade
  • StateGraph é poderoso para multi-agent

Contras:

  • Abstrações pesadas
  • Mudanças frequentes (debugging difícil)
  • Curva de aprendizado íngreme

Use quando: projetos que precisam de múltiplas integrações e estão ok com overhead.

CrewAI

Framework especializado em multi-agent orchestration.

from crewai import Crew, Agent, Task
 
researcher = Agent(role="Researcher", goal="Find sources")
writer = Agent(role="Writer", goal="Synthesize findings")
 
task = Task(description="Research X", agent=researcher)
crew = Crew(agents=[researcher, writer], tasks=[task])
crew.kickoff()

Prós:

  • Paradigma claro de “crew” (papéis + tarefas)
  • Boa para ideação e protótipos

Contras:

  • Menos maduro
  • Documentação variável

Use quando: protótipos multi-agent, ideação rápida.

AutoGen (Microsoft)

Framework de multi-agent conversational.

Prós:

  • Paradigma claro de conversação
  • Suporte a human-in-the-loop

Contras:

  • Mais acadêmico, menos otimizado para prod
  • Output pode ser caro (agents conversam muito)

Use quando: pesquisa, experimentação multi-agent.

Pydantic AI

Framework type-safe focado em structured outputs.

from pydantic_ai import Agent
 
class ResearchResult(BaseModel):
    findings: list[str]
    sources: list[str]
    confidence: float
 
agent = Agent(
    "claude-sonnet-4-6",
    result_type=ResearchResult,
    tools=[search, read]
)
 
result = agent.run_sync("Pesquise X")
print(result.data.findings)  # type-safe

Prós:

  • Type-safe (Pydantic validation)
  • Structured outputs garantidos
  • Bom DX

Contras:

  • Menos integrações que LangChain

Use quando: time prefere type-first development.

Vercel AI SDK

Framework para aplicações Next.js/React com LLM.

Prós:

  • Excelente DX em frontend
  • Streaming nativo, hooks React

Contras:

  • Focado em aplicações web
  • Não para agents servidor-puros

Use quando: SPA/webapp com IA.

”Sem framework” — o movimento crescente

Em 2026, muita gente está voltando para SDK raw + código próprio. Razões:

Simon Willison e devs senior

“Frameworks são abstrações que engessam. Um agent de 500 linhas em TypeScript raw é mais fácil de debugar, mais fácil de otimizar custo, mais fácil de adaptar.”

Quando “sem framework” vence:

  • Time sabe o que está fazendo
  • Use case estável (não muda toda semana)
  • Custo importa muito
  • Debug é prioritário

Quando framework vale:

  • Time precisa de muitas integrações
  • Velocidade de prototipagem > controle
  • Time menos experiente

Heurística de escolha

graph TB
    A["Vou começar agent"] --> B{"Time experiente?"}
    B -->|sim| C{"Use case<br/>estável?"}
    B -->|não| D["LangChain/LangGraph<br/>(ecossistema)"]
    C -->|sim| E["Sem framework<br/>(SDK raw)"]
    C -->|não| F{"Stack?"}
    F -->|"Claude-first"| G["Claude Agent SDK"]
    F -->|"Multi-LLM"| D
    F -->|"Type-safe"| H["Pydantic AI"]
    F -->|"Frontend"| I["Vercel AI SDK"]

A pergunta de teste

“O pain de manter framework excede o pain de manter código próprio?”

Se sim → use framework. Se não → comece sem.

Anti-patterns

  • Framework como religião — escolheu LangChain, força em tudo
  • Framework para protótipo — overhead em algo que ia mudar
  • Sem framework + sem disciplina — código vira spaghetti
  • Trocar framework no meio — custo enorme, raramente vale
  • Framework cutting-edge em produção — versões mudam, breakages

Métricas para avaliar adoção

MétricaAlvo
Tempo até primeiro agent funcional<2 dias
Linhas de código de glue<500
% de bugs que vêm do framework<30%
Curva de onboarding novo dev<1 semana

Veja também

Referências

  • AnthropicClaude Agent SDK docs (2026)
  • LangChainpython.langchain.com (2026)
  • CrewAIdocs.crewai.com (2026)
  • AutoGenmicrosoft.github.io/autogen (2026)
  • Pydantic AIai.pydantic.dev (2026)
  • Vercel AI SDKsdk.vercel.ai (2026)
  • Simon Willisonblog on agents and frameworks (2024-2026)