Como ligar o seu Claude Code ao Benflow

Para a IA trabalhar nos chamados, cada pessoa liga o próprio Claude Code ao Benflow pelo plugin Benflow. Leva poucos minutos. É um Claude por pessoa em cada organização.

Antes de começar

• Claude Code instalado e logado, no Mac ou no Windows. Vale o terminal, a extensão do VS Code ou do JetBrains e o app do Claude.
• Node 22 ou mais novo. Confira com node --version. No Windows, dá para instalar com winget install OpenJS.NodeJS.LTS.

Passo a passo

1. 1
   Passo 1: No painel, abra Equipe IA e, na aba Agentes, clique em Ligar meu Claude.
2. 2
   Passo 2: Se quiser, dê um nome em Nome do agente. Sem nome, fica algo como "Claude do Pedro" ou "Claude da Júlia". Clique em Gerar token.
3. 3
   Passo 3: Na tela Seu Claude está quase ligado, copie o token do agente e a URL deste painel. O token aparece só agora.
4. 4
   Passo 4: No Claude Code, rode os dois comandos da seção 1. Instale o plugin Benflow: o que adiciona o marketplace do Benflow e o que instala o plugin, prontos para copiar. Se, em Adicione o marketplace do Benflow, a tela pedir o endereço ao administrador em vez de mostrar o comando pronto, o plugin ainda não foi publicado para o seu painel: abra um chamado no suporte antes de seguir.
5. 5
   Passo 5: Quando o Claude Code pedir, cole o endereço e o token. O token fica no cofre de senhas do sistema (Keychain, no Mac), não em arquivo.
6. 6
   Passo 6: Vai usar o botão Com IA do chamado? Ainda com a tela aberta, faça também a seção 2. Deixe o executor rodando para o botão Com IA: o comando de configurar pede o mesmo token. Veja como ligar o executor.
7. 7
   Passo 7: Clique em Pronto, já copiei. O seu agente aparece como Online no primeiro sinal do plugin ou do executor.

/plugin install benflow@benflow-marketplace

Usar no Claude Code

Com o plugin ligado, fale de chamados normalmente, como "o que tem pra fazer?" ou "pega o chamado 12". O Claude lista as tarefas, mostra o card e pergunta o que fazer antes de mexer no código. Também há três comandos:

/benflow
/benflow:trabalhar 12
/benflow:status

• /benflow conduz a conversa sobre os chamados.
• /benflow:trabalhar 12 começa a trabalhar no chamado 12.
• /benflow:status mostra a conexão, os chamados abertos, os ambientes e as permissões de publicação.

Ao abrir o Claude Code na pasta de um repositório da organização, ele mostra um resumo dos chamados abertos. Nada vai para o GitHub sem você pedir: a publicação continua pelos botões do painel.

Para o painel mandar trabalho para o seu Claude pelo botão Com IA, falta deixar o executor ligado. Veja como mandar um chamado para a IA.

Token, desativar e excluir

No card do seu agente, na aba Agentes, ficam os botões:

• Gerar novo token: o token atual para de valer na hora e a tela Seu Claude está quase ligado abre de novo, com o token novo. Informe o novo no Claude Code (em /plugin, no plugin benflow) e rode de novo o comando de configurar do executor.
• Desativar: o agente para de receber trabalho, o que ele estava fazendo recebe o pedido de parar, o que estava na fila sai dela e as ferramentas do Benflow param de responder para ele até alguém clicar em Reativar.
• Excluir: o token deixa de valer, os trabalhos em aberto desse agente são cancelados e ele sai da lista. O histórico continua nos chamados.

Membro cuida só do próprio Claude. Se um admin desativou o seu agente, só um admin reativa; até lá, você também não gera token novo nem exclui o agente.

Para admins

O admin da organização liga o Claude de outro membro: em Ligar meu Claude (ou Ligar para outro membro, se você já tem o seu), escolha a pessoa em De quem é. Entregue o token para ela colocar na máquina dela. O admin também troca o token, desativa e exclui o agente de qualquer membro.