Início Rápido

1. Configurar um projeto com o Agent SDK
2. Criar um arquivo com código com bugs
3. Executar um agente que encontra e corrige os bugs automaticamente

​

Pré-requisitos

• Node.js 18+ ou Python 3.10+
• Uma conta Anthropic (inscreva-se aqui)

​

Configuração

mkdir my-agent && cd my-agent

npm install @anthropic-ai/claude-agent-sdk

uv init && uv add claude-agent-sdk

python3 -m venv .venv && source .venv/bin/activate
pip3 install claude-agent-sdk

ANTHROPIC_API_KEY=your-api-key

​

Criar um arquivo com bugs

def calculate_average(numbers):
    total = 0
    for num in numbers:
        total += num
    return total / len(numbers)


def get_user_name(user):
    return user["name"].upper()

1. calculate_average([]) falha com divisão por zero
2. get_user_name(None) falha com um TypeError

​

Construir um agente que encontra e corrige bugs

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ResultMessage


async def main():
    # Agentic loop: streams messages as Claude works
    async for message in query(
        prompt="Review utils.py for bugs that would cause crashes. Fix any issues you find.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],  # Tools Claude can use
            permission_mode="acceptEdits",  # Auto-approve file edits
        ),
    ):
        # Print human-readable output
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)  # Claude's reasoning
                elif hasattr(block, "name"):
                    print(f"Tool: {block.name}")  # Tool being called
        elif isinstance(message, ResultMessage):
            print(f"Done: {message.subtype}")  # Final result


asyncio.run(main())

1. query: o ponto de entrada principal que cria o loop agentic. Ele retorna um iterador assíncrono, então você usa async for para transmitir mensagens enquanto Claude trabalha. Veja a API completa na referência do SDK Python ou TypeScript.
2. prompt: o que você quer que Claude faça. Claude descobre quais ferramentas usar com base na tarefa.
3. options: configuração para o agente. Este exemplo usa allowedTools para pré-aprovar Read, Edit e Glob, e permissionMode: "acceptEdits" para auto-aprovar alterações de arquivo. Outras opções incluem systemPrompt, mcpServers e muito mais. Veja todas as opções para Python ou TypeScript.

​

Execute seu agente

python3 agent.py

npx tsx agent.ts

1. Leu utils.py para entender o código
2. Analisou a lógica e identificou casos extremos que causariam falhas
3. Editou o arquivo para adicionar tratamento de erros apropriado

​

Tente outros prompts

• "Add docstrings to all functions in utils.py"
• "Add type hints to all functions in utils.py"
• "Create a README.md documenting the functions in utils.py"

​

Personalize seu agente

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Edit", "Glob", "WebSearch"], permission_mode="acceptEdits"
)

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Edit", "Glob"],
    permission_mode="acceptEdits",
    system_prompt="You are a senior Python developer. Always follow PEP 8 style guidelines.",
)

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Edit", "Glob", "Bash"], permission_mode="acceptEdits"
)

​

Conceitos-chave

​

Solução de problemas

​

Erro de API thinking.type.enabled não é suportado para este modelo

API Error: 400 {"type":"invalid_request_error","message":"\"thinking.type.enabled\" is not supported for this model. Use \"thinking.type.adaptive\" and \"output_config.effort\" to control thinking behavior."}

​

Próximos passos

• Permissões: controle o que seu agente pode fazer e quando precisa de aprovação
• Hooks: execute código personalizado antes ou depois de chamadas de ferramenta
• Sessões: construa agentes multi-turno que mantêm contexto
• Servidores MCP: conecte-se a bancos de dados, navegadores, APIs e outros sistemas externos
• Hospedagem: implante agentes no Docker, nuvem e CI/CD
• Agentes de exemplo: veja exemplos completos: assistente de email, agente de pesquisa e muito mais