​
Opções do SDK

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

​
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 necessários 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

​
Conceitos Principais

​
Autenticação

Para autenticação básica, recupere uma chave de API 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.

​
Suporte Completo aos 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 ferramentas
  • Comandos Slash: Use comandos personalizados definidos como arquivos Markdown em ./.claude/commands/
  • Memória (CLAUDE.md): Mantenha o 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

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ão

​
Protocolo de Contexto de Modelo (MCP)

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

​
Recursos Relacionados