# Como instalar o Tallos no Mac (Apple Silicon e Intel) > Para instalar o Tallos no Mac, crie uma conta em /signup, escolha o build Apple Silicon ou Intel, abra o .dmg baixado e arraste o Tallos para Aplicativos. O Tallos roda no macOS 13 ou mais recente. Na primeira abertura você escolhe o idioma e o agente padrão e depois abre a pasta de um projeto. Leva poucos minutos. - Canonical: https://runtallos.com/pt/aprenda/instalar-no-mac - English: https://runtallos.com/learn/install-on-mac.md - Atualizado em: 2026-09-29 - Section: Aprenda ## Em resumo - macOS 13 ou mais recente - Builds separados para Apple Silicon e Intel - .dmg assinado e notarizado - Boas-vindas em dois passos: idioma + agente, depois o primeiro projeto ## O que eu preciso antes de instalar o Tallos no Mac? Você precisa de um Mac com **macOS 13 ou mais recente**, com chip Apple Silicon ou Intel, e de uma conta no Tallos. O resto dá para configurar depois. O Tallos é um [ambiente de desenvolvimento agêntico (ADE)](https://runtallos.com/pt/o-que-e-um-ade) para desktop: ele roda os agentes de IA que você já usa, cada um no seu workspace, então as CLIs dos agentes são programas à parte. - **macOS 13 ou mais recente.** Confira em menu Apple → Sobre Este Mac. - **Uma conta no Tallos.** O cadastro é gratuito e leva menos de um minuto em [/signup](https://runtallos.com/signup). - **Git.** Os workspaces do Tallos são git worktrees de verdade, então o git precisa estar instalado. Se `git --version` falhar no Terminal, rode `xcode-select --install` para instalar as ferramentas de linha de comando da Apple. - **Pelo menos uma CLI de agente**, como Claude Code, Codex ou Gemini CLI. Não é obrigatório na instalação: dá para instalar e entrar depois em [Configurações → Conexões](https://runtallos.com/pt/recursos/conexoes-de-agentes). - **Node.js ou Homebrew**, se você quiser instalar agentes com um clique. O Tallos roda o comando oficial de cada fabricante, e esses comandos usam npm ou Homebrew. ## Apple Silicon ou Intel: qual build do Tallos eu baixo? Escolha o build que corresponde ao chip do seu Mac. Macs com chip da linha M usam o build **Apple Silicon**; Macs mais antigos com processador Intel usam o build **Intel**. O formulário de cadastro mostra as duas opções na hora de escolher o download. | O que aparece em Sobre Este Mac | O que `uname -m` mostra no Terminal | Build certo | | --- | --- | --- | | Chip: Apple M1, M2, M3 ou mais novo | `arm64` | macOS · Apple Silicon | | Processador: Intel Core i5, i7, i9… | `x86_64` | macOS · Intel | _Como descobrir qual build do Mac você precisa_ ## Como instalar o Tallos no macOS, 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 **macOS · Apple Silicon** ou **macOS · Intel**, aceite os termos e clique no botão para criar a conta e baixar. 2. **Baixe o .dmg** — A página de download abre com o seu build pronto. Se o build do seu sistema ainda não foi publicado, a conta é criada do mesmo jeito e o link chega por e-mail assim que ele sair. 3. **Arraste o Tallos para Aplicativos** — Dê dois cliques no .dmg para montá-lo e arraste o ícone do Tallos para a pasta Aplicativos. Quando a cópia terminar, ejete a imagem de disco. 4. **Abra o Tallos e confirme o aviso do macOS** — Abra o Tallos pela pasta Aplicativos ou pelo Spotlight. Como ele veio da internet, o macOS pede confirmação na primeira vez. Clique em **Abrir**. Os builds de release são assinados e notarizados, então essa checagem acontece uma vez só. 5. **Escolha o idioma e o agente padrão** — A tela de boas-vindas pede o idioma e mostra, em **Qual agente de IA você usa?**, as CLIs de agentes que o Tallos encontrou no Mac. Escolha uma e clique em **Continuar**. Nenhum agente encontrado? Continue mesmo assim e adicione depois em Configurações → Conexões. 6. **Abra seu primeiro projeto** — Clique em **Escolher uma pasta** e selecione a pasta com o seu código, ou use **Clonar de uma URL** para clonar um repositório. Também dá para clicar em **Pular por agora** e adicionar o projeto depois. > Baixe o build para macOS — crie sua conta e instale o Tallos. → https://runtallos.com/signup ## O que acontece na primeira vez que eu abro o Tallos? A primeira abertura é uma boas-vindas em dois passos. **No primeiro**, o Tallos se apresenta em uma frase, deixa você trocar o idioma da interface e pergunta qual agente de IA você usa. Ele procura as CLIs instaladas e mostra as que encontrou em cartões. **No segundo**, você abre seu primeiro projeto. > **O bypass de permissões vem desligado** — Em **Avançado**, no primeiro passo, existe a opção **Deixar os agentes executarem comandos sem perguntar**. Ela vem desligada. Ligar deixa tudo mais rápido, mas os agentes passam a poder editar ou apagar arquivos sem confirmar com você. Deixe desligada até confiar no agente e na tarefa; dá para mudar depois em Configurações → Agentes → Permissões do agente. Depois das boas-vindas, três tours curtos aparecem sozinhos na hora certa: como **começar uma tarefa**, como **testar um segundo agente** na mesma tarefa e como **revisar e decidir** se fica ou descarta o resultado. Esse é o ciclo principal, e o [guia da primeira tarefa](https://runtallos.com/pt/aprenda/primeira-tarefa) mostra cada etapa. O macOS também pode pedir permissão para o Tallos acessar pastas como Documentos, Mesa ou Downloads quando você abre um projeto guardado nelas. Permita: os agentes e o git precisam ler e gravar esses arquivos. ## Por que o macOS pede confirmação antes de abrir o Tallos? O macOS pede confirmação para todo app baixado da internet, mesmo os assinados. O Gatekeeper verifica se o app tem assinatura de um desenvolvedor identificado e se foi notarizado pela Apple, e pergunta uma vez. Os builds de release do Tallos saem assinados e notarizados, então basta clicar em **Abrir**. Se o macOS disser que **não consegue verificar o desenvolvedor**, abra Ajustes do Sistema → Privacidade e Segurança, desça até a seção Segurança e clique em **Abrir Mesmo Assim** para o Tallos, mas só para um arquivo baixado pela sua conta do Tallos. Se o macOS disser que o app **não pode ser aberto** ou **está danificado**, não desative o Gatekeeper. Apague a cópia, baixe o build de novo pela sua conta e confira se escolheu o chip certo. Download incompleto ou app aberto direto do .dmg montado são as causas mais comuns. ## Como adiciono agentes de IA depois de instalar o Tallos? Abra **Configurações → Conexões**. Lá tem um cartão para cada CLI oficial de agente: Claude Code, Codex, Gemini CLI, OpenCode, Grok CLI, Qwen Code e MiMo Code. Cada cartão mostra se a ferramenta está instalada e conectada e oferece **Instalar**, **Entrar** e, quando o fabricante suporta, **Usar chave de API**. No macOS, a instalação com um clique usa Homebrew ou npm, conforme o que cada fabricante documenta. Se aparecer **Precisa do Homebrew primeiro** ou **Precisa do Node.js primeiro**, instale a ferramenta e clique em **Atualizar**. O Tallos usa as assinaturas e chaves de API que você já tem; ele não revende acesso a modelos. Passo a passo completo: [como conectar seus agentes](https://runtallos.com/pt/aprenda/conectar-seus-agentes). ## Solução de problemas: e se o Tallos não instalar ou não abrir no Mac? - **“Este app não é compatível com este Mac.”** Provavelmente você baixou o build errado ou o macOS é anterior ao 13. Confira o chip e a versão e baixe de novo. - **O Tallos abre, mas não encontra agentes.** A CLI não está instalada ou não está no PATH que o Tallos enxerga. Instale em Configurações → Conexões, ou rode a CLI uma vez no Terminal para ver se funciona. - **A criação do workspace falha.** Confira se a pasta é um repositório git e se o git está instalado. Se a branch base não foi buscada, rode `git fetch origin` no projeto e tente de novo. - **Um agente não inicia.** Rode o comando dele (por exemplo `claude` ou `codex`) num terminal. Se falhar lá também, o problema é de instalação ou login na própria CLI. - **O comando `tallos` não é encontrado num terminal externo.** Registre em Configurações → Geral → Tallos CLI e confira se `~/.local/bin` está no PATH do seu shell. - **O link de download não chegou.** Se o seu build não estava publicado no cadastro, o link chega por e-mail quando ele sair. Veja o spam do e-mail usado no cadastro. ## O que fazer depois de instalar o Tallos? Rode uma tarefa real do começo ao fim: abra um projeto, comece uma tarefa num workspace próprio, acompanhe o agente e revise o diff. O [guia da primeira tarefa](https://runtallos.com/pt/aprenda/primeira-tarefa) leva uns dez minutos. Depois, teste [rodar agentes em paralelo](https://runtallos.com/pt/rodar-agentes-de-ia-em-paralelo) ou [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 roda em Mac com Apple Silicon? Sim. O Tallos tem um build nativo para Apple Silicon e outro separado para Intel. Escolha o do seu chip no formulário de cadastro. ### Qual a versão mínima do macOS para o Tallos? O Tallos precisa do macOS 13 ou mais recente, em Apple Silicon ou Intel. ### Preciso ter Claude Code ou Codex instalado antes do Tallos? Não. Você pode instalar o Tallos primeiro e adicionar os agentes depois em Configurações → Conexões, que roda o comando oficial de instalação de cada fabricante e abre o login. ### O Tallos é assinado e notarizado no macOS? Sim. Os builds de release para macOS são assinados e notarizados. Mesmo assim o macOS pede confirmação na primeira abertura, como faz com qualquer app baixado da internet. ### O Tallos precisa de permissão de administrador no Mac? Copiar um app para a pasta Aplicativos pode pedir sua senha em Macs gerenciados. O Tallos em si roda como um app comum de usuário. ### Como desinstalo o Tallos do Mac? Feche o Tallos e arraste o app de Aplicativos para o Lixo. Seus repositórios não são alterados; os workspaces são git worktrees comuns que você remove com `git worktree remove`. --- **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+)