Visão geral do Agent SDK
Construa agentes de IA em produção com Claude Code como uma biblioteca
Um agente é uma aplicação que completa uma tarefa planejando seus próprios passos e chamando ferramentas que leem arquivos, executam comandos ou editam código. O Agent SDK oferece as mesmas ferramentas, loop de agente, e gerenciamento de contexto que alimentam Claude Code, programável em Python e TypeScript.
Compare o Agent SDK com outras ferramentas Claude
O Agent SDK, a CLI, o Client SDK e Managed Agents atendem a diferentes necessidades. Use a tabela para encontrar aquele que corresponde ao que você está construindo.
| Se você está... | Use | Por quê |
|---|---|---|
| Construindo um agente sem implementar o loop de ferramentas você mesmo | Agent SDK | Uma biblioteca Python ou TypeScript que executa o loop do agente para você. |
| Fazendo desenvolvimento interativo ou executando tarefas únicas de um terminal | Claude Code CLI | A interface do terminal, construída para uso interativo diário. |
| Chamando a API diretamente e implementando o loop de ferramentas você mesmo | Client SDK | Acesso direto à API Anthropic em vez de Claude Code. Você implementa o loop de ferramentas você mesmo. |
| Executando agentes de longa duração ou assíncronos sem gerenciar sua própria infraestrutura de sandbox ou sessão | Managed Agents | API REST hospedada, um produto separado do Agent SDK. Anthropic executa o agente e o sandbox. |
O SDK está disponível como uma biblioteca apenas para Python e TypeScript. Para conduzir o mesmo loop de agente de outro idioma, execute a CLI como um subprocesso com a flag -p e --output-format json.
Capacidades
Essas capacidades do Claude Code estão disponíveis no SDK:
| Capacidade | O que faz | Saiba mais |
|---|---|---|
| Ferramentas integradas | Ler, escrever, editar arquivos, executar comandos e pesquisar na web | Referência de ferramentas |
| Hooks | Executar código personalizado em pontos-chave do ciclo de vida do agente | Hooks |
| Subagentes | Gerar agentes especializados para subtarefas focadas | Subagentes |
| MCP | Conectar ferramentas externas e fontes de dados via o Model Context Protocol | MCP |
| Permissões | Controlar quais ferramentas são executadas automaticamente, quais precisam de aprovação | Permissões |
| Sessões | Manter contexto entre trocas, retomar ou bifurcar depois | Sessões |
| Skills, comandos e memória | Carregar automaticamente do .claude/ do seu projeto e de ~/.claude/, igual ao Claude Code |
Skills, Comandos, Memória, Carregamento de configuração |
| Plugins | Empacotar skills, agentes, hooks e servidores MCP, e carregá-los por caminho local | Plugins |
Comece agora
Siga o Quickstart para instalar o SDK, definir sua chave de API e construir seu primeiro agente, um que encontra e corrige bugs em código existente.
Changelog
Veja o changelog completo para atualizações do SDK, correções de bugs e novos recursos:
- TypeScript SDK: ver CHANGELOG.md
- Python SDK: ver CHANGELOG.md
Relatando bugs
Se você encontrar bugs ou problemas com o Agent SDK:
- TypeScript SDK: relatar problemas no GitHub
- Python SDK: relatar problemas no GitHub
Diretrizes de marca
Para parceiros integrando o Claude Agent SDK, o uso de marca Claude é opcional. Ao fazer referência a Claude em seu produto:
Permitido:
- "Claude Agent", preferido para menus suspensos
- "Claude", quando dentro de um menu já rotulado "Agents"
- "{YourAgentName} Powered by Claude", se você tiver um nome de agente existente
Não permitido:
- "Claude Code" ou "Claude Code Agent"
- Arte ASCII com marca Claude Code ou elementos visuais que imitam Claude Code
Seu produto deve manter sua própria marca e não parecer ser Claude Code ou qualquer produto Anthropic. Para perguntas sobre conformidade de marca, entre em contato com a equipe de vendas da Anthropic.
Licença e termos
O uso do Claude Agent SDK é regido pelos Termos de Serviço Comercial da Anthropic, incluindo quando você o usa para alimentar produtos e serviços que você disponibiliza para seus próprios clientes e usuários finais, exceto na medida em que um componente específico ou dependência seja coberto por uma licença diferente conforme indicado no arquivo LICENSE desse componente.
Próximos passos
Estes recursos cobrem detalhes técnicos mais profundos e projetos de exemplo para construir com o Agent SDK.
- Guia de Início Rápido: construa seu primeiro agente que encontra e corrige bugs
- Guia de migração: migre dos pacotes Claude Code SDK para o Agent SDK
- Loop do agente: como Claude planeja, chama ferramentas e decide quando uma tarefa está concluída
- Agentes de exemplo: aplicativos de demonstração para desenvolvimento local
- TypeScript SDK: referência completa da API TypeScript e exemplos
- Python SDK: referência completa da API Python e exemplos
- Design do harness do agente: como o time Claude Code usa fluxos de trabalho dinâmicos para orquestrar muitos subagentos simultaneamente