Visão geral do Agent SDK

Instalação

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

pip install 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:

• SDK TypeScript - Para aplicações Node.js e web
• SDK Python - Para aplicações Python e ciência de dados
• Modo Streaming vs Modo Único - Compreendendo modos de entrada e melhores práticas

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.

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:

• SDK TypeScript: Relatar problemas no GitHub
• SDK Python: Relatar problemas no GitHub

Changelog

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

• SDK TypeScript: Ver CHANGELOG.md
• SDK Python: Ver CHANGELOG.md

Recursos Relacionados

• Referência CLI - Documentação completa da CLI
• Integração GitHub Actions - Automatize seu fluxo de trabalho do GitHub
• Documentação MCP - Estenda Claude com ferramentas personalizadas
• Fluxos de Trabalho Comuns - Guias passo a passo
• Solução de Problemas - Problemas comuns e soluções