O Claude Code SDK foi renomeado para 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 diferentes casos de uso:

​
Por que usar o Claude Agent SDK?

Construído sobre o harness de agente que alimenta o Claude Code, o Claude Agent SDK fornece todos os blocos de construção necessários para construir 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 capacidades do agente
  • Essenciais de produção: Tratamento de erro 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 tipos de agente de exemplo 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 de plantão 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 do Console Claude e defina a variável de ambiente ANTHROPIC_API_KEY. O SDK também suporta autenticação via provedores de API de terceiros:
  • Amazon Bedrock: Defina a variável de ambiente CLAUDE_CODE_USE_BEDROCK=1 e configure credenciais AWS
  • Google Vertex AI: Defina a variável de ambiente CLAUDE_CODE_USE_VERTEX=1 e configure credenciais Google Cloud
Para instruções detalhadas de configuração para provedores de terceiros, consulte a documentação do Amazon Bedrock e Google Vertex AI.

​
Suporte Completo a 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: Lance agentes especializados armazenados como arquivos Markdown em ./.claude/agents/
  • Hooks: Execute comandos personalizados configurados em ./.claude/settings.json que respondem a eventos de ferramenta
  • Comandos Slash: Use comandos personalizados definidos como arquivos Markdown em ./.claude/commands/
  • Memória (CLAUDE.md): Mantenha contexto do projeto através de arquivos CLAUDE.md que fornecem instruções e contexto persistentes
Esses recursos funcionam de forma idêntica às suas contrapartes do Claude Code lendo dos mesmos locais do sistema de arquivos.

​
Prompts do Sistema

Prompts do sistema definem o papel, expertise e comportamento do seu agente. É aqui que você especifica que tipo de agente está construindo.

​
Permissões de Ferramenta

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

​
Protocolo de Contexto de Modelo (MCP)

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

​
Relatando Bugs

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

​
Recursos Relacionados