Passar para o conteúdo principal

Como instalar o Estúdio IA no Claude

Instale o plugin do Estúdio IA pelas Configurações do app do Claude, pedindo ao próprio Claude ou pelo terminal, conecte a sua conta Ploomes e peça telas, formulários de CPQ, fluxos, configurações e respostas sobre os seus dados.

Escrito por Ploo

O Estúdio IA chega ao Claude como um plugin da Ploomes que trabalha na sua conta a partir de uma conversa. Você pede uma tela, um formulário de CPQ, um fluxo no Ploomes Flows ou uma configuração da conta, ou pergunta algo sobre os seus dados, e o Claude resolve ali mesmo.

Este artigo mostra três jeitos de instalar o plugin (escolha o mais fácil para você), como conectar a sua conta Ploomes e como fazer o primeiro pedido.

1) Pré-requisitos

  • App do Claude no computador (Mac ou Windows), com um plano que inclua o Claude Code: Pro, Max, Ultra, Team ou Enterprise. O plano gratuito do Claude não inclui o Claude Code.

  • Um usuário de integração com o perfil Administrador na sua conta Ploomes, em Administração › Usuários de integração. A chave desse usuário conecta o plugin à sua conta.

Nota: você não precisa instalar mais nada. Se o plugin não encontrar no computador o que precisa para rodar, ele baixa sozinho.

⚠️ Ainda não tem o app do Claude? Baixe em claude.com/download, instale e entre com a sua conta do Claude.

2) Instalando o plugin

Escolha um dos três jeitos. Todos chegam ao mesmo resultado.

Três jeitos de instalar o Estúdio IA

Opção 1: pelas Configurações do app (só cliques)

1. No app do Claude, abra as Configurações (no menu da sua conta, no canto inferior esquerdo) e vá em Personalização › Plugins.

2. Clique em Adicionar › Adicionar marketplace.

Opção 1: abra Configurações › Plugins

3. Escolha Adicionar de um repositório e digite:

Ploomes/construtor-ploomes-plugin

4. Clique em Usar "Ploomes/construtor-ploomes-plugin".

Opção 1: adicione o marketplace da Ploomes

5. Na aba Descobrir, o plugin aparece como Construtor Ploomes. Clique em Adicionar.

Opção 1: adicione o plugin

Opção 2: pedindo ao Claude (uma mensagem)

1. No canto superior esquerdo do app, clique no ícone </> para abrir a aba Code. Comece uma sessão nova, em qualquer pasta.

2. Cole a mensagem abaixo e envie:

Rode estes comandos:
/plugin marketplace add Ploomes/construtor-ploomes-plugin
/plugin install construtor-ploomes@construtor-ploomes

3. O Claude roda os dois comandos e avisa quando terminar. Se ele pedir permissão para rodar um comando, autorize.

Opção 2: peça ao Claude para instalar

Opção 3: pelo terminal

Para quem já usa o Claude Code no terminal. No Windows, o terminal é o PowerShell: abra o menu Iniciar, digite PowerShell e abra o Windows PowerShell.

1. Entre numa pasta vazia e inicie o Claude Code:

mkdir estudio-ia
cd estudio-ia
claude

2. Digite os dois comandos, um de cada vez:

/plugin marketplace add Ploomes/construtor-ploomes-plugin
/plugin install construtor-ploomes@construtor-ploomes

3. Na tela de detalhes do plugin, escolha Install for you (user scope).

4. Rode /reload-plugins.

Opção 3: pelo terminal

Ainda não tem o Claude Code no terminal? No macOS: curl -fsSL https://claude.ai/install.sh | bash. No Windows (PowerShell): irm https://claude.ai/install.ps1 | iex. Depois, rode claude e entre com a sua conta. O passo a passo completo está no guia oficial de instalação.

Nota: no Claude, o Estúdio IA aparece com o nome técnico Construtor Ploomes (construtor-ploomes). Os comandos deste artigo usam esse nome.

3) Criando a pasta do Estúdio IA

O Estúdio IA trabalha dentro de uma pasta do seu computador. É nela que ficam os arquivos de cada tela ou formulário que você construir. A pasta pode ficar em qualquer lugar; a sugestão é criar dentro de Documentos.

  • No Mac: abra o Finder, entre em Documentos, clique com o botão direito num espaço vazio e escolha Nova Pasta.

  • No Windows: abra o Explorador de Arquivos, entre em Documentos, clique com o botão direito num espaço vazio e escolha Novo › Pasta.

Dê à pasta o nome Estúdio IA.

Passo 1: crie uma pasta para o Estúdio IA

Nota: use sempre a mesma pasta. O Estúdio IA cria dentro dela uma subpasta para cada tela ou formulário. A versão oficial de cada um fica salva na sua conta Ploomes, então nada se perde se a pasta for apagada.

4) Abrindo a aba Code

O Estúdio IA funciona na aba Code do app do Claude. Para abrir:

  1. No app do Claude, olhe o canto superior esquerdo. Ali ficam dois ícones lado a lado: o balão, que é o Chat, e o </>, que é o Code.

  2. Clique no </>.

Na dúvida, passe o mouse sobre os ícones: o nome de cada um aparece.

O ícone da aba Code, no canto superior esquerdo do app

Passo 2: abra a aba Code

5) Escolhendo a pasta do Estúdio IA

  1. Ainda na aba Code, comece uma sessão nova.

  2. Embaixo da caixa de mensagem, clique no seletor de pasta e escolha Estúdio IA. Na primeira vez, a pasta ainda não aparece na lista: use a opção de abrir pasta e procure em Documentos.

  3. Ao lado do seletor de pasta, deixe o ambiente em Local, que é o seu computador.

Passo 3: escolha a pasta do Estúdio IA

6) Conectando a sua conta Ploomes

6.1) Copie a chave do usuário de integração

  1. No Ploomes, acesse Administração no menu lateral.

  2. Clique em Usuários de integração.

  3. Clique no usuário de integração com o perfil Administrador.

  4. Copie a chave do campo Chave da API.

Ainda não tem um usuário de integração? Clique em Novo usuário, preencha nome e e-mail e escolha o perfil Administrador. O artigo Como obter acesso à API do Ploomes mostra o processo completo.

Passo 4: copie a chave do usuário de integração

6.2) Cole a chave na página de login

  1. Faça o primeiro pedido na sessão. A página Conectar a conta da Ploomes abre ao lado da conversa (no terminal, ela abre no navegador). Se preferir conectar antes de pedir algo, rode /construtor-ploomes:conectar.

  2. Cole a chave no campo User-Key e clique em Conectar.

  3. Quando aparecer Conta conectada, volte à conversa e peça de novo.

Passo 5: conecte a sua conta

❗ Importante: a chave fica só na página de login e no plugin do seu computador. Nunca cole a chave na conversa com o Claude.

Nota: use a chave de um usuário de integração. A chave de um usuário comum muda a cada entrada no CRM Web, e o Estúdio IA para até você conectar de novo.

7) O que você pode pedir

Com a conta conectada, escreva o pedido em linguagem natural. O Estúdio IA cuida de:

  • Telas no CRM: painéis, quadros kanban, listas e mini-aplicações, que entram no menu do Ploomes depois de publicadas.

  • Formulários de CPQ: o formulário de propostas, vendas e documentos, montado a partir de um modelo de documento da conta.

  • Fluxos no Ploomes Flows: integrações e automações construídas no Ploomes Flows, quando a sua conta tem esse módulo.

  • Configurações da conta: campos, formulários, automações e permissões, configurados direto pela conversa.

  • Perguntas sobre os dados: clientes, negócios, propostas e vendas da conta, com a resposta na conversa.

  • Versões e publicação: cada resposta vira uma versão, e você pode ver e restaurar versões anteriores.

O que você pode pedir ao Estúdio IA

Alguns exemplos de pedido:

  • "Crie uma tela no Ploomes com os negócios abertos do mês, agrupados por etapa."

  • "Crie o formulário de CPQ do meu modelo de proposta."

  • "Crie um fluxo que avise o responsável quando um negócio ficar 7 dias parado na mesma etapa."

  • "Crie um campo de seleção Origem do lead no cadastro de clientes."

  • "Quantos negócios foram ganhos neste trimestre, por vendedor?"

Quando o pedido é uma tela ou um formulário, a prévia abre ao lado da conversa, com o status da versão e o botão Publicar. A tela só chega ao CRM quando você clica em Publicar e confirma.

Passo 6: peça o que precisar

8) Comandos do plugin

  • /construtor-ploomes:conectar: abre a página de login da Ploomes e troca a conta conectada.

  • /construtor-ploomes:status: mostra a conta conectada, a pasta e a tela ativa.

  • /construtor-ploomes:artefatos: lista as telas e os formulários de CPQ da conta.

  • /construtor-ploomes:ajuda: explica o que dá para pedir ao Estúdio IA.

9) Mantendo o plugin atualizado

Quando sair uma versão nova, o Estúdio IA avisa na conversa.

  • Instalou pelas Configurações: a atualização chega pelo marketplace, em Configurações › Plugins.

  • Instalou pedindo ao Claude ou pelo terminal: peça ao Claude "Atualize o plugin construtor-ploomes".

A versão nova vale a partir da próxima sessão.

10) Dúvidas frequentes

O Claude não conseguiu instalar o plugin. Confira se a sessão está na aba Code, numa pasta do seu computador, e envie a mensagem de novo. Se persistir, use a opção 1, pelas Configurações.

Posso usar outra pasta ou apagar a pasta Estúdio IA? Pode, mas prefira sempre a mesma: assim cada tela fica na sua subpasta e é fácil continuar de onde parou. Se apagar, as versões continuam na sua conta Ploomes, e o Estúdio IA retoma a tela a partir delas.

Como confiro se o plugin está instalado? Numa sessão nova, digite /construtor-ploomes: na caixa de mensagem: os quatro comandos do plugin aparecem na lista. Se não aparecerem, abra outra sessão, porque o plugin carrega na sessão seguinte à instalação.

A página de login diz "A Ploomes recusou essa User-Key". Copie a chave inteira de novo, sem espaço no começo ou no fim, e cole outra vez.

A página de login diz que o usuário não é administrador. O usuário de integração precisa do perfil Administrador. Ajuste o perfil em Administração › Usuários de integração.

O plugin aparece duas vezes. Ele foi instalado por mais de um jeito. Mantenha uma cópia: remova a das Configurações › Plugins ou peça ao Claude para desinstalar a outra.

Como troco a conta conectada? Rode /construtor-ploomes:conectar e confirme a troca. A página de login abre de novo para a chave da outra conta.

Leia também:

Esse artigo te ajudou? Deixe seu retorno abaixo para continuarmos sempre melhorando nossa base de conhecimento. 😊

Ficou com alguma dúvida? Não hesite em chamar o Suporte pelo chat da plataforma ou pelo e-mail suporte@ploomes.com.

Artigos relacionados
Respondeu à sua pergunta?