Programe Claude Code, Codex, Pi e outros agent harnesses com o AI SDK
Aprofundamento CEVIU
Aprofundamento
O Vercel AI SDK versão 7, lançada em 12 de junho de 2026, introduziu o HarnessAgent, uma API unificada para programar e gerenciar agent harnesses, infraestruturas que envolvem modelos como Claude Code, Codex e Pi com sandboxing, controle de sessão, compactação de contexto e orquestração de ferramentas. Um 'agent harness' não é um modelo, mas a camada operacional que garante que ele execute tarefas de forma segura, observável e repetível: por exemplo, rodar um comando bash em um Webcontainer isolado ou validar saídas antes de aplicar código no repositório.
Essa abordagem responde a um problema crítico identificado pela Apiiro: entre janeiro e junho de 2025, agentes de IA geraram mais de 10.000 novas vulnerabilidades de segurança por mês. O harness atua como freio, limitando permissões, rastreando cada etapa e forçando verificação humana ou automática antes da execução final. A OpenAI formalizou o conceito como 'harness engineering' em 11 de fevereiro de 2026, após Mitchell Hashimoto destacar sua importância para produção em escala.
Por que isso importa
Antes do HarnessAgent, trocar de agente significava reescrever lógica de sessão, sandbox, ferramentas e tratamento de erros, cada um tinha seu próprio protocolo. Agora, um único bloco de código pode alternar entre Claude Code, GPT 5.2 Codex ou Pi sem mudar a estrutura principal. Isso acelera testes comparativos, migrações e fallbacks inteligentes. Também alinha-se com exigências reais de empresas: auditoria (via Observability da Vercel), compliance (sandboxing obrigatório para ambientes financeiros) e redução de risco (evitando execução cega de código gerado).
O suporte nativo ao Vercel AI Gateway, com endpoints compatíveis com Anthropic para Claude Code (desde 5 de janeiro de 2026) e ao GPT 5.2 Codex (disponível desde 14 de janeiro de 2026), significa que os dados de uso, latência e token count são monitorados fora da aplicação, sem alteração no código do desenvolvedor.
Impacto para desenvolvedores
Desenvolvedores agora definem habilidades, instruções e sandboxes em um único lugar, usando APIs familiares do AI SDK como useChat e streamText. Bibliotecas da comunidade como ai-sdk-provider-claude-code (lançada em 10 de dezembro de 2025) e edge-pi (com sete ferramentas nativas e persistência de sessão) mostram que o padrão já está sendo adotado. Não é só sobre conectar modelos, é sobre padronizar *como* eles interagem com sistemas reais: ler arquivos, executar comandos, editar código, buscar padrões.
Para quem usa Webcontainers ou Vercel Sandboxes, o impacto é imediato: o Pi reescrito com o SDK ganhou execução segura de bash, grep e edit dentro de ambientes isolados. Já o plugin oficial da Vercel para OpenAI Codex CLI (lançado em 26 de março de 2026) oferece 39 habilidades de plataforma e três agentes especializados, tudo integrável via HarnessAgent sem adaptações manuais.
Perguntas frequentes
O que é um agent harness no Vercel AI SDK?
Um agent harness é a camada de infraestrutura que envolve um modelo de IA, como Claude Code, Codex ou Pi, para garantir execução segura e confiável. Ele gerencia sandbox, sessões, compactação de contexto, permissões e orquestração de ferramentas. O Vercel AI SDK 7 introduziu o HarnessAgent como API unificada para programá-los.
Quando foi lançado o suporte a Claude Code no Vercel AI SDK?
O suporte a Claude Code foi adicionado à Vercel AI Gateway em 5 de janeiro de 2026. Em 10 de dezembro de 2025, a biblioteca da comunidade ai-sdk-provider-claude-code permitiu integrar Claude Code diretamente ao AI SDK via formato XML. A versão 7 do SDK (12 de junho de 2026) consolidou esse suporte com o HarnessAgent.
O que é o GPT 5.2 Codex e quando ficou disponível no Vercel?
O GPT 5.2 Codex é uma versão especializada do modelo OpenAI para tarefas de codificação de longa duração, com melhor desempenho em visão e cibersegurança. Foi disponibilizado no Vercel AI Gateway em 14 de janeiro de 2026. O plugin oficial da Vercel para Codex CLI, com 39 habilidades, foi lançado em 26 de março de 2026.
Qual é a diferença entre Claude Code, Codex e Pi no contexto do AI SDK?
Claude Code é um agente de codificação da Anthropic, Codex é da OpenAI (com foco em GPT 5.2 para programação) e Pi é um agente open source reescrito com o Vercel AI SDK. Todos são compatíveis com o HarnessAgent, mas diferem em arquitetura: Claude Code usa XML, Codex opera via API REST compatível com OpenAI, e Pi roda nativamente em Webcontainers com ferramentas como bash e grep.
Links relacionados
Fontes
- vercel.comfonte original
- Categoria
- CEVIU IA
- Publicado
- 13 de junho de 2026
- Editoria
- CEVIU IA
