Instalar o Minutando

Do zero ao primeiro rascunho. Escrito para quem nunca abriu um terminal — se você souber copiar e colar, consegue.

◷ cerca de 20 minutos, uma vez só

Antes de começar, três coisas

1. O Minutando roda dentro do Claude Code, que é um programa da Anthropic. Ele não é vendido por nós e não está incluído na sua licença: você precisa de uma conta Claude com plano pago (ou créditos de API) para usá-lo. Se o seu gabinete ainda não tem, resolva isso primeiro — sem o Claude Code, o Minutando não roda. Para assinar, clique aqui.

2. Você vai precisar da sua chave de licença, que chegou por e-mail depois da compra. Ela começa com MIN-. Se não achar, ela também está na sua área.

3. Os autos e as suas minutas nunca passam pelo nosso servidor. Só a chave de licença e um identificador anônimo do computador falam com o nosso servidor. Nenhum documento é enviado a nós; o que o Claude Code lê vai à Anthropic, pela sua conta Claude.

O que você vai fazer

Passo	O que acontece	Quanto leva
1 · Instalar o Claude Code	Um comando, colado uma vez	5 min
2 · Entrar na sua conta	Abre o navegador e volta sozinho	2 min
3 · Registrar o seu endereço	O endereço pessoal que veio no e-mail	1 min
4 · Instalar o Minutando	Um comando	1 min
5 · Configurar o gabinete	Oito perguntas e a pasta das suas minutas	5 min
6 · A primeira minuta	Você aponta o processo e lê o resultado	o resto do dia

Instalar o Claude Code

No Windows (10 ou 11)

Abra o PowerShell: aperte a tecla Windows, digite powershell e tecle Enter. Vai abrir uma janela azul. Cole a linha abaixo e tecle Enter:

Windows PowerShell

PS C:\Users\voce> irm https://claude.ai/install.ps1 | iex
Baixando o Claude Code…
Instalando em C:\Users\voce\.local\bin
Pronto. Claude Code 2.1.x instalado.
Feche e abra o PowerShell de novo para o comando `claude` funcionar.

As linhas cinzas são a resposta do computador — você não digita nada delas. O texto exato varia com a versão e sai em inglês; o que importa é terminar sem mensagem de erro.

No Mac

Abra o Terminal (aperte ⌘ + espaço, digite terminal, Enter) e cole:

Terminal

~ % curl -fsSL https://claude.ai/install.sh | bash
Baixando o Claude Code…
Instalando em ~/.local/share/claude
Claude Code 2.1.240 instalado.

Esta saída é a do computador em que o Minutando foi construído — o número da versão pode ser maior no seu.

Se o comando não for reconhecido depois de instalar, feche a janela e abra de novo. O programa é encontrado na segunda abertura, não na primeira — é assim mesmo, não é erro seu.

Abrir e entrar na sua conta

Ainda na mesma janela, digite claude e tecle Enter. Na primeira vez ele pede que você entre na sua conta Anthropic: abre o navegador sozinho, você autoriza, e ele volta.

Claude Code

> claude

  ✻ Bem-vindo ao Claude Code

  Abrindo o navegador para você entrar…
  Autorize a sessão e volte para esta janela.

  ✔ Conectado.
  Digite / para ver os comandos disponíveis.

> ▍

A tela de boas-vindas sai em inglês e muda de versão para versão. O que vale é o essencial: daqui em diante tudo é digitado depois daquele >, dentro do Claude Code — não mais no PowerShell nem no Terminal.

Registrar o seu endereço pessoal

O comando abaixo tem um endereço que é só seu. Não o digite: copie-o pronto, de um dos dois lugares —

na sua área do cliente, em portal.minutando.com.br/painel, onde há um botão que copia a linha inteira; ou
no e-mail que veio com a sua chave, onde ela já está montada.

Os dois endereços são diferentes entre si e os dois funcionam — o do painel não mostra a sua chave, o do e-mail a carrega. Cole no Claude Code e tecle Enter:

Claude Code

> /plugin marketplace add https://portal.minutando.com.br/m/seu-endereço/marketplace.json

  Adding marketplace…
  Downloading marketplace from https://portal.minutando.com.br/…
  Validating marketplace data
  Saving marketplace to cache
  ✔ Successfully added marketplace: minutando

Saída real, capturada nesta instalação. O Claude Code responde em inglês — é assim mesmo, não é erro. O que importa é a última linha começar com ✔ Successfully added.

Se aparecer Invalid marketplace schema ou 404: o endereço foi cortado no meio ao copiar — ele é longo e termina sempre em /marketplace.json. Copie de novo pelo botão do painel, que pega a linha inteira.

Não repasse esse endereço. Quem o tiver baixa o produto no seu nome, e cada cópia sai marcada com o seu licenciado. Se ele vazar, escreva para contato@minutando.com.br e nós emitimos outra chave — a sua licença continua a mesma.

Instalar o Minutando

Claude Code

> /plugin install minutando

  Installing plugin "minutando"…
  ✔ Successfully installed plugin: minutando@minutando (scope: user)

Saída real, capturada nesta instalação — uma linha só, em inglês. Entram com ela 2 skills e 6 agentes: um lê o processo, um cuida da matéria, um confere a jurisprudência na fonte oficial, um escreve no tom do seu gabinete, um audita e um tenta derrubar o resultado antes de você ler. Para vê-los, digite /plugin.

Configurar o gabinete

Este é o passo que faz o Minutando escrever como o seu gabinete escreve, e não como um manual genérico. Roda uma vez só.

Claude Code

> /minutando-setup

====================================================================
  MINUTANDO - Assessoria Judicial Inteligente
  Equipe AssessorIA e AdvocacIA
====================================================================

  Vou fazer OITO perguntas. Uma de cada vez - responda e tecle Enter.
  Leva uns dois minutos, e e uma vez so: depois disto o Minutando ja
  sabe de que gabinete ele e.

  Cada pergunta vem com uma linha explicando o que se espera e um
  exemplo. Se aparecer algo entre [colchetes], e o que ja esta
  gravado: teclar Enter mantem.

  Os autos e as minutas do gabinete NUNCA saem desta maquina - so a
  chave de licenca fala com o portal.

--------------------------------------------------------------------

[1 de 8]  Qual e o seu nome?
    Quem esta licenciado a usar o Minutando - voce, o assessor.
    Nome e sobrenome, do jeito que voce assina.
    Exemplo: Maria Silva
    Seu nome: Maria Silva

[2 de 8]  Qual e o nome do juiz?
    Como ele assina as decisoes. Sem 'Dr.', sem 'MM.' e sem cargo -
    so o nome. O Minutando usa isto para escrever no tom dele.
    Exemplo: Joao Pereira
    Nome do juiz: Joao Pereira

   (… e assim ate a oitava, sempre uma por vez …)

[5 de 8]  Que tipo de vara e a sua?
    Escolha na lista abaixo. Nao precisa digitar o nome:
    digite so o NUMERO da linha e tecle Enter.

       1. Civel
       2. Fazenda Publica
       3. Familia e Sucessoes
       (… onze opcoes ao todo …)

    Digite o NUMERO da opcao e tecle Enter: 1
    -> Civel

[8 de 8]  Qual e a sua chave de licenca?
    Comeca com MIN- e tem tres blocos de cinco caracteres.
    Ela esta no e-mail da compra e na sua area em
    portal.minutando.com.br/painel, com botao de copiar.
    Exemplo: MIN-XXXXX-XXXXX-XXXXX
    Chave: MIN-XXXXX-XXXXX-XXXXX

--------------------------------------------------------------------
  Pronto - eram so essas oito. Vou gravar e ativar a licenca.
--------------------------------------------------------------------

Ativando a licenca...
Licenca ativada para Maria Silva ate 2026-09-22.

Uma pergunta por vez, cada uma dizendo o que se espera e dando um exemplo — o que está em azul é o que você digita. O programa escreve sem acento nas próprias mensagens; nas suas respostas, escreva normalmente. Depois da ativação ele lê as minutas-modelo e destila o estilo do gabinete; quanto maior o acervo, mais demora e melhor aprende.

Ele pode parar antes da primeira pergunta. A primeira coisa que o setup faz é conferir os programas de que precisa para ler PDF e pesquisar jurisprudência. Se faltar algum, ele para ali mesmo, diz qual é e dá a linha pronta para instalar — e avisa que nada foi perdido, nenhuma pergunta foi feita ainda. Instale, feche e reabra o terminal, e rode /minutando-setup de novo. É o passo seguinte deste guia.

A data que aparece na ativação não é validade da sua licença. A licença é definitiva — comprada uma vez, sua para sempre. Aquela data é a da próxima conferência automática com o portal, que acontece sozinha e se renova sozinha. Ela existe para que uma licença revogada pare de funcionar; nunca para cobrar de novo.

Sobre a pasta das minutas-modelo

Aponte a pasta onde ficam as minutas que o gabinete já produziu. É delas que o Minutando aprende a sua forma: como o juiz abre um relatório, como fecha um dispositivo, o que ele nunca escreve. Elas não passam pelo nosso servidor — são lidas na sua máquina, e o que fica gravado é um resumo do estilo, não os documentos.

Quanto mais peças, melhor o aprendizado. Se as suas minutas estiverem todas num único arquivo do Word, tudo bem: o Minutando sabe separá-las.

Duas máquinas

A sua licença vale em duas máquinas suas — o computador do gabinete e o de casa, por exemplo. Se precisar trocar, você mesmo libera uma delas na sua área, sem pedir nada a ninguém.

Se ele pedir alguma dependência

Para ler PDF e .doc antigos, o Minutando pode precisar de um ou dois programas. Ele confere sozinho e diz o que falta. Se quiser resolver antes, rode:

Claude Code

> Confira as dependências do Minutando

======================================================================
  MINUTANDO — REQUISITOS DO SISTEMA
  Windows   ·   Python 3.12.4
======================================================================

  OBRIGATÓRIOS — sem eles a skill dá erro e o trabalho perde confiabilidade
  ------------------------------------------------------------------
  ✓ INSTALADO   python       interpretador (versão 3.12.4)
  ✗ FALTANDO    playwright   descobrir jurisprudência por termo
  ✓ INSTALADO   tesseract    OCR de PDF digitalizado
  ✓ INSTALADO   idioma_por   português do Tesseract (por.traineddata)
  ✓ INSTALADO   rasterizador converter PDF em imagem para o OCR

  RECOMENDADOS — cada um habilita ler um formato de minuta-modelo
  ------------------------------------------------------------------
  ✓ INSTALADO   libreoffice  converter .doc antigo (Word 97-2003) e .odt
  ✓ INSTALADO   pdftotext    extrair texto de PDF
  ✓ INSTALADO   pypdf        ler PDF sem instalar programa

Formato real da resposta — foi capturada nesta instalação e o sistema operacional e as versões foram trocados pelos de um Windows típico. O que estiver marcado FALTANDO na sua tela vem com a linha de comando pronta para instalar, logo abaixo da lista.

A primeira minuta

Acabou a instalação. A partir daqui você conversa em português: aponte o processo e diga o que precisa.

Claude Code

> Os autos estão em C:\Processos\5502134-96. Preciso da sentença.

HERMES-GAB — minuta de sentença.
  Lendo os autos… 214 movimentos, 1.883 páginas.
  Matéria: cobrança · rito comum · revelia arguida
  Pendências: preliminar de ilegitimidade não apreciada

  Verificando as citações na fonte oficial…
  ✔ 4 de 5 confirmadas. 1 removida (não confirmada).

  Minuta pronta: sentenca-5502134-96.docx
  Ao lado dela, o memo do que foi verificado e do que não foi.

Exemplo do formato da resposta, para você reconhecer o que vai ver. O texto de cada etapa muda conforme o processo — o que não muda é a ordem: ele lê os autos, diz a matéria que encontrou, confere as citações na fonte oficial, e só então entrega o arquivo com o memo do que verificou.

A minuta sai sem assinatura e sem protocolo, e é isso que se quer: a decisão é do magistrado e a revisão é sua. O Minutando produz o rascunho e mostra o que verificou — inclusive o que ele não conseguiu confirmar, que costuma ser a parte mais útil.

Manter atualizado

Correções e melhorias saem sem aviso. Para trazer a versão mais nova, saia do Claude Code e rode no PowerShell (ou no Terminal, no Mac):

Windows PowerShell

PS C:\Users\voce> claude plugin update minutando@minutando

  Checking for updates for plugin "minutando@minutando" at user scope…
  ✔ Plugin "minutando" updated from 0.2.0 to 0.3.0 for scope user.
    Restart to apply changes.

Saída real, capturada numa atualização de verdade. Depois disso, abra o Claude Code de novo.

Este é comando de terminal, não do Claude Code. Digitado como /plugin update lá dentro, ele apenas abre o gerenciador de plugins e não atualiza nada — a tela muda e parece que não aconteceu, porque não aconteceu mesmo. E o @minutando no fim é obrigatório: sem ele a resposta é plugin not found.

A atualização não toca no seu setup, no manual de estilo do gabinete nem nas suas máquinas registradas. Se preferir pela tela, dentro do Claude Code o comando /plugin abre o gerenciador: a aba Installed lista o Minutando e permite atualizar por ali.

Quando alguma coisa dá errado

O que você vê	O que fazer
`claude` não é reconhecido como comando	Feche a janela do PowerShell ou do Terminal e abra de novo. Ele só é encontrado na segunda abertura.
`/plugin update` abre uma tela de busca e não atualiza	Esse é comando de terminal, não do Claude Code. Saia dele e rode `claude plugin update minutando@minutando` no PowerShell.
O catálogo não foi registrado	O endereço tem de vir inteiro, com a sua chave no meio. Copie a linha do e-mail em vez de digitar.
“Licença não encontrada” no setup	Confira se a chave começa com `MIN-` e se não veio com espaço no fim ao colar.
“Limite de máquinas atingido”	São duas máquinas. Libere uma na sua área e ative esta.
Perdi a chave	Escreva para contato@minutando.com.br com o e-mail da compra. Emitimos outra; a licença continua a mesma, as máquinas seguem valendo e o prazo de manutenção não reinicia.
Ele não leu um PDF	PDF digitalizado é imagem, não texto. Rode a conferência de dependências do passo 6.

Travou em algum ponto? Escreva para contato@minutando.com.br dizendo em que passo parou e o que apareceu na tela. Com essas duas informações o atendimento costuma resolver na primeira resposta.