Como conectar Claude Code, Codex, Gemini CLI e outros agentes ao Tallos

Como funcionam as conexões de agentes no Tallos?

Conexões é a página de Configurações onde o Tallos instala as CLIs dos agentes e faz o seu login nelas. Cada agente de IA para programação é um programa separado, do próprio fabricante. O Tallos não embute nem revende acesso a modelos: ele usa a assinatura ou chave de API que você já tem com Anthropic, OpenAI, Google e os demais, e roda cada agente nos seus workspaces.

Cada cartão mostra a versão do agente e um de quatro estados: Não instalado, Instalado, não conectado, Instalado, login desconhecido (o fabricante não oferece jeito confiável de checar) e Conectado. Os botões mudam conforme o estado: Instalar, Entrar, Usar chave de API, Modelos e Documentação.

Como conectar um agente ao Tallos, passo a passo?

1. 1

   Abra Configurações → Conexões

   Abra Configurações e escolha Conexões. O Tallos verifica quais CLIs de agentes estão no computador e mostra um cartão para cada agente compatível. Clique em Atualizar depois de instalar algo por fora do Tallos.

2. 2

   Instale o agente

   Clique em Instalar. O Tallos mostra o comando oficial de instalação do fabricante e só roda depois que você confirma, exibindo a saída ao vivo. Se o cartão disser Precisa do Node.js primeiro ou Precisa do Homebrew primeiro, instale a ferramenta e clique em Atualizar. Quando não existe instalação verificada com um clique, Abrir guia de instalação leva à documentação do fabricante.

3. 3

   Entre com sua conta

   Clique em Entrar. O Tallos abre o comando de login do próprio agente num terminal, como claude auth login ou codex login, e você conclui no navegador como sempre. O login precisa de um projeto aberto; sem projeto, rode o comando em qualquer terminal.

4. 4

   Ou use uma chave de API

   Nos agentes que aceitam, clique em Usar chave de API, cole a chave e salve. O Tallos confirma que a chave foi salva no armazenamento seguro e nunca mais a mostra. A opção de remover a chave salva apaga a chave.

5. 5

   Confira os modelos

   Abra Modelos para ver o que o agente oferece. Quando consegue, o Tallos lista os modelos informados pela própria ferramenta; senão, mostra um catálogo conhecido, e deixa isso claro na lista.

6. 6

   Defina o agente padrão

   Abra Configurações → Agentes e escolha o Agente padrão. Workspaces novos já vêm com ele selecionado. Também dá para clicar em Definir como padrão no seletor de agente ao criar um workspace.

Traga os agentes que você já paga. Baixe o Tallos e conecte todos num lugar só.

Baixar o Tallos →

Como cada agente é instalado e conectado?

Todo comando de instalação, comando de login e variável de ambiente que o Tallos usa vem da documentação ou do repositório oficial do fabricante. No Windows, toda instalação com um clique usa npm; no macOS, o Tallos prefere Homebrew quando o fabricante documenta.

Outros agentes, como o GitHub Copilot CLI, também rodam no Tallos pelo seletor de agentes. Eles não têm cartão em Conexões, então instale e faça login pelas instruções do fabricante; o Tallos encontra a CLI quando ela está no PATH.

Onde o Tallos guarda minhas chaves de API?

O Tallos guarda as chaves de API no armazenamento seguro do computador (o Keychain no macOS, o armazenamento protegido do sistema no Windows) e nunca mais as exibe. Quando o Tallos inicia um agente, ele injeta a chave salva daquele agente na variável de ambiente documentada pelo fabricante, e só no processo daquele agente. A chave do Claude Code nunca chega ao Gemini CLI, e vice-versa.

• Agentes por variável de ambiente (Claude Code, Gemini CLI, Grok CLI): o Tallos guarda a chave e repassa na inicialização.
• Codex: o Tallos repassa a chave uma vez para codex login --with-api-key, o Codex salva nas próprias configurações e o Tallos não fica com cópia.
• OpenCode, Qwen Code, MiMo Code: as chaves são gerenciadas dentro da própria ferramenta, então Usar chave de API não aparece.
• Workspaces remotos: as chaves salvas ficam só na máquina local e não vão para hosts SSH.
• Sem armazenamento seguro disponível: o Tallos se recusa a salvar a chave em vez de gravá-la em texto puro.

Como troco o agente padrão?

Troque em Configurações → Agentes → Agente padrão, ou clique em Definir como padrão ao lado de qualquer agente na criação de um workspace. O padrão é só uma pré-seleção: você ainda escolhe qualquer agente instalado em cada workspace, roda várias sessões do Claude Code em paralelo ou mistura agentes numa squad.

Solução de problemas: por que o agente aparece como não conectado?

• Instalei, mas o Tallos diz Não instalado. A CLI não está no PATH que o Tallos enxerga. Reinicie o Tallos depois de instalar e clique em Atualizar.
• Entrar não faz nada. Abra um projeto antes; o login roda num terminal dentro dele. Ou rode o comando de login em qualquer terminal e clique em Atualizar.
• Instalado, login desconhecido. Algumas CLIs não têm comando de status. Inicie o agente uma vez; se funcionar, você está conectado.
• A ferramenta rejeitou a chave. Cole de novo sem espaços e confira se é uma chave daquele fabricante.
• A instalação expirou ou falhou. Leia a saída na janela de instalação. Rede, proxy ou permissão do npm são as causas mais comuns; o guia do fabricante tem o passo a passo manual.

Teste no seu próprio repositório.

Baixar o Tallos →