Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
agent-framework-claude encapsula o SDK do Claude Agent como ClaudeAgent. Ele usa o ambiente de execução gerenciado de agentes do Claude, as sessões, o modelo de permissões, as ferramentas integradas e o suporte a MCP, ao mesmo tempo que expõe as interfaces de execução e streaming do Agent Framework.
Esta integração é diferente do provedor de modelo do Anthropic, que usa o Claude como modelo por trás de um agente do Agent Framework pertencente ao aplicativo.
Prerequisites
- Instale e configure a CLI do Claude Code.
- Escolha um modelo Claude e um modo de permissão.
- Execute o agente em um diretório de trabalho com restrições ao habilitar ferramentas de arquivo ou shell.
Instalar o pacote
pip install agent-framework-claude --pre
Configuration
| Variable | Purpose |
|---|---|
CLAUDE_AGENT_MODEL |
Modelo de Claude usado pelo runtime gerenciado. |
CLAUDE_AGENT_PERMISSION_MODE |
Modo de permissão padrão para ferramentas internas e ferramentas MCP. |
CLAUDE_AGENT_CLI_PATH |
Caminho explícito opcional para a CLI do Claude Code. |
CLAUDE_AGENT_CWD |
Diretório de trabalho exposto ao ambiente de execução. |
CLAUDE_AGENT_MAX_TURNS |
Número máximo opcional de turnos de agente. |
CLAUDE_AGENT_MAX_BUDGET_USD |
Orçamento de custo opcional para uma execução. |
Valores zero explícitos para max_turns e max_budget_usd são encaminhados para o SDK do Claude Agent. Somente valores não definidos (None) são omitidos.
Criar um ClaudeAgent
ClaudeAgent dá suporte a execuções regulares e de streaming e pode expor ferramentas de função do Agent Framework.
async def non_streaming_example() -> None:
"""Example of non-streaming response."""
print("=== Non-streaming Example ===")
agent = ClaudeAgent(
name="BasicAgent",
instructions="You are a helpful assistant. Keep responses concise.",
tools=[get_weather],
)
async with agent:
query = "What's the weather in Seattle?"
print(f"User: {query}")
result = await agent.run(query)
print(f"Agent: {result.text}\n")
async def streaming_example() -> None:
"""Example of streaming response."""
print("=== Streaming Example ===")
agent = ClaudeAgent(
name="StreamingAgent",
instructions="You are a helpful assistant.",
tools=[get_weather],
)
async with agent:
query = "What's the weather in Paris?"
print(f"User: {query}")
print("Agent: ", end="", flush=True)
async for chunk in agent.run(query, stream=True):
if chunk.text:
print(chunk.text, end="", flush=True)
print("\n")
Quando você injeta um existente ClaudeSDKClient, o agente o empresta e ignora o caminho da CLI, o diretório de trabalho, a permissão e outras configurações de construção do cliente. Configure e feche o cliente injetado em seu aplicativo.
Exemplos adicionais demonstram:
- Ferramentas integradas do Claude para arquivos e shell.
- Tratamento interativo de permissões.
- Servidores MCP locais e remotos.
- Persistência e retomada da sessão.
- Fluxos de trabalho sequenciais que transferem mensagens anteriores entre agentes Claude.
- Busca de URLs e múltiplas regras de permissão.
Quando ClaudeAgent recebe várias mensagens, ele envia um prompt que as enquadra como histórico de conversa e rotula cada mensagem por função. Essa abordagem preserva os limites entre funções durante as transferências entre agentes, mas não reproduz o histórico nativo de múltiplos papéis do Claude nem compartilha uma sessão do Claude. Uma única mensagem de usuário permanece inalterada.
Considerações sobre permissão
- Comece com o modo de permissão menos permissivo do SDK do Claude Agent que ofereça suporte à tarefa.
- Exija aprovação explícita para operações de shell, arquivo, rede ou outras operações com efeitos colaterais.
- Não exponha credenciais por meio de variáveis de ambiente ou arquivos legíveis no diretório de trabalho do agente.