Documentação

Instalar e primeiro uso

Em uns 10 minutos você instala o TowerCTL, deixa o Claude Code pronto e abre o primeiro projeto.

Do que você precisa#

O Claude Code e o git você não precisa instalar antes: se faltarem, o próprio app oferece a instalação. Ao abrir uma IA, o TowerCTL procura o programa dela (claude, codex, gemini…) no mesmo caminho do seu terminal. Se você instalou o CLI num lugar fora do comum, veja O app não encontra o claude.

Baixar e instalar#

Baixe o instalador do seu sistema pelo botão Baixar do site. O site já escolhe o arquivo certo para o seu computador e lista os outros logo abaixo do botão.

Os instaladores ainda não têm certificado de assinatura (da Microsoft ou da Apple), e por isso o sistema mostra um aviso na primeira abertura. É esperado, e o passo para passar está em cada sistema abaixo.

Windows#

  1. Baixe o TowerCTL-Setup.exe.
  2. Abra o instalador. Ele instala só para o seu usuário, sem pedir senha de administrador, e cria o atalho TowerCTL na área de trabalho.
  3. Se aparecer a tela azul “O Windows protegeu o computador” (o SmartScreen), clique em Mais informações e depois em Executar assim mesmo.
  4. Abra o app uma vez só. Se o instalador já abriu o TowerCTL no final, use essa janela. Se você tentar abrir de novo, o app só traz para a frente a janela que já está aberta.

macOS#

  1. Baixe o TowerCTL-mac-arm64.dmg (Apple Silicon) ou o TowerCTL-mac-x64.dmg (Intel). Para saber qual é o seu, abra o menu da maçã, Sobre Este Mac: se aparecer “Chip Apple M…”, é Apple Silicon.
  2. Abra o .dmg e arraste o TowerCTL para a pasta Aplicativos.
  3. Na primeira vez, o Mac avisa que não consegue verificar o app. Abra a pasta Aplicativos, clique com o botão direito (ou Control e clique) no TowerCTL e escolha Abrir. Na janela que aparece, clique em Abrir de novo.
  4. Se o aviso só oferecer OK ou Mover para o Lixo, tente abrir o app uma vez, vá em Ajustes do Sistema › Privacidade e Segurança, role até a mensagem sobre o TowerCTL e clique em Abrir mesmo assim. Digite a sua senha do Mac se ela pedir.

Isso só acontece na primeira vez. Depois o TowerCTL abre normalmente, pelo Launchpad ou pelo Spotlight.

Linux#

Há duas opções. Escolha uma.

AppImage
Baixe o TowerCTL-linux-x86_64.AppImage, dê permissão de execução e abra: chmod +x TowerCTL-linux-x86_64.AppImage e depois ./TowerCTL-linux-x86_64.AppImage (ou dê dois cliques, se o seu gerenciador de arquivos permitir). Não precisa instalar nem de senha de administrador.
Pacote .deb
Baixe o arquivo towerctl_…_amd64.deb e instale com sudo apt install ./towerctl_…_amd64.deb (troque pelo nome do arquivo que você baixou). O TowerCTL aparece no menu de aplicativos.

Por não ter certificado de assinatura, o Linux não mostra aviso nenhum.

A primeira abertura#

Se faltar alguma ferramenta, o app abre a tela Bem-vindo ao TowerCTL com duas linhas:

Claude Code
Obrigatório. É o agente que trabalha em cada painel e usa a sua assinatura do Claude.
Git (recomendado)
Permite que os ajudantes trabalhem isolados, que você revise as mudanças e volte no tempo.
  1. Clique em Instalar ao lado do que faltar. Abre uma janela de terminal com o instalador oficial: no Windows, o PowerShell com o instalador da Anthropic para o Claude Code e o winget para o git; no Mac, o Terminal; no Linux, o terminal do seu sistema. No Mac, o git vem pelas ferramentas de linha de comando da Apple (xcode-select --install), e no Linux pelo gerenciador do seu sistema (como o apt), que pode pedir a sua senha.
  2. Quando a janela disser que terminou, volte ao TowerCTL e clique em Verificar de novo.
  3. Com tudo marcado, clique em Continuar.

Dá para seguir sem o git (os painéis funcionam, mas sem cópias isoladas nem revisão). Sem o Claude Code, o botão vira Continuar mesmo assim, mas você não consegue abrir agentes do Claude.

Abrir o primeiro projeto#

  1. Clique em + Projeto, no lado esquerdo, e escolha a pasta do projeto. Pode ser uma pasta vazia.
  2. Clique em Nova conversa. Abre um painel com o Claude Code nessa pasta.
  3. Escreva o que você quer no painel e aperte Enter.

Para entender a tela, veja Projetos, missões e painéis.

Entrar na sua conta do Claude#

No primeiro painel, o Claude Code pede para você entrar na sua conta e abre o navegador. Entre com a conta que tem a assinatura Pro ou Max. Esse login é do próprio Claude Code, então vale para os próximos painéis também.

Confiar na pasta#

Quando o Claude Code abre uma pasta pela primeira vez, ele pergunta se você confia nela (“Do you trust this folder?”). Enquanto isso, o painel mostra precisa de você.

  1. Clique dentro do painel.
  2. Use as setas para escolher Yes, I trust this folder e aperte Enter.

Nas cópias isoladas que o app cria para os ajudantes, ele mesmo responde que sim. Em qualquer outra pasta, a pergunta continua sendo sua.

O teste grátis de 14 dias#

O teste começa na primeira vez que você abre o app e não pede cartão. Os dias que faltam aparecem no canto inferior esquerdo, em Teste: N dias, que fica em destaque nos últimos 3 dias. O que acontece depois está em Assinatura e licença.

Atualizações#

Depende do sistema:

Windows e Linux (AppImage)
O app baixa as versões novas sozinho, em segundo plano. Quando uma está pronta, aparece no canto inferior esquerdo o botão Versão X pronta · Reiniciar. Clique quando for uma boa hora, ou deixe para depois: a atualização também é instalada quando você fecha o app.
Mac
O app só avisa que há versão nova, no mesmo canto, e abre a página de download. Não instala sozinho: baixe o novo .dmg e arraste o TowerCTL para Aplicativos, trocando o antigo. Isso vem do app não ter a assinatura da Apple.
Linux (.deb)
O app só avisa que há versão nova. Baixe o novo .deb e instale de novo com sudo apt install ./arquivo.deb.