---
title: "Claude Agent SDK: recursos, versão e início rápido · DotsAgent"
description: "Claude Agent SDK, de Anthropic: licença, versão mais recente, suporte a MCP, execuções duráveis, aprovação humana, tracing e avaliações, além de um início rápido para copiar."
url: https://dotsagent.io/pt/frameworks/claude-agent-sdk
---

Framework · Anthropic

# 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](https://github.com/anthropics/claude-agent-sdk-python) · 8.200 estrelas
- **Opção hospedada**: [Claude Managed Agents](https://code.claude.com/docs/en/agent-sdk/overview)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

`Instalar`

```
pip install claude-agent-sdk
```

Requer ANTHROPIC_API_KEY

`Python`

```
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](https://code.claude.com/docs/en/agent-sdk/overview)

### TypeScript

`Instalar`

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

Requer ANTHROPIC_API_KEY

`TypeScript`

```
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](https://code.claude.com/docs/en/agent-sdk/overview)

## Recursos

| Qualquer modelo | — | Apenas Claude, via Anthropic, Bedrock, Google Cloud ou Foundry |
| --- | --- | --- |
| Cliente MCP | — | Opção mcpServers; plugins podem incluir servidores MCP |
| Servidor MCP | — | — |
| Multiagente | — | Subagentes executam subtarefas específicas |
| Execuções duráveis | — | As sessões podem ser retomadas ou ramificadas; não há um mecanismo de durabilidade |
| Aprovação humana | — | Os modos de permissão definem quais ferramentas precisam de aprovação |
| Rastreamento | — | Exportação via OpenTelemetry; traces estão em beta |
| Avaliações | — | — |

## 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

- [OpenAI Agents SDK](https://dotsagent.io/pt/frameworks/openai-agents-python)

- [OpenAI Agents SDK (JS)](https://dotsagent.io/pt/frameworks/openai-agents-js)

- [Google ADK](https://dotsagent.io/pt/frameworks/google-adk)

- [Microsoft Agent Framework](https://dotsagent.io/pt/frameworks/microsoft-agent-framework)

- [LangGraph](https://dotsagent.io/pt/frameworks/langgraph)

- [CrewAI](https://dotsagent.io/pt/frameworks/crewai)

## Fontes

1. [code.claude.com](https://code.claude.com/docs/en/agent-sdk/overview)/docs/en/agent-sdk/overview
2. [code.claude.com](https://code.claude.com/docs/en/agent-sdk/quickstart)/docs/en/agent-sdk/quickstart
3. [code.claude.com](https://code.claude.com/docs/en/agent-sdk/observability)/docs/en/agent-sdk/observability
4. [code.claude.com](https://code.claude.com/docs/en/bedrock-vertex)/docs/en/bedrock-vertex
5. [pypi.org](https://pypi.org/pypi/claude-agent-sdk/json)/pypi/claude-agent-sdk/json
6. [registry.npmjs.org](https://registry.npmjs.org/@anthropic-ai%2fclaude-agent-sdk)/@anthropic-ai%2fclaude-agent-sdk
7. [api.github.com](https://api.github.com/repos/anthropics/claude-agent-sdk-python)/repos/anthropics/claude-agent-sdk-python
8. [api.github.com](https://api.github.com/repos/anthropics/claude-agent-sdk-typescript)/repos/anthropics/claude-agent-sdk-typescript

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026