​
Por que usar o Claude Code SDK?

Construído sobre o harness de agente que alimenta o Claude Code, o Claude Code SDK fornece todos os blocos de construção que você precisa para construir agentes prontos para produção:

  • Integração otimizada do Claude: Cache automático de prompts e otimizações de desempenho
  • Ecossistema rico de ferramentas: 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

​
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

​
Opções do SDK

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

​
Conceitos Fundamentais

​
Autenticação

Para autenticação básica, recupere uma chave de API da Anthropic do Console Anthropic 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 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 detalhadas de configuração para provedores de terceiros, consulte a documentação do Amazon Bedrock e Google Vertex AI.

​
Prompts do Sistema

Os 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 Ferramentas

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ões

​
Protocolo de Contexto de Modelo (MCP)

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

​
Casos de Uso Comuns

​
Testes Automatizados e CI/CD

Crie agentes que executam testes, analisam resultados e corrigem problemas automaticamente em seu pipeline de CI/CD.

​
Revisão de Código e Auditorias de Segurança

Construa agentes que revisam pull requests para vulnerabilidades de segurança, qualidade de código e conformidade.

​
Resposta a Incidentes

Implante agentes SRE que diagnosticam problemas de produção, analisam logs e sugerem correções.

​
Geração de Documentação

Crie agentes que geram e mantêm documentação baseada em sua base de código.

​
Análise de Dados

Construa agentes que analisam dados, geram relatórios e criam visualizações.

​
Melhores Práticas

  • Use formato de saída JSON para análise programática de respostas
  • Trate erros graciosamente - verifique códigos de saída e implemente lógica de retry
  • Use gerenciamento de sessão para manter contexto em conversas de múltiplas rodadas
  • Implemente timeouts para operações de longa duração
  • Respeite limites de taxa ao fazer múltiplas solicitações
  • Teste completamente antes de implantar em produção

​
Recursos Relacionados