O SDK do Claude Code, agora Claude Agent SDK

Duas maneiras de automatizar o Claude Code

A opção mais simples é o modo de impressão da CLI — claude -p a partir de qualquer linguagem, com saída JSON. A opção completa é o Agent SDK, que expõe o ciclo, o conjunto de ferramentas, os hooks e as permissões como objetos que você controla.

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

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

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

Execução usando o gateway

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

O SDK inicia o mesmo ambiente de execução do Claude Code, portanto as variáveis de ambiente são tudo de que ele precisa. É nos agentes de longa duração que o preço do gateway mais importa: um ciclo autônomo pode fazer centenas de chamadas por hora, e um plano de preço fixo transforma isso de uma estimativa de custo em um valor fixo.

O que o SDK acrescenta ao modo de impressão

• Callbacks de permissão — aprove ou negue cada chamada de ferramenta a partir do seu próprio código.
• Ferramentas personalizadas por meio de servidores MCP no mesmo processo, para que o agente possa chamar suas funções.
• Hooks para eventos de ferramentas, ciclo de vida da sessão e erros.
• Subagentes e saída estruturada, sem executar comandos em um shell e analisar texto.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.