Claude Cowork no Linux funciona? Como descobrir se a sua distro roda antes de instalar

Nada pior que queimar a tarde inteira atrás de um pacote de origem duvidosa pra descobrir, no fim, que o problema nunca foi o pacote: era a virtualização desligada no firmware da sua máquina

Fala aí, beleza? O app Claude Desktop pra Linux entrou em beta em julho de 2026 e entrega no Linux a mesma experiência de Chat, Cowork e Claude Code que já existia no macOS e no Windows: sessões paralelas, revisão visual de diff, terminal e editor integrados e preview do app ao vivo

Só que o Cowork no Linux é a parte mais exigente do pacote

Ele depende de distro suportada, de arquitetura suportada e de virtualização por hardware funcionando. Dá pra checar tudo isso em uns poucos minutos, antes de baixar qualquer coisa, e é exatamente isso que a gente vai fazer aqui 🙂

O que a sua máquina precisa ter antes de tentar instalar

Antes do como, o porquê: o Cowork roda carga de trabalho isolada na sua máquina, e isso puxa recurso de virtualização do kernel. Se um item desta lista falta, não é bug, é requisito

• Distro baseada em Debian oficialmente suportada: Ubuntu 22.04 ou posterior e Debian 12 (bookworm) ou posterior. É o que a documentação lista como suportado hoje
• Arquitetura x86_64 ou arm64: as duas estão contempladas, então máquina ARM também entra na conversa
• Aviso importante sobre "primas" do Debian: outras distros baseadas em Debian que atendam aos requisitos podem funcionar, porém não são testadas oficialmente. Traduzindo: pode rodar, mas se quebrar você está fora do caminho testado
• Virtualização por hardware (KVM) habilitada: a aba Cowork no Linux exige virtualização por hardware ligada nas configurações de firmware da máquina. Esse é o item que mais pega gente desprevenida
• Módulo de kernel vhost_vsock: o Cowork precisa desse módulo carregado. Sem ele, a aba reclama
• Pacotes de QEMU e firmware UEFI: qemu-system-x86, ovmf e virtiofsd em x86_64, ou qemu-system-arm, qemu-efi-aarch64 e virtiofsd em arm64. Boa notícia: o apt install claude-desktop já instala esses por padrão, como pacotes recomendados
• Conta em plano pago: o Cowork está disponível nos planos Pro, Max, Team e Enterprise. A porta de entrada paga é o Pro, a US$ 20 por mês no mensal ou US$ 17 por mês no anual (US$ 200 cobrados de uma vez), e ele inclui Claude Code, Claude Cowork e Claude Design

Detalhe que muda a vida de quem usa em empresa: no Team o Cowork vem ligado por padrão, e no Enterprise vem desligado por padrão, dependendo de um admin habilitar

Então se você está no Enterprise e a aba simplesmente não aparece, pode não ser a sua máquina, pode ser política de conta

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Como descobrir se a sua distro roda o Cowork, passo a passo

A ordem aqui é de propósito: primeiro o que é de graça e rápido de checar, depois a instalação. Assim você descobre o "não dá" antes de instalar qualquer pacote

1. Confira distro e arquitetura contra a lista oficial

A referência viva é a documentação do Claude Desktop no Linux. Se você está em Ubuntu 22.04+ ou Debian 12+, em x86_64 ou arm64, você está no caminho suportado

O erro comum deste passo: assumir que "é Linux, então roda". Fedora e Arch não são baseadas em Debian, e a orientação oficial pra elas é outra (volto nisso mais pra frente)

2. Confirme a virtualização por hardware nas configurações de firmware

Esse item não se resolve por comando, se resolve no firmware da máquina: a virtualização por hardware precisa estar habilitada ali

O erro comum deste passo: instalar tudo, abrir o app, ver a aba Cowork reclamando e culpar o pacote. Se a virtualização está desligada no firmware, nenhum comando de terminal salva

3. Carregue o módulo vhost_vsock

sudo modprobe vhost_vsock

E pra ele subir a cada boot, em vez de você lembrar disso toda segunda-feira:

echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf

O erro comum deste passo: carregar o módulo com o app já aberto e esperar mágica. O app verifica os requisitos uma única vez no lançamento, então depois do modprobe você reinicia o app

4. Instale pela via oficial, começando pela chave de assinatura

sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc

Agora o repositório e a instalação:

echo "deb [signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop

Existe também a outra via oficial: baixar o arquivo .deb na página de download da Anthropic. Funciona, mas o repositório apt é mais prático por um motivo bem concreto: instalando por ele, as atualizações chegam junto com as atualizações normais do sistema, em vez de vir por dentro do app

O erro comum deste passo: sair caçando pacote em fórum, PPA aleatório ou AUR de terceiro antes de tentar o repositório oficial. É assim que a tarde vira madrugada 😛

5. Confira o fingerprint da chave

Esse passo é o que separa "instalei da Anthropic" de "instalei de alguém". O fingerprint da chave de assinatura oficial é:

31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE

Se o que aparecer for diferente disso, pare tudo

O erro comum deste passo: pular ele por pressa. Você está adicionando um repositório ao seu sistema, vale os dez segundos de conferência

6. Abra o app e olhe a aba Cowork

É o teste final. A aba abrindo e funcionando significa que distro, arquitetura, virtualização e módulo estão todos de pé

O erro comum deste passo: mexer em requisito (módulo, grupo, pacote) com o app já aberto e esperar que ele perceba sozinho. De novo: a verificação acontece uma vez no lançamento, reinicie o app depois de qualquer mudança

E se isso aqui é pra equipe, e não só pra sua máquina, faz sentido validar a coisa com um piloto com um time pequeno antes de mandar a receita de instalação pro pessoal todo

A aba Cowork reclamou de virtualização: o que cada erro quer dizer

Três cenários cobrem quase tudo que aparece aqui. Cada um tem causa e correção oficial

Sintoma: erro de permissão em /dev/kvm

A causa é acesso: o seu usuário não está no grupo que pode abrir os dispositivos de virtualização. A correção oficial é entrar no grupo kvm

sudo usermod -aG kvm $USER

Depois disso, saia e entre de novo na sessão, senão o grupo novo não vale pro seu ambiente ainda

E aqui vai a parte que confunde: alguns ambientes desktop já liberam /dev/kvm pro usuário logado sem precisar do grupo. Aí a pessoa pensa "então tá tudo certo"… e não está. O Cowork também precisa de /dev/vhost-vsock, e esse só membros do grupo kvm conseguem abrir

Sintoma: reclamação do módulo vhost_vsock

A causa é simples: o módulo não está carregado no kernel em execução. Carregue e reinicie o app

sudo modprobe vhost_vsock

Pra não repetir isso depois de cada boot:

echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf

Sintoma: o app avisa que o kernel não tem o suporte necessário

Esse é o caso sem saída, e é honesto reconhecer: se /dev/vhost-vsock não existe e o kernel em execução não tem diretório de módulos em /lib/modules, a aba Cowork informa que o kernel não inclui o suporte de virtualização necessário e que ele não pode ser adicionado manualmente

Essa combinação é comum em ChromeOS e em ambientes Linux baseados em container

Ou seja: não é falta de comando, é falta de kernel com o suporte. Nesse cenário o caminho é outro, e é o da próxima seção

Como prevenir os três: rodar as checagens do bloco anterior antes de instalar, e lembrar das duas coisas que todo mundo esquece, reiniciar o app depois de instalar pacotes e fazer relogin depois de entrar no grupo kvm

Sem versão nativa para a sua distro: quais são as saídas oficiais

São duas saídas oficiais, e elas não competem, elas se somam

A primeira é a orientação da documentação do app desktop: se você está em distro que não é baseada em Debian, como Fedora ou Arch, use a CLI em vez do app desktop. A documentação diz que hoje só distribuições baseadas em Debian são suportadas, e que suporte a outras distribuições vem no futuro (sem prazo anunciado)

A segunda é o próprio Cowork rodando em sessões na nuvem (em beta), salvas na sua conta Claude e acessíveis em desktop, web e mobile. Na web o acesso é pelo claude.ai, e é isso que atende quem está numa distro não suportada e precisa do Cowork em si

Então a regra prática fica assim: CLI pro trabalho de terminal na sua máquina, e claude.ai quando o que você quer é a aba Cowork

Compare:

Sobre o computer use, que é o recurso que deixa o Claude abrir apps e controlar a tela: ele é research preview em macOS e Windows e exige plano Pro ou Max, e a documentação registra que na CLI ele não está disponível em Linux nem em Windows

Já o navegador embutido do Cowork está em rollout pro Claude Desktop em macOS, Windows e Linux (beta), nos planos Pro, Max e Team, e em Enterprise onde um owner habilitou

Pra quem está em distro fora da lista e precisa do Cowork hoje, a saída mais rápida é a web pelo claude.ai, aceitando que ali ele não enxerga a sua máquina

Vale instalar pacote não oficial para forçar o Cowork no Linux?

Essa pergunta aparece nas buscas porque existe atalho de comunidade. No GitHub tem o projeto claude-cowork-linux, publicado sob o usuário johnzfitch, que se descreve como forma de rodar o modo Cowork nativamente no Linux x86_64 sem VM e sem macOS

O próprio projeto se apresenta como research preview não oficial, sem vínculo com a Anthropic, e avisa que pode quebrar quando o Claude Desktop atualizar

Então o veredito é chato, mas é o honesto: pra curiosidade e laboratório, se liga que é research preview e trate como research preview

Pra trabalho de verdade, aquele em que você abre a ferramenta às 9h porque precisa entregar, a via oficial ganha fácil: repositório apt com o fingerprint conferido, ou as sessões na nuvem pelo claude.ai. O app já está em beta, somar a isso um caminho sem garantia de continuidade é empilhar instabilidade em cima de instabilidade

E tem o outro lado da moeda, que é o que você está entregando pra esse binário: antes de dar a um pacote não oficial acesso às suas pastas de projeto, vale entender o que sai da sua máquina quando uma ferramenta de IA lê o seu código

Conclusão

Resumindo a decisão em uma linha por cenário:

• Distro suportada com virtualização ligada: instale pelo repositório apt oficial, confira o fingerprint e a aba Cowork deve abrir
• Distro suportada sem virtualização: resolva no firmware primeiro, depois modprobe vhost_vsock, grupo kvm e reinício do app. Sem isso, não adianta reinstalar
• Distro fora da lista (Fedora, Arch, container, ChromeOS): CLI pelo caminho oficial, e Cowork pela web no claude.ai quando você precisar do recurso em si

O próximo passo concreto é bem simples: cheque distro, arquitetura e vhost_vsock ANTES de baixar qualquer coisa, e quando for instalar, instale só pelo repositório apt oficial, com o fingerprint conferido

E guarde uma ressalva: o Linux segue em beta em setembro de 2026, e a documentação diz que mais distribuições vêm no futuro

Ou seja, o "não dá" de hoje pode virar "dá" amanhã… vale revisitar a página oficial de vez em quando

até o próximo post! 😀