Source: https://aiprimetech.io/pt/claude-code/sdk/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › Agent SDK

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# O SDK do Claude Code, agora Claude Agent SDK

O mesmo ciclo de agente que é executado no seu terminal está disponível como biblioteca. A Anthropic renomeou o Claude Code SDK para Claude Agent SDK quando ficou claro que as pessoas estavam criando muito mais do que ferramentas de programação com ele.

## TLDR
- Python: pip install claude-agent-sdk; TypeScript: npm install @anthropic-ai/claude-agent-sdk.
- Você obtém o agente completo — ferramentas de arquivos, bash, subagentes, MCP — controlado por código, com callbacks de permissão.
- O SDK lê ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY como a CLI, portanto a cobrança pelo gateway se aplica.

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

## Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

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

[Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE)

## Perguntas frequentes

O Claude Code SDK é o mesmo que o SDK da Anthropic?

Não. O SDK da Anthropic chama a Messages API diretamente. O Claude Agent SDK (anteriormente Claude Code SDK) executa o agente completo — ferramentas, arquivos, bash, subagentes — sobre essa API.Quais linguagens o Agent SDK suporta?

Python e TypeScript oficialmente; qualquer outra linguagem pode controlar o modo de impressão da CLI com saída JSON.O SDK funciona com uma URL base personalizada?

Sim. Ele herda ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY do ambiente, exatamente como a CLI.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/)

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.

## Mais guias do Claude Code

[Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)