Começar

Instalar

Um comando no terminal baixa, confere e instala o app. Não precisa de repositório, de git nem de Node.

Antes de instalar

Sistema	Requisito
macOS	Apple Silicon. O instalador recusa outras arquiteturas.
Windows	Windows 10 na versão 1903 ou mais nova, ou Windows 11.
Os dois	Um agente de terminal instalado e logado, e uma conta Deck.

A conta é criada no primeiro uso, com e-mail e senha ou com a sua conta Google. O que ela guarda está em Conta e privacidade.

macOS

curl -fsSL https://storage.googleapis.com/deck-releases-maze/deck/install.sh | bash

O comando baixa o pacote da versão atual, confere a soma SHA-256 contra o manifesto publicado e só então instala. O app vai para /Applications/Deck.app, ou para a sua pasta pessoal de aplicativos quando a conta não tem permissão de administrador.

tmux, para as sessões não morrerem

Sem tmux o Deck funciona, mas as sessões terminam junto com o app. Com tmux instalado, elas viram sessões de verdade em um servidor próprio do Deck: fechar a janela, atualizar a versão ou o app travar não derruba o que está rodando, e tudo volta no lugar no próximo boot.

brew install tmux

O Deck usa um socket e uma configuração próprios, separados de qualquer tmux que você já use. Ele não lê o seu .tmux.conf.

Windows

No PowerShell:

iwr https://storage.googleapis.com/deck-releases-maze/deck/install.ps1 -UseBasicParsing | iex

A instalação vai para %LOCALAPPDATA%\Deck e cria o atalho Deck no menu Iniciar. A mesma conferência de integridade do macOS acontece aqui.

No Windows não existe tmux, e quem segura as sessões é um serviço próprio do Deck, que sobe junto com o app. Com ele de pé, as sessões sobrevivem a fechar e a atualizar o Deck, como no macOS. Quando ele não consegue subir, o app avisa e as sessões passam a viver só enquanto a janela estiver aberta.

A tela de diagnóstico, em Configurações, diz em qual dos dois modos você está. Em máquina com antivírus, o serviço pode demorar alguns segundos no primeiro boot.

Instalar um agente

O Deck não traz agente embutido: ele encontra no seu sistema os que já estão instalados e usa o login que cada um já tem. Se a lista de agentes aparecer vazia ao criar uma sessão, é porque nenhum foi encontrado no caminho de busca do seu shell.

Instale o agente pelo método oficial dele e faça login uma vez, pelo terminal.
Confirme que ele responde no terminal, por exemplo com o comando de versão.
Reabra o Deck. O app relê o caminho de busca ao iniciar.

Os detalhes de cada agente, incluindo o que muda entre eles, estão em Agentes.

Atualizar

Quando sai uma versão, aparece um aviso dentro do app. Um clique baixa, confere a integridade e reinicia. No macOS as sessões em tmux continuam de pé durante a troca. O mesmo comando de atualizar também está na palheta de comandos, o que ajuda quando o aviso não responde ao clique.

Resgate no Windows

Se o app estiver em uma versão com o atualizador quebrado, este comando troca pela versão atual sem derrubar as sessões:

iwr https://storage.googleapis.com/deck-releases-maze/deck/update.ps1 -UseBasicParsing | iex

Desinstalar

Em Configurações, use a opção de remover o que o Deck acrescentou ao arquivo de configuração do Claude Code.
Feche o app. No macOS, encerre também as sessões que estiverem no tmux do Deck.
Apague o aplicativo: /Applications/Deck.app no macOS, ou a pasta em %LOCALAPPDATA%\Deck no Windows.
Se quiser zerar tudo, apague também a pasta de dados do app, listada em Onde ficam os arquivos.

Apagar o app não apaga os seus projetos nem as worktrees que ficaram em disco. Elas são pastas git normais.