SpyBara
Go Premium

agent-sdk/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 18 additions and 18 deletions.

2026
Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

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.

[!NOTE]

A menos que previamente aprovado, a Anthropic não permite que desenvolvedores terceirizados ofereçam login claude.ai ou limites de taxa para seus produtos, incluindo agentes construídos no Claude Agent SDK. Use os métodos de autenticação de chave de API descritos no Quickstart em vez disso.

Changelog

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

Relatando bugs

Se você encontrar bugs ou problemas com o Agent SDK:

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.