Claude Agent SDK em resumo

O SDK da Anthropic disponibiliza a infraestrutura de execução por trás do Claude Code, com ferramentas de arquivos e shell, permissões, hooks, subagentes e skills, dentro do seu próprio programa em Python ou TypeScript. Ao contrário dos demais desta lista, ele funciona apenas com modelos Claude, e seu uso é regido pelos Termos Comerciais da Anthropic.

Ideal para: Apps em que o Claude precisa trabalhar de verdade no sistema de arquivos, com permissões de ferramentas que você controla.

Principais informações

Responsável pela manutenção

Anthropic

Linguagens

Python, TypeScript

Licença

Anthropic Commercial Terms

Versão mais recente

Python 0.2.163 / TypeScript 0.3.286 · 30 de setembro de 2026

Repositório

anthropics/claude-agent-sdk-python · 8.200 estrelas

Opção hospedada

Claude Managed Agents

A Anthropic hospeda a infraestrutura de execução; as sessões rodam em um sandbox gerenciado pela Anthropic ou auto-hospedado.

Início rápido

Instale o pacote, configure as credenciais e execute o agente mais simples da documentação oficial. Os IDs dos modelos são os usados na documentação e talvez não estejam habilitados na sua conta.

Python

pip install claude-agent-sdk

Requer ANTHROPIC_API_KEY

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())

Fonte do início rápido

TypeScript

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

Requer ANTHROPIC_API_KEY

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

for await (const message of query({
  prompt: "Find and fix the bug in auth.ts",
  options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
  console.log(message); // Claude reads the file, finds the bug, edits it
}

Fonte do início rápido

Recursos

Mudanças recentes

• Renomeado de Claude Code SDK; há um guia de migração disponível.
• Os dois SDKs agora incluem um binário nativo do Claude Code.
• Desde 15 de junho de 2026, o uso do SDK nos planos de assinatura consome um crédito mensal separado do Agent SDK.
• Apps de terceiros não podem oferecer login com claude.ai sem a aprovação da Anthropic.

Alternativas na mesma linguagem