O Claude Code SDK foi renomeado para o Claude Agent SDK. Se você está migrando do SDK antigo, consulte o Guia de Migração.

​
Instalação

npm install @anthropic-ai/claude-agent-sdk

​
Opções do SDK

O Claude Agent SDK está disponível em múltiplas formas para atender a diferentes casos de uso:

​
Por que usar o Claude Agent SDK?

Construído sobre o harness de agentes que alimenta o Claude Code, o Claude Agent SDK fornece todos os blocos de construção necessários para criar agentes prontos para produção. Aproveitando o trabalho que fizemos no Claude Code, incluindo:
  • Gerenciamento de Contexto: Compactação automática e gerenciamento de contexto para garantir que seu agente não fique sem contexto.
  • Ecossistema de ferramentas rico: Operações de arquivo, execução de código, busca na web e extensibilidade MCP
  • Permissões avançadas: Controle refinado sobre as capacidades do agente
  • Essenciais de produção: Tratamento de erros integrado, gerenciamento de sessão e monitoramento
  • Integração Claude otimizada: Cache automático de prompt e otimizações de desempenho

​
O que você pode construir com o SDK?

Aqui estão alguns exemplos de tipos de agentes que você pode criar: Agentes de codificação:
  • Agentes SRE que diagnosticam e corrigem problemas de produção
  • Bots de revisão de segurança que auditam código para vulnerabilidades
  • Assistentes de engenharia oncall que fazem triagem de incidentes
  • Agentes de revisão de código que aplicam estilo e melhores práticas
Agentes de negócios:
  • Assistentes jurídicos que revisam contratos e conformidade
  • Consultores financeiros que analisam relatórios e previsões
  • Agentes de suporte ao cliente que resolvem problemas técnicos
  • Assistentes de criação de conteúdo para equipes de marketing

​
Conceitos Principais

​
Autenticação

Para autenticação básica, recupere uma chave de API Claude no Console Claude e defina a variável de ambiente ANTHROPIC_API_KEY. O SDK também suporta autenticação através de provedores de API de terceiros:
  • Amazon Bedrock: Defina a variável de ambiente CLAUDE_CODE_USE_BEDROCK=1 e configure as credenciais AWS
  • Google Vertex AI: Defina a variável de ambiente CLAUDE_CODE_USE_VERTEX=1 e configure as credenciais do Google Cloud
Para instruções de configuração detalhadas para provedores de terceiros, consulte a documentação do Amazon Bedrock e Google Vertex AI.
A menos que previamente aprovado, não permitimos que desenvolvedores de terceiros apliquem limites de taxa do Claude.ai para seus produtos, incluindo agentes construídos no Claude Agent SDK. Use os métodos de autenticação de chave de API descritos neste documento.

​
Suporte Completo de Recursos do Claude Code

O SDK fornece acesso a todos os recursos padrão disponíveis no Claude Code, aproveitando a mesma configuração baseada em sistema de arquivos:
  • Subagentes: Inicie agentes especializados armazenados como arquivos Markdown em ./.claude/agents/
  • Habilidades do Agente: Estenda Claude com capacidades especializadas armazenadas como arquivos SKILL.md em ./.claude/skills/
  • Hooks: Execute comandos personalizados configurados em ./.claude/settings.json que respondem a eventos de ferramentas
  • Comandos Slash: Use comandos personalizados definidos como arquivos Markdown em ./.claude/commands/
  • Plugins: Carregue plugins personalizados programaticamente usando a opção plugins para estender o Claude Code com comandos personalizados, agentes, habilidades, hooks e servidores MCP. Consulte Plugins para detalhes.
  • Memória (CLAUDE.md): Mantenha o contexto do projeto através de arquivos CLAUDE.md ou .claude/CLAUDE.md em seu diretório de projeto, ou ~/.claude/CLAUDE.md para instruções de nível de usuário. Para carregar esses arquivos, você deve definir explicitamente settingSources: ['project'] (TypeScript) ou setting_sources=["project"] (Python) em suas opções. Consulte Modificando prompts do sistema para detalhes.
Esses recursos funcionam de forma idêntica aos seus equivalentes no Claude Code lendo dos mesmos locais do sistema de arquivos.

​
Prompts do Sistema

Os prompts do sistema definem o papel, experiência e comportamento do seu agente. É aqui que você especifica que tipo de agente você está construindo.

​
Permissões de Ferramentas

Controle quais ferramentas seu agente pode usar com permissões refinadas:
  • allowedTools - Permita explicitamente ferramentas específicas
  • disallowedTools - Bloqueie ferramentas específicas
  • permissionMode - Defina a estratégia geral de permissão

​
Protocolo de Contexto de Modelo (MCP)

Estenda seus agentes com ferramentas e integrações personalizadas através de servidores MCP. Isso permite que você se conecte a bancos de dados, APIs e outros serviços externos.

​
Relatando Bugs

Se você encontrar bugs ou problemas com o Agent SDK:

​
Changelog

Veja o changelog completo para atualizações do SDK, correções de bugs e novos recursos:

​
Recursos Relacionados