Documentação

Documentação › Windows e Linux: o que muda

Windows e Linux: o que muda

Desde a 1.0.24, o Octopus roda no Windows e no Linux com as mesmas funções do Mac e a mesma licença. Esta página mostra o que muda: a instalação, as teclas (Ctrl no lugar de ⌘ e a tecla Líder), a paleta de ações, a bandeja e o que só existe num lado ou no outro.

Requisitos

WindowsLinuxdesde a 1.0.24

O Octopus roda no Windows 10 e 11 (x64) e no Linux (Ubuntu 22.04 ou mais novo e Debian 12, x64 e arm64). No Mac, pede o macOS 26 (Tahoe) ou mais novo, com Apple Silicon ou Intel.

Passo a passo

  1. Windows: Windows 10 ou 11, x64.
  2. Linux: Ubuntu 22.04 ou mais novo, ou Debian 12, em x64 ou arm64. Para outras distribuições, use o AppImage.
  3. Os agentes são os seus: o Claude Code e o Codex, com a sua conta ou a sua chave de API.
  4. A mesma licença vale nos três sistemas, em até 2 computadores.

Veja tambémTrês sistemas, dois computadoresInstalar no WindowsInstalar no Linux

Instalar no Windows

Windowsdesde a 1.0.24

O instalador do Windows instala o Octopus só para o seu usuário, sem pedir administrador. Como o instalador não tem certificado de assinatura do Windows, o SmartScreen pode mostrar um aviso na primeira vez.

Passo a passo

  1. Baixe o Octopus para Windows no site.
  2. Abra o instalador.
  3. Se aparecer “O Windows protegeu o computador”, clique em “Mais informações” e depois em “Executar assim mesmo”.
  4. O Octopus abre a configuração do primeiro uso. Para abrir de novo depois, use “Configurar este computador…” na paleta de ações (Ctrl+Shift+P).

As atualizações seguintes vêm sozinhas e são assinadas pelo Octopus.

Veja tambémAtualizaçõesConfiguração inicial

Instalar no Linux

Linuxdesde a 1.0.24

No Linux há dois pacotes: o .deb, para Ubuntu e Debian, e o AppImage, para outras distribuições. Os dois existem para x64 e arm64.

Passo a passo

  1. Baixe no site o pacote da sua arquitetura (x64 ou arm64).
  2. Com o .deb: abra o arquivo na central de programas, ou, no terminal, na pasta do download, rode sudo apt install ./ seguido do nome do arquivo .deb. O pacote já traz o tmux, que guarda as sessões deste computador.
  3. Com o AppImage: no gerenciador de arquivos, botão direito › Propriedades › Permissões e ligue a opção de executar como programa (ou, no terminal, chmod +x e o nome do arquivo). Depois abra com dois cliques.
  4. O Octopus abre a configuração do primeiro uso. Para abrir de novo, use “Configurar este computador…” na paleta de ações (Ctrl+Shift+P).

As atualizações chegam sozinhas: no .deb, instalar pede a senha de administrador; no AppImage, o próprio arquivo é trocado.

Veja tambémAtualizações

Ctrl no lugar de ⌘

WindowsLinuxdesde a 1.0.24

No Windows e no Linux, o ⌘ do Mac vira Ctrl. Como Ctrl com uma letra é do terminal, os atalhos do app usam Ctrl+Shift; os que ainda colidem vão para a tecla Líder. O Octopus nunca usa Ctrl+Alt (é o AltGr de muitos teclados) nem a tecla Windows.

Passo a passo

  1. Os atalhos do app são, em geral, Ctrl+Shift e a mesma letra do Mac: Novo terminal ⌘TCtrl+Shift+T, barra lateral ⌘SCtrl+Shift+S, histórico ⌘YCtrl+Shift+Y.
  2. No terminal, copiar, colar e escolher tudo são ⌘CCtrl+Shift+C, ⌘VCtrl+Shift+V e ⌘ACtrl+Shift+A. Ctrl+Insert e Shift+Insert também funcionam. No Windows, Ctrl+V cola; no Linux, Ctrl+V fica com o programa do terminal (o vim, o shell, a colagem de imagem do Claude Code).
  3. Os grupos 1 a 9 são ⌃⌘1–9Alt+1–9; os terminais 1 a 9, ⌘1–9Ctrl+1–9.
  4. Workspace seguinte e anterior: ⌘↓Ctrl+Shift+PgDn e ⌘↑Ctrl+Shift+PgUp (também Ctrl+Shift+] e Ctrl+Shift+[). Para ir ao workspace N, toque Ctrl duas vezes e o número.
  5. Sair do Octopus é ⌘QCtrl+Shift+Q. Tela cheia é F11 (no Mac, o botão verde da janela).
  6. As teclas valem pela posição no teclado, não pela letra impressa nele: os atalhos funcionam igual em qualquer layout.
Novo terminal⌘TCtrl+Shift+T
Abrir em um servidor⌘KCtrl+Shift+K
Excluir elemento / Fechar aba⌘WCtrl+Shift+W
Mostrar ou esconder a barra lateral⌘SCtrl+Shift+S
Ajustes⌘,Ctrl+,
Copiar / Colar / Escolher tudo⌘C / ⌘V / ⌘ACtrl+Shift+C / V / A
Desfazer / Refazer⌘Z / ⇧⌘ZCtrl+Z / Ctrl+Shift+Z ou Ctrl+Y
Modo foco⇧⌘↩Ctrl+Shift+↩
Chat ⇄ terminal⌘JCtrl+Shift+J
Buscar no terminal⌘FCtrl+Shift+F
Grupo 1–9⌃⌘1–9Alt+1–9
Workspace N⌘ duas vezes + 1–9Ctrl duas vezes + 1–9
Sair⌘QCtrl+Shift+Q
Tela cheia—F11
Buscar uma ação—Ctrl+Shift+P

A tabela completa, lado a lado, está na página de atalhos.

Veja tambémGeralA tecla Líder

A tecla Líder

WindowsLinuxdesde a 1.0.24

A Líder é Ctrl+Shift+Espaço. Você aperta e solta, e em seguida aperta uma tecla só. Ela guarda os atalhos que, como Ctrl+Shift+letra, colidiriam com outro atalho do app, com o terminal ou com o sistema.

A dica que aparece depois de Ctrl+Shift+Espaço
A dica que aparece depois de Ctrl+Shift+Espaço

Passo a passo

  1. Aperte Ctrl+Shift+Espaço e solte. Uma dica aparece na tela por um segundo e meio.
  2. Aperte a tecla da ação, por exemplo D para uma nota nova ou ↩ para o modo padrão.
  3. Para desistir, aperte Esc ou espere a dica sumir.
Nova nota⇧⌘DLíder D
Modo padrão⌃⌘↩Líder ↩
Próximo que precisa de você⇧⌘JLíder J
Tamanho real⌥⌘0Líder 0
Workspace 1–9⌘ duas vezes + 1–9Líder 1–9
Shell ao lado⌥⌘TLíder S
Desagrupar⇧⌘GLíder G
Juntar em pasta / Espalhar⌥⌘GLíder P
Grupos salvos⇧⌘YLíder Y
Contas na nuvem⇧⌘ULíder U
Organizar⇧⌘TLíder T
Organizar para leitura⌥⇧⌘TLíder R
Focar no elemento⌘\Líder E
Zoom para a seleção⌥⌘\Líder Z
Limpar o terminal⇧⌘KLíder K
Fonte maior / menor⇧⌘+ / ⇧⌘-Líder = / Líder -
Ir para o cartão vizinho⌃⌘ + setasLíder + setas
Seguir / voltar pela conexão⌥⌘→ / ⌥⌘←Líder . / Líder ,

A dica mostra o J só quando há alguém precisando de você.

Veja tambémO modo de navegaçãoA tecla Líder (Windows e Linux)

O modo de navegação

WindowsLinuxdesde a 1.0.24

Líder com uma seta leva ao cartão vizinho naquela direção e deixa você no modo de navegação: as setas sozinhas continuam andando de cartão em cartão, até Esc ou ↩.

Andar entre cartões só com as setas

Passo a passo

  1. Aperte Ctrl+Shift+Espaço e uma seta. O cartão mais perto naquela direção fica escolhido e com o teclado.
  2. Continue só com as setas: cada uma leva ao próximo cartão. A vista desliza no mesmo zoom.
  3. No modo, . e , seguem e voltam pela conexão do cartão (como Líder . e Líder ,).
  4. Aperte ↩ para ficar no cartão e digitar nele, ou Esc para sair do modo.
Ir para o cartão vizinho⌃⌘ + setasLíder + setas
Seguir / voltar pela conexão⌥⌘→ / ⌥⌘←Líder . / Líder ,

Nas Abas, Líder com uma seta vai à parte vizinha de uma divisão, sem entrar no modo: as setas seguintes voltam para o terminal.

Veja tambémNavegar pelo tecladoDividir abas

A paleta de ações

WindowsLinuxdesde a 1.0.24

O Windows e o Linux não têm a barra de menus do Mac. No lugar dela, a paleta Ctrl+Shift+P busca qualquer ação pelo nome e mostra a tecla de cada uma.

A paleta de ações com as teclas de cada ação
A paleta de ações com as teclas de cada ação

Passo a passo

  1. Aperte Ctrl+Shift+P. O campo diz “Buscar uma ação”.
  2. Digite parte do nome, como “nota”, “organizar” ou “atualizações”. A busca é no idioma da tela.
  3. Use ↑ e ↓ para escolher e ↩ para rodar. Esc fecha.
  4. Além das ações com tecla, a paleta tem “Ir ao workspace X”, “Grupo: X”, “Alinhar › …”, “Aparência: Claro / Escuro”, “Desfazer” e “Refazer” do canvas, “Novo servidor…”, “Nova conta”, “Salvar grupo…”, “Configurar este computador…” e “Procurar Atualizações…”.
Buscar uma ação—Ctrl+Shift+P

A paleta é o melhor jeito de aprender as teclas: cada ação mostra a sua à direita.

Veja tambémA tecla LíderSó no Windows e no Linux

A bandeja e a janela

WindowsLinuxdesde a 1.0.26

Fechar a janela esconde o Octopus na bandeja do sistema, e ele continua rodando. A janela tem os três botões redondos do Mac no alto da barra lateral.

O menu do Octopus na bandeja do sistema

Passo a passo

  1. Feche a janela: o Octopus vai para a bandeja, com os alertas, a vigia dos agentes e o Manter acordado ainda rodando.
  2. Clique com o botão direito no ícone da bandeja (no Windows, o clique simples abre a janela) para “Abrir o Octopus”, trocar o Manter acordado ou “Sair do Octopus”.
  3. Num Linux sem bandeja (o GNOME sem a extensão AppIndicator), o Octopus avisa ao fechar a janela: abra de novo pelo menu de aplicativos.
  4. Para mover a janela, arraste pelo topo da barra lateral ou pela faixa vazia do alto do canvas. Dois cliques nessa faixa maximizam.
  5. F11 põe a janela em tela cheia. No Mac, a tela cheia é o botão verde da janela.
Tela cheia—F11

Com a janela fechada, os portais não funcionam: abra a janela para um agente usar um portal.

Veja tambémContinuar rodando ao fechar a janelaO Manter acordado na bandeja

Modo leve

WindowsLinuxdesde a 1.0.24

O Modo leve tira o desfoque atrás do modo foco e as animações dos cartões e da vista. Serve para computadores mais fracos e para área de trabalho remota.

Passo a passo

  1. Abra os Ajustes (Ctrl+,) › Geral.
  2. Em Desempenho, ligue “Modo leve”.
Ajustes⌘,Ctrl+,

Veja tambémGeral

Selos no ícone e notificações

WindowsLinuxdesde a 1.0.24

Quantos agentes precisam de você aparece no ícone do Octopus: na barra de tarefas do Windows e no lançador do Linux. Os avisos chegam como notificações do sistema.

Passo a passo

  1. Deixe ligado Ajustes › Alertas › o número no ícone.
  2. Quando um agente pede você ou termina, o número aparece no ícone e a notificação do sistema avisa.
  3. Clique na notificação para abrir o cartão.

Veja tambémOnde o alerta aparece

Sessões que não caem

WindowsLinuxdesde a 1.0.24

No Windows, os terminais deste computador ficam num serviço do Octopus; no Linux, no tmux, como no Mac. Fechar o app ou atualizar não mata nenhum terminal. Nos servidores, as sessões ficam no tmux, como sempre.

Passo a passo

  1. Abra terminais e agentes neste computador normalmente.
  2. Feche o Octopus ou reinicie para atualizar: os terminais continuam rodando e voltam quando o app abre.
  3. No Windows, o Shell abre o PowerShell 7 se ele estiver instalado; senão, o Windows PowerShell.
  4. No Linux, o tmux vem com o .deb. Se faltar, o Octopus oferece “Instalar tmux”.

Veja tambémSessões que não caem

O que é só do Mac, e o que é só daqui

MacWindowsLinuxdesde a 1.0.24

Quase tudo é igual nos três sistemas. A lista abaixo mostra o pouco que muda, para você não procurar o que não existe no seu.

Passo a passo

  1. Só no Mac: a barra de menus (com “Configurar este Mac…”, “Procurar Atualizações…” e os menus Editar e Janela) e a janela “Sobre o Octopus”.
  2. Só no Mac: o número no Dock, o Octopus se mover sozinho para Aplicativos no primeiro uso e a tampa fechada com a senha de administrador, com “Devolver o sono”.
  3. Só no Mac: o Quick Look do sistema e “Mostrar no Finder” (no Windows e no Linux, o Octopus tem a própria prévia e “Mostrar na pasta”), e arrastar um arquivo de servidor da árvore para o Finder para baixar.
  4. Só no Mac: o texto nítido em qualquer zoom em monitores que não são Retina, e o ⌥ com a roda que dá zoom no canvas mesmo sobre um Draw escolhido.
  5. Só no Windows e no Linux: a paleta de ações (Ctrl+Shift+P), a tecla Líder e o modo de navegação, a bandeja, o Modo leve, o F11, os menus de texto e de página feitos pelo Octopus, o botão direito no vazio do canvas, o “Testar neste Linux” da tampa fechada e o aviso de atualização com “Depois” e “Reiniciar”.
  6. Os nomes também mudam um pouco: “Este Mac” vira “Este computador”, e “Igual ao Mac” vira “Igual ao sistema” (no globo da barra lateral do Windows, “Igual ao Windows”).

Veja tambémCom a tampa fechadaAtualizaçõesQuick Look