3.7.7 · Agent SDK

Python

pip install claude-agent-sdk

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    options = ClaudeAgentOptions(
        system_prompt="Você é um assistente de projeto SAP da Wayon.",
        allowed_tools=["Read", "Grep", "Glob"],   # somente leitura
        permission_mode="acceptEdits",
        max_turns=15,
        cwd="/projetos/meridiano",
    )

    async for message in query(
        prompt="Liste os RICEFW cuja FS ainda não tem cenário de teste associado.",
        options=options,
    ):
        print(message)


asyncio.run(main())

Para conversa com mais de um turno, existe ClaudeSDKClient, que mantém o contexto entre perguntas:

from claude_agent_sdk import ClaudeSDKClient, AssistantMessage, TextBlock

async def main():
    async with ClaudeSDKClient() as client:
        await client.query("Quais RICEFW estão sem cenário de teste?")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

        await client.query("Desses, quais são de MM?")   # mantém o contexto anterior
        async for message in client.receive_response():
            ...

TypeScript

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

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Liste os RICEFW sem cenário de teste associado.",
  options: {
    allowedTools: ["Read", "Grep", "Glob"],
    maxTurns: 15,
    cwd: "/projetos/meridiano",
  },
})) {
  console.log(message);
}

A biblioteca existe só em Python e TypeScript. Em qualquer outra linguagem, o caminho documentado é rodar o CLI como subprocesso, com -p e --output-format json — que é exatamente o modo headless da aula 3.5.3.

As opções, e de onde elas vêm

A tabela resume o módulo inteiro: as decisões que você tomou nos módulos anteriores viram parâmetros de código. O que era configuração de ferramenta passa a ser argumento de função.

O que ele carrega sozinho

O SDK lê o .claude/ do projeto e o ~/.claude/ do usuário, como o Claude Code faria:

É o arco do nível se fechando. A skill de FS escrita no módulo 2.4, empacotada em plugin no 3.3, rodando no CI no 3.5.5 — a mesma skill roda dentro do agente que a Wayon embute num produto do cliente, sem reescrever nada.

As quatro formas de construir agente

preview — pode mudar · Managed Agents está em beta.

Duas confusões que essa tabela desfaz:

• Tool runner ≠ Agent SDK. O tool runner é um auxiliar do SDK da API (anthropic), que roda o laço sobre as suas ferramentas. O Agent SDK é outro pacote (claude-agent-sdk), com o arsenal do Claude Code embutido. Nomes parecidos, propósitos diferentes.
• Só Managed Agents hospeda. Laço manual, tool runner e Agent SDK rodam na sua infraestrutura — servidor, contêiner ou máquina da Wayon. Isso é decisão de arquitetura e de custo, e precisa estar na proposta.

O que isso significa para a Wayon

O Agent SDK traz ferramentas que escrevem em disco e executam comando. Embutido num produto que toca pasta de projeto de cliente, ele é a mesma exposição do módulo 3.4, agora dentro de um produto entregue:

Regra Wayon Produto da Wayon construído com Agent SDK que toque pasta de cliente roda com allowed_tools mínimo, max_turns declarado e cwd restrito a diretório dedicado — nunca a raiz de um projeto. O resultado passa pela verificação do módulo 3.4 antes de chegar ao cliente. E a escolha entre Agent SDK e Managed Agents é registrada com a razão: uma põe a infraestrutura na Wayon, a outra na Anthropic, e as duas têm implicação de custo, de latência e de onde o dado do cliente é processado.

📖 Agent SDK overview · Python SDK · TypeScript SDK