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 diferem em quem executa o agente, o que vem integrado e como você o acessa. Encontre a linha que corresponde a como você deseja construir e executar o seu.
| Você quer | Use | O que você obtém |
|---|---|---|
| Incorporar o agente Claude Code em sua própria aplicação Python ou TypeScript, em um processo que você opera | Agent SDK | Uma biblioteca que executa o binário Claude Code, com as capacidades do Claude Code, como ferramentas integradas, permissões, sessões e hooks. |
| Fazer desenvolvimento interativo ou executar tarefas únicas de um terminal | Claude Code CLI | A interface do terminal, construída para uso interativo diário. |
| Chamar a API Claude diretamente do seu próprio código | Client SDK | Acesso direto à API Claude de qualquer uma das linguagens do Client SDK. Você escreve o loop de ferramentas você mesmo, ou deixa o tool runner beta do Client SDK conduzi-lo. |
| Ter a Anthropic hospedando o agente, configurado através da API Claude | Managed Agents | Um agente hospedado que executa o loop do agente, com sessões em um sandbox gerenciado pela Anthropic ou um sandbox auto-hospedado em sua própria infraestrutura. Use-o a partir do SDK para sua linguagem, da CLI ant ou da API REST. |
Para conduzir o mesmo loop de agente de uma linguagem diferente de Python ou TypeScript, 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