Visão geral do Agent SDK

Construa agentes de IA que leem arquivos autonomamente, executam comandos, pesquisam na web, editam código e muito mais. O Agent SDK oferece as mesmas ferramentas, loop de agente e gerenciamento de contexto que alimentam o Claude Code, programável em Python e TypeScript.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

O Agent SDK inclui ferramentas integradas para ler arquivos, executar comandos e editar código, para que seu agente possa começar a trabalhar imediatamente sem que você implemente a execução de ferramentas. Mergulhe no guia de início rápido ou explore agentes reais construídos com o SDK:

Comece agora

Pronto para construir? Siga o Guia de Início Rápido para criar um agente que encontra e corrige bugs em minutos.

Capacidades

Tudo o que torna o Claude Code poderoso está disponível no SDK:

Recursos do Claude Code

O SDK também suporta a configuração baseada em sistema de arquivos do Claude Code. Para usar esses recursos, defina setting_sources=["project"] (Python) ou settingSources: ['project'] (TypeScript) em suas opções.

Compare o Agent SDK com outras ferramentas Claude

A plataforma Claude oferece várias maneiras de construir com Claude. Aqui está como o Agent SDK se encaixa:

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 que integram o Claude Agent SDK, o uso da 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 como "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 dúvidas sobre conformidade de marca, entre em contato com nossa equipe de vendas.

Licença e termos

O uso do Claude Agent SDK é regido pelos Termos de Serviço Comercial da Anthropic, inclusive 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