Claude no Linux: app desktop e CLI

Quais partes do Claude funcionam nativamente no Linux atualmente

O Claude no Linux funciona em quatro superfícies distintas e, em agosto de 2026, todas funcionam numa máquina Ubuntu ou Debian comum. A aplicação para desktop é instalada a partir do repositório apt da Anthropic e está em beta. A CLI do Claude Code (interface de linha de comandos) é um binário compilado e funciona em mais distribuições do que a aplicação para desktop. A aplicação web em claude.ai precisa apenas de um navegador, e a API é um endpoint HTTPS que você chama a partir do seu próprio código.

Duas funcionalidades disponíveis no macOS e no Windows estão ausentes da versão beta para desktop do Linux: Computer Use, na qual o Claude controla aplicações no ecrã, e ditado por voz. A Anthropic documenta ambas como ainda não disponíveis no Linux. A CLI tem o seu próprio ditado por voz, portanto a limitação está na aplicação para desktop, não no Claude em si.

A disponibilidade muda, portanto leia esta página como uma descrição das superfícies e confirme o estado atual antes de basear o seu planeamento nela. A última secção lista as páginas que deve consultar.

Instalar o aplicativo de desktop do Claude no Ubuntu ou Debian

Os requisitos documentados são Ubuntu 22.04 ou posterior, ou Debian 12 ou posterior, em x86_64 (que dpkg chama amd64) ou arm64. Outras distribuições baseadas em Debian podem funcionar, mas não são testadas. O Fedora e o RHEL ainda não têm um pacote, portanto nesses sistemas use a CLI ou o navegador.

Instale a partir do repositório apt, e não de um ficheiro .deb transferido. A aplicação Linux não tem um atualizador próprio. As novas versões só chegam através do gestor de pacotes. O registo do repositório é o que permite que apt upgrade as encontre.

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

gpg --show-keys deve imprimir a impressão digital 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Compare-a antes de registar o repositório. Uma chave de assinatura que não verificou é uma chave em que está a confiar sem confirmação. Se o gpg indicar que o ficheiro não contém dados OpenPGP válidos, a transferência falhou. Nesse caso, apt update falha mais tarde com NO_PUBKEY BAA929FF1A7ECACE.

Registar o repositório consiste numa única linha deb escrita em /etc/apt/sources.list.d/claude-desktop.list. Copie essa linha da página de instalação do Linux da Anthropic, code.claude.com/docs/en/desktop-linux, exatamente como aparece nessa página. O endereço do repositório é a parte deste procedimento com maior probabilidade de mudar. Uma linha escrita de memória é o que o deixa a olhar para E: Unable to locate package claude-desktop depois. Leia a linha antes de a colar: arch=amd64,arm64 é o motivo pelo qual o apt não encontra nada noutra arquitetura, e signed-by= aponta para o ficheiro de chaveiro que acabou de verificar. Isto limita essa chave a este repositório, em vez de confiar nela para tudo o que o apt lê.

sudo apt update && sudo apt install claude-desktop

Inicie-o no lançador de aplicações ou execute claude-desktop num terminal. Inicie sessão com a sua conta claude.ai ou através do SSO da sua organização (início de sessão único), se a sua empresa o tiver configurado. A aplicação de desktop não aceita uma chave de API do Claude Console. A autenticação baseada em chave é uma funcionalidade da CLI.

E: Unable to locate package claude-desktop significa que o apt nunca leu o repositório. cat /etc/apt/sources.list.d/claude-desktop.list deve mostrar a linha deb que escreveu, e dpkg --print-architecture deve imprimir amd64 ou arm64, porque não são publicados pacotes para outras arquiteturas. As atualizações chegam depois com o resto do sistema, a partir de sudo apt update && sudo apt upgrade.

O que existe apenas num navegador

claude.ai funciona em qualquer navegador atual e em qualquer distribuição, o que o torna a solução para Fedora, RHEL, Arch, openSUSE e qualquer outro sistema sem pacote. O navegador também disponibiliza o Claude Code na Web, em que a sessão é executada na nuvem da Anthropic, e não na sua máquina, utilizando sempre as credenciais da sua subscrição.

É importante compreender a limitação do navegador. Uma sessão na nuvem não pode ler os ficheiros do seu próprio servidor nem executar comandos nele. Qualquer operação que interaja com a sua máquina requer software nessa máquina, ou seja, a CLI ou a aplicação de desktop.

O que a CLI oferece e a aplicação Web não

Inicie claude num diretório e ele funcionará nesse diretório. Essa é a diferença, e o restante decorre dela.

• Lê e edita os ficheiros do seu diretório de trabalho e mostra cada alteração antes de a aplicar.
• Executa os comandos shell que aprovar. Assim, pode compilar um projeto, executar uma suíte de testes, ler um log ou inspecionar um serviço diretamente no servidor.
• Funciona sem uma sessão interativa: claude -p "read the nginx error log and summarise it" imprime uma resposta e termina. É isso que deve usar num cron job ou num pipeline. O formato dessa resposta pode ser definido por si, porque um estilo de saída edita o prompt do sistema por trás de cada resposta e pode manter uma execução automatizada concisa, enquanto uma sessão interativa explica o que está a fazer.
• Liga servidores MCP (model context protocol) com claude mcp add. Isso fornece ao modelo ferramentas além do sistema de ficheiros.
• Funciona onde não existe qualquer ambiente gráfico, como acontece em todos os VPS (virtual private server) que alugar.

Este último ponto explica por que motivo um guia de servidores se preocupa com a CLI. Um servidor alugado tem SSH (secure shell) e pouco mais. Por isso, o terminal é a única interface que pode estar disponível consigo. A execução nesse contexto tem regras próprias. executar Claude Code num VPS dentro do tmux aborda-as em detalhe, e usar Claude no trabalho diário de administração de sistemas aborda as tarefas que vale a pena delegar-lhe.

As integrações com editores ficam entre as duas opções. A extensão do VS Code requer o VS Code 1.94.0 ou posterior e fornece um painel gráfico dentro do editor, com revisão de diferenças e do plano. Inclui uma cópia privada da CLI para esse painel e não coloca claude no seu PATH. Por isso, escrever claude no terminal integrado continua a exigir a instalação autónoma. Os editores baseados no VS Code instalam a mesma extensão a partir do registo Open VSX, e também existe um plugin para o JetBrains.

É necessário ter Node.js para executar o Claude Code no Linux?

Não com a instalação recomendada. O instalador nativo transfere um binário compilado, e esse binário não é executado pelo Node.js.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version deve apresentar um número de versão, como 2.1.211 (Claude Code). Se algo parecer incorreto, execute claude doctor. Este comando apresenta diagnósticos apenas de leitura sobre a instalação e os seus ficheiros de definições, sem iniciar uma sessão.

O Node.js só é relevante para a opção npm. A partir da versão 2.1.198 do pacote, o pacote npm requer Node.js 22 ou posterior. Numa versão mais antiga do Node.js, o npm apresenta um aviso EBADENGINE em vez de falhar. Isto acontece porque o pacote inclui o mesmo binário nativo como dependência específica da plataforma e cria uma ligação para o local correto.

npm install -g @anthropic-ai/claude-code

Não execute esse comando com sudo. A documentação recomenda não usar sudo npm install -g porque isso deixa ficheiros pertencentes a root no prefixo global do npm. A instalação ou atualização seguinte, executada por um utilizador sem privilégios, falha devido às permissões. Quando o diretório global do npm não permite escrita, a atualização automática em segundo plano deixa de funcionar. claude doctor apresenta as correções.

A Anthropic também publica repositórios de pacotes assinados para Debian, Fedora, RHEL e Alpine. Assim, sudo apt install claude-code funciona de forma semelhante ao pacote de desktop e utiliza a sua própria chave de assinatura em https://downloads.claude.ai/keys/claude-code.asc.

Instalação por utilizador ou para todo o sistema?

O instalador nativo faz uma instalação por utilizador. Coloca um launcher em ~/.local/bin/claude como symlink para ~/.local/share/claude/versions/, não precisa de root e atualiza-se em segundo plano. Cada utilizador da máquina obtém uma cópia separada, numa versão separada.

A instalação com um gestor de pacotes é feita para todo o sistema. Um único binário serve todos os utilizadores, precisa de root e não é atualizado automaticamente pelo Claude Code. A atualização é feita com sudo apt update && sudo apt upgrade claude-code, o mesmo comando que já utiliza para tudo o resto no sistema.

Escolha a instalação por utilizador numa máquina em que inicia sessão com a sua própria conta, que é o caso da maioria dos trabalhos em VPS. Escolha a instalação com pacote num servidor partilhado ou numa imagem de máquina, quando pretende uma única versão para todos e quer atualizá-la de acordo com o seu próprio calendário. Numa instalação nativa, duas definições em ~/.claude/settings.json determinam o comportamento das atualizações:

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

O canal stable acompanha uma release com cerca de uma semana e ignora releases com regressões graves. DISABLE_AUTOUPDATER interrompe apenas a verificação em segundo plano, por isso claude update continua a funcionar e mantém o controlo sobre o momento em que uma nova versão é instalada. Isto é importante num servidor onde uma tarefa longa é executada sem supervisão e em que prefere que o binário não seja alterado durante a execução.

Inicie sessão por SSH e mantenha a sessão ativa

Dois problemas específicos do Linux surgem na primeira execução da CLI num servidor alugado. O fluxo de início de sessão precisa de um navegador, mas o servidor não tem nenhum. Uma ligação SSH que cai interrompe o trabalho em execução.

O tmux resolve o segundo problema. Uma sessão tmux pertence ao servidor tmux na máquina remota, não à sua ligação. Por isso, uma ligação interrompida deixa o processo em execução.

tmux new -s claude
claude

Desanexe com Ctrl-b e depois d. Volte mais tarde com tmux attach -t claude.

O início de sessão é o primeiro problema. Execute claude para obter um URL de autorização. Abra esse URL no navegador do seu computador. Depois de iniciar sessão, o navegador mostra um código de início de sessão em vez de redirecionar de volta, porque o navegador do seu portátil não consegue aceder ao servidor de callback que o Claude Code iniciou no endereço de loopback da máquina remota. Cole esse código no terminal, no pedido Paste code here if prompted. O terminal apresenta Login successful.

Para uma sessão que tenha de começar sem ninguém a acompanhá-la, claude setup-token abre a mesma autorização no navegador e mostra um token OAuth válido por um ano no terminal. O token não é guardado em nenhum local. Copie-o e defina-o onde for necessário.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Esse token requer um plano pago e só pode fazer pedidos ao modelo. Trate-o como uma palavra-passe com validade de um ano. O local onde o guardar e a forma de impedir que um agente o leia são abordados em manter os segredos fora do alcance dos agentes de IA.

Os servidores pequenos enfrentam ainda outro problema. A instalação precisa de aproximadamente 512 MB de memória livre. O requisito de hardware documentado para a execução é 4 GB de RAM ou mais. Por isso, numa instância de 1 GB, o kernel termina a instalação através do mecanismo out-of-memory killer:

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

Adicione swap e execute novamente o instalador. O swap é espaço em disco que o kernel usa como memória de overflow. É muito mais lento do que a RAM, mas é suficiente para concluir uma instalação.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon ativa o ficheiro apenas durante este boot. Adicione uma linha para /swapfile a /etc/fstab se quiser reativá-lo depois de um reboot. O que deve bloquear antes de permitir que um agente execute comandos num servidor em produção é abordado em executar o Claude Code com segurança num VPS.

Onde ficam as credenciais do Claude no Linux

No Linux, /login grava a credencial em ~/.claude/.credentials.json com o modo de ficheiro 0600. O macOS coloca a mesma credencial no Keychain encriptado, pelo que um hábito criado num Mac não se aplica aqui: no Linux, o token é um ficheiro simples no seu diretório pessoal e qualquer processo executado com o seu utilizador pode lê-lo. Definir CLAUDE_CONFIG_DIR move o ficheiro para esse diretório.

Isto tem duas consequências. Uma cópia de segurança de /home contém um início de sessão válido. Copiar essa cópia para uma máquina partilhada entrega a sua conta a qualquer pessoa que consiga lê-la. Uma imagem de máquina criada a partir de um sistema onde iniciou sessão também inclui esse início de sessão em todas as instâncias clonadas a partir dela. Execute /logout antes de criar qualquer snapshot.

A precedência das credenciais causa problemas a quem tem uma subscrição e uma chave de API ao mesmo tempo. Quando ANTHROPIC_API_KEY está definida na shell, o Claude Code utiliza-a depois de a aprovar. Nesse caso, a subscrição fica sem utilização e a chave é faturada por token. /status mostra qual é a credencial ativa, e unset ANTHROPIC_API_KEY repõe o início de sessão da subscrição.

Os inícios de sessão expiram. Nos três dias anteriores à expiração, a linha de arranque apresenta Your login expires in 3 days, mas esse aviso nunca bloqueia um pedido. Depois da expiração, todos os pedidos falham com Login expired · Please run /login. Tenha isto em conta antes de deixar uma sessão sem supervisão a executar durante um fim de semana, porque essa sessão deixa de avançar e não consegue recuperar sozinha.

Uma subscrição Claude cobre tudo?

Um plano pago cobre todas as interfaces com o mesmo início de sessão. Uma conta Pro, Max, Team ou Enterprise permite iniciar sessão em claude.ai no navegador, na aplicação de desktop, na CLI e na extensão do VS Code. É a mesma subscrição em todos os casos. O limite de utilização também é partilhado entre todas elas. Uma execução longa na CLI do servidor consome o limite que ainda estaria disponível na aplicação de desktop. Por isso, quando uma das interfaces deixa de aceitar trabalho, é necessário verificar qual janela de limite foi atingida e o que fazer a seguir. O plano gratuito de claude.ai não inclui acesso ao Claude Code. A CLI e as funcionalidades do Claude Code na aplicação de desktop exigem um plano pago ou uma conta Claude Console.

A API é um produto diferente, com faturação própria. Uma conta Console cobra por token, com base no que é efetivamente enviado. Este modelo é adequado para um serviço que está a desenvolver, e não para introduzir comandos num terminal. Definir ANTHROPIC_API_KEY coloca a CLI nesse modelo de faturação. Essa é uma escolha explícita, não uma alternativa automática.

Os preços e os limites dos planos mudam com demasiada frequência para serem repetidos aqui. Duas páginas acompanham os valores atuais: quanto custa realmente o Claude Code e de que plano Claude precisa. Se estiver a comparar a faturação por token com um plano mensal, a comparação entre a API e uma subscrição explica onde fica o ponto de equilíbrio.

Os erros de instalação que você realmente verá

bash: claude: command not found logo depois de uma instalação bem-sucedida. O binário está em ~/.local/bin/claude, mas esse diretório não está no caminho de pesquisa da sua shell. Confirme com echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin". O comando não imprime nada quando a entrada está ausente. Corrija isso no bash com echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc e execute source ~/.bashrc. Instalar apenas a extensão do VS Code nunca cria esse ficheiro, porque a extensão mantém a sua cópia da CLI dentro do diretório da extensão.

Error loading shared library libstdc++.so.6. O instalador selecionou a compilação para musl num sistema com glibc. Isto acontece quando existem pacotes de compilação cruzada para musl e a deteção os interpreta incorretamente. Execute ldd --version 2>&1 | head -1: uma saída com o nome GNU libc ou GLIBC significa que o sistema usa glibc e recebeu o binário errado. Remova a instalação e execute o instalador novamente. No Alpine e noutros sistemas com musl, a correção é o oposto: apk add libgcc libstdc++ ripgrep.

Duas cópias de claude no mesmo sistema. which -a claude lista todas as correspondências no seu PATH. Uma instalação nativa é um link simbólico de ~/.local/bin/claude para ~/.local/share/claude/versions/, uma instalação local legada do npm fica em ~/.claude/local/ e npm -g ls @anthropic-ai/claude-code mostra uma instalação global do npm. Remova as cópias que não pretende usar, porque uma cópia antiga que aparece antes no PATH faz com que um erro já corrigido pareça continuar sem correção.

Onde verificar o estado atual

• Estado, requisitos e comandos de instalação do desktop Linux: code.claude.com/docs/en/desktop-linux
• Distribuições compatíveis e todos os métodos de instalação da CLI: code.claude.com/docs/en/setup
• Plataformas que têm uma aplicação disponível para transferência: claude.com/download
• O que cada plano inclui e quanto custa: claude.com/pricing

Todos os números de versão e datas deste guia correspondem a um retrato de agosto de 2026. O que permanece válido é a estrutura: quatro interfaces, uma única sessão nas opções pagas e uma decisão sobre se a CLI deve pertencer ao seu utilizador ou a toda a máquina.

FAQ

Existe uma aplicação desktop do Claude para Linux?

Sim. Em agosto de 2026, está em beta e é compatível com Ubuntu 22.04 ou posterior e Debian 12 ou posterior, em amd64 ou arm64. Instale-a com sudo apt install claude-desktop depois de adicionar o repositório apt da Anthropic e a respetiva chave de assinatura, para que as novas versões sejam instaladas com as atualizações normais do sistema. A versão para Linux tem os mesmos separadores da aplicação para macOS, incluindo o separador Claude Code. O Computer Use e a ditado por voz ainda não estão disponíveis na versão para Linux. O Fedora e o RHEL não têm pacote. Nessas distribuições, use a CLI ou o claude.ai num navegador.

Preciso do Node.js para executar o Claude Code no Linux?

Não para a instalação recomendada. curl -fsSL https://claude.ai/install.sh | bash descarrega um binário compilado que não usa Node.js em runtime. O Node.js só é necessário se instalar o pacote npm, que requer Node.js 22 ou posterior a partir da versão 2.1.198. Com uma versão mais antiga do Node.js, o npm apresenta um aviso EBADENGINE e a instalação termina na mesma, porque o mesmo binário nativo é instalado como uma dependência específica da plataforma. Nunca o instale com sudo npm install -g, porque isso cria ficheiros pertencentes a root no seu prefixo npm e impede atualizações posteriores.

Como inicio sessão no Claude Code através de SSH?

Execute claude. O comando apresenta um URL de autorização. Abra esse URL no navegador do seu próprio computador, não no servidor. Depois de iniciar sessão, o navegador apresenta um código de início de sessão em vez de redirecionar, porque não consegue alcançar o listener de callback iniciado pelo Claude Code no endereço de loopback da máquina remota. Cole esse código no prompt Paste code here if prompted. Para sessões que começam sem um utilizador presente, execute claude setup-token e defina o token apresentado como CLAUDE_CODE_OAUTH_TOKEN onde for necessário.

Onde é que o Claude Code guarda os meus dados de início de sessão no Linux?

Em ~/.claude/.credentials.json, com o modo de ficheiro 0600, ou em CLAUDE_CONFIG_DIR quando essa variável está definida. No Linux não é utilizado nenhum keychain, ao contrário do macOS. Por isso, qualquer processo executado como o seu utilizador pode ler o ficheiro. Uma cópia de segurança /home ou uma imagem da máquina transporta, portanto, um início de sessão válido. Execute /logout antes de criar um snapshot ou copiar um sistema. Se ANTHROPIC_API_KEY também estiver definida no ambiente, tem precedência sobre o início de sessão da subscrição armazenado depois de a aprovar. /status mostra qual está ativo.

A minha subscrição Claude Pro também inclui a CLI e a aplicação Web?

Sim. Um plano Pro, Max, Team ou Enterprise inicia sessão no claude.ai, na aplicação desktop, na CLI e na extensão do VS Code com uma única conta. O plano gratuito do claude.ai não inclui o Claude Code. Por isso, a CLI do terminal requer um plano pago ou uma conta Claude Console. A API é faturada separadamente por token a partir de uma conta Console, que é um produto diferente de uma subscrição.