Como usar Claude no Zé Bot

O que é

O Claude é um dos provedores do Zé Bot. Ele usa o Claude Code e aceita a sua conta Claude ou uma chave da Anthropic. O Zé Bot organiza o workspace, as instruções, as ferramentas, as aprovações e o histórico em volta do CLI.

Antes de começar

Uma conta Claude com acesso ao Claude Code, ou uma chave da Anthropic.
O Claude Code CLI instalado, ou o runtime gerenciado pelo Zé Bot.
Uma pasta de trabalho para o agente.
O nível de aprovação definido para o tipo de tarefa.

Como conectar

Abra Configurações → Provedores.
Escolha Claude.
Entre com a conta Claude pelo fluxo oficial ou configure ANTHROPIC_API_KEY.
Confirme o status do provedor.
Volte para a lista de agentes.

Se preferir o terminal, rode claude auth login antes de abrir o Zé Bot.

Como criar um agente com Claude

Crie ou abra um agente.
Em Provedor, escolha Claude.
Escolha o modelo:
- Claude Opus 5 para tarefas mais complexas;
- Claude Sonnet 5.5 como equilíbrio entre qualidade e custo;
- Claude Haiku 5.5 para tarefas mais simples e rápidas.
Envie uma tarefa curta para validar.
Ajuste instruções, ferramentas e workspace.

Exemplo

Peça: “Revise este arquivo de configuração e aponte riscos de segurança antes de propor qualquer alteração”. O agente lê o arquivo no workspace, analisa e responde com o que encontrou. Se precisar editar, o cartão de aprovação aparece conforme o nível escolhido.

Limites e cuidados

A conta e o plano do Claude precisam ter acesso ao Claude Code.
O Zé Bot não fornece o modelo nem intermedeia a cobrança.
O nível de aprovação vale para o agente inteiro.
Os modelos disponíveis dependem do que a sua conta e o CLI expõem.
O workspace não é um sandbox de shell.

Problemas comuns

O Claude não aparece como conectado

Rode claude auth login no terminal ou configure ANTHROPIC_API_KEY. Confira se o CLI está no PATH.

O modelo escolhido não responde

Confira se a conta tem acesso ao modelo e se o CLI foi atualizado. Troque para outro modelo da lista para isolar o problema.

O agente pede aprovação demais

Ajuste o nível em Detalhes do agente → Comportamento. Aceitar edições de arquivo reduz interrupções sem liberar comandos.

Próximos passos

Leia o lançamento em /blog/claude.
Veja os outros manuais em /manual.