Repolode
Enviar
anthropics

anthropics/claude-agent-sdk-python

SDK Python para criar agentes com Claude Code, usando query(), um cliente interativo, ferramentas personalizadas no processo e hooks.

Ver no GitHub
Estrelas
8,304
Forks
1,363
Issues abertas
571
Último commit
ontem

O que é?

O Claude Agent SDK for Python permite que aplicações Python controlem o Claude Code programaticamente. Instale o pacote com pip e chame query() para enviar um prompt e percorrer as mensagens da resposta transmitida em streaming, ou use ClaudeSDKClient para conversas bidirecionais com várias interações.

O pacote inclui a CLI do Claude Code, então, por padrão, não é necessário instalá-la separadamente. Também é possível configurar uma instalação global ou o caminho de uma CLI específica. Por padrão, Claude tem acesso a todo o conjunto de ferramentas do Claude Code, como Read, Write, Edit e Bash. Os parâmetros allowed_tools, disallowed_tools e permission_mode controlam as aprovações.

Com ClaudeSDKClient, você pode definir ferramentas personalizadas como funções Python executadas como servidores MCP no próprio processo e registrar hooks executados em etapas do loop do agente, como bloquear um comando Bash antes que ele seja executado. O SDK também oferece opções tipadas, classes de mensagem e classes de erro para tratar os resultados.

Recursos principais

  • 01Transmitir respostas do Claude Code por streaming com uma função assíncrona query().
  • 02Executar sessões interativas com várias interações usando ClaudeSDKClient.
  • 03Definir ferramentas personalizadas como servidores MCP no próprio processo usando um decorator do Python.
  • 04Registrar hooks em Python executados em etapas do loop do agente.
  • 05Controlar permissões de ferramentas com listas de ferramentas permitidas e bloqueadas e modos de permissão.

Casos de uso

  • Integrar um agente de programação com Claude a uma aplicação Python ou ferramenta interna.
  • Adicionar funções Python específicas de um domínio como ferramentas que Claude pode chamar.
  • Aplicar políticas, como bloquear determinados comandos de shell com hooks.
  • Criar fluxos de trabalho automatizados que executam o Claude Code em um diretório de projeto.

Início rápido

  1. 1

    Instale o SDK pelo PyPI

    pip install claude-agent-sdk
  2. 2

    Salve o código de início rápido do README em um arquivo Python e execute-o com anyio

Antes de usar

  • O uso é regido pelos Commercial Terms of Service da Anthropic, e não apenas pela licença MIT.
  • É necessário usar Python 3.10 ou posterior.
  • Para consultar o Claude, é necessário ter acesso ao serviço da Anthropic e credenciais.

Tópicos

#ai#agent#llm#claude#python-sdk#mcp#anthropic

Perguntas frequentes

O que é claude-agent-sdk-python?
SDK Python para criar agentes com Claude Code, usando query(), um cliente interativo, ferramentas personalizadas no processo e hooks. O Claude Agent SDK for Python permite que aplicações Python controlem o Claude Code programaticamente. Instale o pacote com pip e chame query() para enviar um prompt e percorrer as mensagens da resposta transmitida em streaming, ou use ClaudeSDKClient para conversas bidirecionais com várias interações.
claude-agent-sdk-python é gratuito? Qual é a licença?
claude-agent-sdk-python é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-agent-sdk-python ainda é mantido?
Manutenção ativa. O último commit de claude-agent-sdk-python foi em 19 de out. de 2026.
Para que posso usar claude-agent-sdk-python?
Integrar um agente de programação com Claude a uma aplicação Python ou ferramenta interna. Adicionar funções Python específicas de um domínio como ferramentas que Claude pode chamar. Aplicar políticas, como bloquear determinados comandos de shell com hooks. Criar fluxos de trabalho automatizados que executam o Claude Code em um diretório de projeto.
Como instalar claude-agent-sdk-python?
Instale o SDK pelo PyPI: pip install claude-agent-sdk Salve o código de início rápido do README em um arquivo Python e execute-o com anyio
Onde consigo claude-agent-sdk-python?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/anthropics/claude-agent-sdk-python

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados