# GUI do Claude Code para Windows e Linux

URL: https://agentvera.dev/pt/blog/claude-code-gui-windows-linux/ · Publicado: 2026-10-08

Muitas GUIs do Claude Code são só para Mac. Instale o Claude Code no Windows (nativo ou WSL) e no Linux e rode vários agentes lado a lado num app desktop.

**Resumo:**

- O Claude Code instala de forma nativa no Windows sem WSL e, no Windows nativo, precisa do Git for Windows porque roda os comandos de shell pelo Git Bash.
- No Linux, o instalador nativo é um único comando e, num servidor headless, o claude mostra um link de login que você pode abrir em outra máquina.
- O AgentVera roda nativamente no Windows e no Linux e inicia o claude nativo do Windows; se o Claude Code só existe no WSL, instale-o também de forma nativa ou rode wsl claude num agente Terminal.

Procure uma GUI do Claude Code e a maior parte do que você encontra tem uma linha pequena no rodapé: só macOS. O Conductor é só para Mac. O Superset foi feito primeiro para macOS. Tudo bem se você trabalha num MacBook, mas muitos desenvolvedores programam num desktop Windows ou numa estação Linux e querem a mesma coisa que os usuários de Mac têm: vários agentes do Claude Code numa janela, cada um na sua branch, com uma visão clara de quem está fazendo o quê.

Este post cobre as duas metades: fazer o próprio Claude Code rodar no Windows (nativo e WSL) e no Linux, e depois usar um app desktop que roda nesses sistemas. Eu desenvolvo o AgentVera, que é um desses apps, então vou ser específico sobre o que ele faz em cada plataforma.

## Existe uma GUI do Claude Code para Windows e Linux?

Sim, algumas:

- **O app desktop do Claude Code, da Anthropic,** roda sessões do Claude, inclusive em paralelo em worktrees. Ele roda só o Claude.
- **O AgentVera** roda nativamente no macOS, no Windows e no Linux. Ele abre o Claude Code e outros 17 agentes de código em terminais reais, lado a lado, por projeto.
- **O Nimbalyst** (sucessor do Crystal) é um app gratuito, com licença MIT, para macOS, Windows e Linux, com Claude Code, Codex e OpenCode.
- **O Claude Squad** é uma interface de terminal sobre o tmux, então roda no Linux e dentro do WSL.

Para uma comparação mais ampla, veja [as melhores ferramentas para rodar vários agentes de código com IA em paralelo](/pt/blog/best-tools-parallel-ai-coding-agents/). Se você veio de uma ferramenta só para Mac, nossas comparações com o [Conductor](/pt/alternatives/conductor/) e o [Superset](/pt/alternatives/superset/) entram em detalhes.

Qualquer que seja a GUI escolhida, ela precisa do Claude Code instalado primeiro. Vamos começar por aí.

## Posso rodar o Claude Code no Windows sem WSL?

Sim. O Claude Code tem uma instalação nativa para Windows; o WSL não é mais obrigatório.

### Instalação nativa no Windows

Abra o PowerShell e rode o instalador da Anthropic:

```powershell
irm https://claude.ai/install.ps1 | iex
```

Se preferir npm e já tiver o Node.js:

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

Depois confira a instalação e faça login:

```powershell
claude --version
claude doctor
claude
```

A primeira execução do `claude` abre seu navegador para entrar com sua conta Claude.

**Git for Windows.** No Windows nativo, a documentação do Claude Code pede o [Git for Windows](https://git-scm.com/download/win), porque o Claude usa o Git Bash para rodar comandos de shell. Instale com as opções padrão. Se o Claude não encontrar o Git Bash, aponte o caminho com a variável de ambiente `CLAUDE_CODE_GIT_BASH_PATH`, por exemplo `C:\Program Files\Git\bin\bash.exe`. Os passos de instalação mudam de vez em quando, então confira a documentação de configuração atual da Anthropic se algo aqui não bater.

### Devo usar o WSL?

O WSL ainda é uma boa escolha quando:

- seu projeto é um projeto Linux (muito Docker, scripts de shell, ferramentas só para Linux),
- seu código já está no sistema de arquivos do WSL, onde o acesso a arquivos é muito mais rápido do que em `/mnt/c`,
- você quer o mesmo ambiente dos seus servidores Linux (ou quer [rodar o Claude Code num servidor remoto](/pt/blog/claude-code-remote-server/ "Run Claude Code on a remote server") de vez).

Instale o WSL e o Ubuntu num PowerShell de administrador e depois instale o Claude Code dentro dele como no Linux:

```powershell
wsl --install
```

```bash
# inside the Ubuntu shell
curl -fsSL https://claude.ai/install.sh | bash
claude
```

A contrapartida: um Claude Code dentro do WSL é um programa Linux. Os apps do Windows não o enxergam no PATH. Tenha isso em mente ao escolher uma GUI (mais abaixo).

## Como instalo o Claude Code no Linux?

No Linux, o instalador nativo é um único comando:

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

O npm também funciona (`npm install -g @anthropic-ai/claude-code`). Evite `sudo npm install -g`; se o npm reclamar de permissões, use um gerenciador de versões do Node como o nvm para que os pacotes globais fiquem na sua pasta pessoal.

Num servidor headless sem navegador, o `claude` mostra um link de login que você pode abrir em outra máquina.

## Por que a maioria das GUIs do Claude Code só roda no macOS?

Há alguns motivos, nenhum deles ligado ao Claude Code em si:

- **O tratamento de terminal é diferente.** macOS e Linux compartilham os pseudoterminais Unix. O Windows usa o ConPTY, que se comporta de outro jeito com cores, redimensionamento e sinais.
- **Shims de CLI no Windows.** No Windows, o npm instala `claude.cmd`, `codex.cmd` e arquivos `.cmd` parecidos. Eles só rodam pelo `cmd.exe`, que reinterpreta cada argumento. Configurações em JSON, `&`, `|`, `%` e as quebras de linha de um prompt de papel acabam deformados.
- **Empacotamento e assinatura.** Cada plataforma precisa do seu próprio instalador, canal de atualização e testes.
- **Quem os desenvolve.** Muitas dessas ferramentas começaram como um projeto de fim de semana num MacBook.

## Usando o AgentVera no Windows

O AgentVera tem um build nativo para Windows, não uma adaptação rodando pelo WSL. [Baixe](/pt/download/) o instalador x64 (`.exe`) e execute. O instalador ainda não é assinado com um certificado da Microsoft, então o SmartScreen mostra um aviso na primeira vez: clique em “More info” e depois em “Run anyway”. Depois disso, as novas versões são baixadas em segundo plano e instaladas quando você reinicia.

O que ele faz especificamente no Windows:

- **Desembrulha os shims `.cmd`.** Quando encontra `claude.cmd`, `codex.cmd` ou `gemini.cmd`, o AgentVera lê o shim e inicia diretamente o script que ele envolve, em vez de passar pelo `cmd.exe`. Papéis, configurações em JSON e caracteres especiais chegam intactos.
- **Encontra seu shell.** Um agente Terminal abre o PowerShell 7 se estiver instalado, depois o Windows PowerShell e depois o `cmd.exe`. Se `SHELL` apontar para um programa real como o Git Bash, ele tem prioridade.
- **Terminais reais.** Cada agente roda numa sessão de terminal real, então a interface do próprio Claude Code, os slash commands e as perguntas aparecem como no Windows Terminal.

### E o Claude Code dentro do WSL?

O AgentVera inicia o `claude` nativo do Windows que encontra no seu PATH. Se o Claude Code só existe dentro do WSL, instale-o também de forma nativa no Windows (seus projetos podem ficar onde estão) ou abra um agente Terminal e rode `wsl claude` nele. A segunda opção dá a você um painel de terminal, sem os recursos do AgentVera específicos para o Claude, como retomar sessões e trocar de conta.

## Usando o AgentVera no Linux

Dois pacotes: um AppImage para qualquer distro x86_64 e um `.deb` para Debian e Ubuntu.

```bash
# AppImage
chmod +x AgentVera-linux-x86_64.AppImage
./AgentVera-linux-x86_64.AppImage

# or the .deb
sudo apt install ./AgentVera-linux-amd64.deb
```

O AppImage se atualiza sozinho em segundo plano. Se ele não abrir num Ubuntu recente, instale o `libfuse2`, de que os AppImages precisam e que as versões mais novas não trazem por padrão.

O AgentVera encontra CLIs instaladas pelo Homebrew, nvm, Volta e asdf, então um `claude` instalado com um gerenciador de versões é detectado mesmo quando o app é aberto pelo lançador da área de trabalho, e não por um shell.

## O que você tem em todas as plataformas

Com o Claude Code instalado, a experiência é a mesma no Windows, no Linux e no macOS:

- **18 agentes de código.** Claude Code, Codex, Gemini CLI, Copilot, Cursor, opencode, Qwen Code, Kiro, Amp, Aider e outros, cada um com [sua própria página](/pt/agents/). Qualquer outro roda num agente Terminal.
- **Os logins deles.** O AgentVera usa o login do Claude Code; nada de chave de API. Cada conta extra que você adiciona ganha sua própria pasta `CLAUDE_CONFIG_DIR` e faz login com `claude auth login` no terminal do app.
- **Uma grade por projeto.** Layouts de 1×1 a 5×4, com status e tamanho do contexto ao vivo em cada painel. Veja o [workspace](/pt/features/workspace/).
- **Worktrees.** Crie um pelo [painel Git](/pt/features/git-and-github/) e inicie um agente diretamente nele, para que agentes em paralelo não editem os mesmos arquivos.
- **Limites.** A [troca de conta](/pt/features/account-switching/) (Pro) passa um agente para a próxima conta Claude quando um limite acaba; o `/compact` pode rodar automaticamente ao atingir um limite de contexto.
- **Máquinas remotas.** O [SSH](/pt/features/ssh-and-sftp/) permite rodar o Claude Code num servidor salvo com o login do Claude daquele servidor, útil quando seu notebook Windows conversa com uma máquina de build Linux.

Configurações em paralelo passo a passo estão em [como rodar vários agentes do Claude Code em paralelo](/pt/blog/run-multiple-claude-code-agents/).

## Problemas comuns no Windows e no Linux

**`claude` não é reconhecido.** A pasta de instalação ainda não está no PATH. Abra um terminal novo ou saia e entre de novo na sessão. No Windows, `where claude` mostra o que o PowerShell encontra; no Linux, `which claude`.

**O Claude não consegue rodar comandos de shell no Windows.** O Git for Windows está faltando ou o Claude não encontra o Git Bash. Instale-o ou defina `CLAUDE_CODE_GIT_BASH_PATH`.

**Acesso lento a arquivos no WSL.** Projetos em `/mnt/c` ficam lentos a partir do WSL. Mantenha os projetos do WSL no sistema de arquivos Linux (`~/code`).

**Finais de linha.** Equipes mistas veem diffs barulhentos quando ferramentas do Windows gravam CRLF. Adicione um `.gitattributes` com `* text=auto` e deixe o Git normalizar.

**Dois agentes, uma porta de servidor de desenvolvimento.** Vale em qualquer lugar: dê a cada worktree sua própria porta.

## Concluindo

Você não precisa de um Mac para trabalhar com vários agentes do Claude Code. O Claude Code roda nativamente no Windows (ou no WSL) e no Linux com um único comando de instalação. Quanto à GUI, o app da Anthropic cobre só o Claude; se você quer o Claude Code ao lado do Codex e de outros agentes, numa grade com worktrees e tratamento de limites, [o AgentVera é gratuito para baixar](/pt/download/) para Windows, Linux e macOS. Veja os [planos](/pt/pricing/) quando precisar dos recursos Pro.

## Perguntas frequentes

**Existe uma GUI do Claude Code para Windows?** Sim. O próprio app desktop do Claude Code, da Anthropic, é uma opção só para o Claude. O AgentVera roda nativamente no Windows e coloca o Claude Code, o Codex e outros 16 agentes de CLI lado a lado em terminais reais.

**Posso rodar o Claude Code no Windows sem WSL?** Sim. O Claude Code instala de forma nativa no Windows com um comando de uma linha no PowerShell ou com npm. A documentação pede o Git for Windows, porque ele usa o Git Bash para os comandos de shell. O WSL é opcional.

**O AgentVera funciona com o Claude Code instalado dentro do WSL?** O AgentVera inicia o comando claude nativo do Windows que encontra no seu PATH. Um Claude Code que só existe dentro do WSL não está nesse PATH; instale-o de forma nativa ou abra um agente Terminal e rode wsl claude nele.

**Quais pacotes Linux o AgentVera oferece?** Um AppImage que roda em qualquer distro x86_64 e um .deb para Debian e Ubuntu. O AppImage se atualiza sozinho em segundo plano.

**Preciso de uma chave de API?** Não. O AgentVera usa o login do próprio Claude Code, então um plano Claude Pro ou Max funciona como está. Cada conta extra faz login a partir da sua própria pasta.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/