# Como instalar o Tallos no Windows 10 e 11

> Para instalar o Tallos no Windows, crie uma conta em /signup, escolha o build para Windows, rode o instalador baixado e abra o Tallos pelo atalho da área de trabalho ou do menu Iniciar. O Tallos roda no Windows 10 ou mais recente. Na primeira abertura você escolhe idioma e agente padrão e abre a pasta de um projeto. O terminal padrão é o PowerShell.

- Canonical: https://runtallos.com/pt/aprenda/instalar-no-windows
- English: https://runtallos.com/learn/install-on-windows.md
- Atualizado em: 2026-09-29
- Section: Aprenda

## Em resumo

- Windows 10 ou mais recente
- Um instalador, com atalhos na área de trabalho e no menu Iniciar
- PowerShell, Prompt de Comando ou WSL como shell
- No Windows, as CLIs dos agentes instalam via npm

## O que eu preciso antes de instalar o Tallos no Windows?

Você precisa de um PC com **Windows 10 ou mais recente** e de uma conta no Tallos. O Tallos é um [ADE](https://runtallos.com/pt/o-que-e-um-ade) para desktop que roda os agentes de IA que você já usa, cada um no seu workspace git, então algumas ferramentas de desenvolvimento deixam a primeira sessão mais tranquila.

- **Windows 10 ou mais recente.** Confira em Configurações → Sistema → Sobre.
- **Uma conta no Tallos.** Cadastro gratuito em [/signup](https://runtallos.com/signup).
- **Git for Windows.** Os workspaces do Tallos são git worktrees de verdade, então `git --version` precisa funcionar no PowerShell.
- **Node.js.** No Windows, toda instalação de agente com um clique em [Conexões](https://runtallos.com/pt/recursos/conexoes-de-agentes) usa o pacote npm do fabricante, então o Node.js (que traz o npm) precisa estar instalado antes.
- **Pelo menos uma CLI de agente**, como Claude Code, Codex ou Gemini CLI. Não é obrigatório na instalação; dá para adicionar depois.
- **WSL (opcional).** Se seus repositórios ficam dentro do WSL, o Tallos consegue abrir terminais por ele.

## Como instalar o Tallos no Windows, passo a passo?

1. **Crie sua conta no Tallos** — Acesse [/signup](https://runtallos.com/signup). Informe nome completo e e-mail de trabalho, depois sua função, o tamanho do time e os agentes que você já usa. No campo de download, escolha **Windows · 10 or later**, aceite os termos e clique no botão para criar a conta e baixar.
2. **Baixe o instalador** — A página de download abre com o instalador (.exe) pronto. Se o build para Windows ainda não foi publicado, a conta é criada e o link chega por e-mail assim que ele sair.
3. **Rode o instalador** — Dê dois cliques no .exe baixado. O instalador copia o Tallos para o PC e cria um atalho na área de trabalho e no menu Iniciar.
4. **Responda ao SmartScreen, se ele aparecer** — Se o Windows mostrar **O Windows protegeu o computador**, clique em **Mais informações**, confira se o editor e o nome do arquivo são os esperados e clique em **Executar assim mesmo**. Faça isso só com o arquivo baixado pela sua conta do Tallos.
5. **Abra o Tallos e escolha idioma e agente** — Abra o Tallos pelo atalho. A tela de boas-vindas pede o idioma e mostra as CLIs de agentes encontradas em **Qual agente de IA você usa?** Escolha uma e clique em **Continuar**.
6. **Abra seu primeiro projeto** — Clique em **Escolher uma pasta** e selecione a pasta com o seu código, use **Clonar de uma URL** ou clique em **Pular por agora** para fazer isso depois.

> Baixe o build para Windows — crie sua conta e instale o Tallos. → https://runtallos.com/signup

## Por que o SmartScreen do Windows avisa sobre o instalador?

O SmartScreen avisa sobre downloads que ele ainda viu pouco, mesmo quando são assinados. É uma checagem de reputação, não um diagnóstico de vírus. Os instaladores de release do Tallos têm assinatura de código, e **Mais informações** mostra o editor para você confirmar o que está rodando antes de clicar em **Executar assim mesmo**.

Em PCs gerenciados pela empresa, o SmartScreen ou uma política de lista de permissões pode bloquear o instalador de vez. Nesse caso, peça aprovação ao TI; não tente contornar a política.

## Qual shell o Tallos usa no Windows: PowerShell, CMD ou WSL?

O Tallos usa o PowerShell por padrão, e você pode trocar o padrão para Prompt de Comando ou WSL em **Configurações → Terminal**. O WSL aparece como opção automaticamente quando está instalado e funcionando. O menu **+** da barra de abas também abre uma aba avulsa em qualquer shell, sem mudar o padrão.

| Shell | Quando escolher | Observações |
| --- | --- | --- |
| PowerShell | Repositórios em caminhos do Windows e ferramentas do Windows | É o padrão e atende a maioria |
| Prompt de Comando | Seus scripts são `.cmd` / `.bat` | Disponível em Configurações → Terminal e no menu + |
| WSL | Seus repositórios ficam dentro do WSL | Repos em `\\wsl.localhost\...` abrem via `wsl.exe`; repos em caminho Windows abrem no WSL em `/mnt/<drive>/...` |

_Shells do Windows no Tallos_

Os atalhos de teclado usam **Ctrl** onde a documentação de macOS diz **Cmd**. O atalho de **nova aba de agente** vem sem tecla definida no Windows; configure um em Configurações → Atalhos se quiser. Mais sobre terminais na [página do terminal](https://runtallos.com/pt/recursos/terminal).

## Como instalo Claude Code, Codex ou Gemini CLI no Windows pelo Tallos?

Abra **Configurações → Conexões**. Cada CLI oficial de agente tem um cartão com o status: **Não instalado**, **Instalado, não conectado** ou **Conectado**. Clique em **Instalar** e o Tallos mostra o comando npm do fabricante antes de rodá-lo. Depois, **Entrar** abre o login do próprio agente num terminal, e **Usar chave de API** guarda a chave no armazenamento seguro do Windows, para os agentes que aceitam chave.

Se o cartão disser **Precisa do Node.js primeiro**, instale o Node.js pelo nodejs.org e clique em **Atualizar**. O Tallos usa as assinaturas e chaves de API que você já tem. Detalhes de cada agente: [como conectar seus agentes](https://runtallos.com/pt/aprenda/conectar-seus-agentes).

## O que acontece na primeira vez que abro o Tallos no Windows?

Você vê as mesmas boas-vindas em dois passos do macOS. O primeiro define o idioma da interface e o agente padrão. Em **Avançado** existe **Deixar os agentes executarem comandos sem perguntar**, que vem **desligado**: os agentes pedem permissão antes de rodar comandos até você decidir o contrário. O segundo passo abre seu primeiro projeto.

Depois, três tours curtos aparecem na hora certa: **começar uma tarefa**, **testar um segundo agente** e **revisar e decidir**. Siga os tours ou leia o [guia da primeira tarefa](https://runtallos.com/pt/aprenda/primeira-tarefa), que mostra o mesmo ciclo com mais detalhe.

## Solução de problemas: e se o Tallos não funcionar no meu PC com Windows?

- **O instalador foi bloqueado.** O SmartScreen ou uma política da empresa impediu. Use **Mais informações → Executar assim mesmo** num PC pessoal, ou peça ao TI num PC gerenciado.
- **Nenhum agente encontrado.** A CLI não está instalada ou não está no PATH que o Tallos enxerga. Abra o PowerShell e rode `claude`, `codex` ou `gemini`; se o comando não existir, instale por Configurações → Conexões ou com o comando npm do fabricante.
- **A instalação diz que precisa do Node.js.** Instale o Node.js e clique em **Atualizar** na página de Conexões. Talvez seja preciso reiniciar o Tallos para ele enxergar o PATH novo.
- **A criação do workspace falha.** Confira se o Git for Windows está instalado e se a pasta é um repositório git. Se faltar a branch base, rode `git fetch origin` no projeto.
- **O WSL não aparece.** O Tallos só lista o WSL quando ele está instalado e respondendo. Rode `wsl --status` no PowerShell para conferir.
- **`tallos` não é reconhecido num terminal externo.** Registre a CLI em Configurações → Geral → Tallos CLI e abra um terminal novo para ele carregar o PATH atualizado.

## O que fazer depois de instalar o Tallos no Windows?

Rode uma tarefa do começo ao fim com o [guia da primeira tarefa](https://runtallos.com/pt/aprenda/primeira-tarefa) e depois teste dois agentes na mesma tarefa em [workspaces paralelos](https://runtallos.com/pt/recursos/workspaces-paralelos). Quando isso ficar natural, [monte sua primeira squad](https://runtallos.com/pt/aprenda/seu-primeiro-squad).

> Teste no seu próprio repositório. → https://runtallos.com/signup

## Perguntas frequentes

### O Tallos funciona no Windows 11?

Sim. O Tallos suporta o Windows 10 e versões mais recentes, o que inclui o Windows 11.

### Dá para usar o WSL com o Tallos?

Sim. Com o WSL instalado, você pode torná-lo o shell padrão em Configurações → Terminal ou abrir uma aba avulsa de WSL pelo menu +. Repositórios no sistema de arquivos do WSL abrem via wsl.exe.

### Por que preciso do Node.js para instalar agentes no Windows?

A instalação oficial para Windows do Claude Code, do Codex, do Gemini CLI e dos outros agentes em Conexões é um pacote npm, então o npm, que vem com o Node.js, precisa estar presente.

### É seguro clicar em Executar assim mesmo no aviso do SmartScreen?

Só para o instalador baixado pela sua conta do Tallos. Clique antes em Mais informações e confira o editor e o nome do arquivo.

### O Tallos suporta PowerShell e Prompt de Comando?

Sim. O PowerShell é o padrão e o Prompt de Comando está disponível como padrão ou em abas avulsas, junto com o WSL quando ele está instalado.

### Preciso ser administrador para instalar o Tallos no Windows?

Isso depende das políticas da empresa. Num PC pessoal você roda o instalador normalmente; num PC gerenciado, o TI pode precisar aprovar.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)