Visão geral do Agent SDK

O Claude Code SDK foi renomeado para Claude Agent SDK. Se você está migrando do SDK antigo, consulte o Guia de Migração.

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:

Guia de Início Rápido

Construa um agente de correção de bugs em minutos

Agentes de exemplo

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.

Recurso	Descrição	Localização
Skills	Capacidades especializadas definidas em Markdown	`.claude/skills/SKILL.md`
Slash commands	Comandos personalizados para tarefas comuns	`.claude/commands/*.md`
Memory	Contexto do projeto e instruções	`CLAUDE.md` ou `.claude/CLAUDE.md`
Plugins	Estenda com comandos personalizados, agentes e servidores MCP	Programático via opção `plugins`

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

Guia de Início Rápido

Construa um agente que encontra e corrige bugs em minutos

Agentes de exemplo

Instale o SDK
Defina sua chave de API
Obtenha uma chave de API no Console, depois defina-a como uma variável de ambiente:
export ANTHROPIC_API_KEY=your-api-key
O SDK também suporta autenticação via provedores de API de terceiros:
- Amazon Bedrock: defina a variável de ambiente CLAUDE_CODE_USE_BEDROCK=1 e configure as credenciais da AWS
- Google Vertex AI: defina a variável de ambiente CLAUDE_CODE_USE_VERTEX=1 e configure as credenciais do Google Cloud
- Microsoft Azure: defina a variável de ambiente CLAUDE_CODE_USE_FOUNDRY=1 e configure as credenciais do Azure
Consulte os guias de configuração para Bedrock, Vertex AI ou Azure AI Foundry para obter detalhes.
A menos que previamente aprovado, a Anthropic não permite que desenvolvedores terceirizados ofereçam login em 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 neste documento.

Execute seu primeiro agente

Este exemplo cria um agente que lista arquivos em seu diretório atual usando ferramentas integradas.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())