O que são as conexões de agentes no Tallos?
Conexões de agentes é a página do Tallos onde você configura os agentes de código que quer rodar. Cada agente é um programa separado do seu fabricante, então o Tallos não embute nem intermedeia nenhum deles. A página Conexões mostra quais CLIs de agentes estão neste computador e reúne num só lugar instalar, fazer login, adicionar uma chave de API e conferir os modelos.
O Tallos funciona com as assinaturas e chaves de API que você já tem. Ele não revende acesso a modelos; roda a CLI oficial do fabricante com a sua conta. Para um passo a passo, veja o guia conectar seus agentes.
Quais CLIs de agentes posso conectar?
A página Conexões tem um card para sete CLIs oficiais. Cada comando abaixo foi conferido na documentação ou no repositório do próprio fabricante; quando um passo não é documentado, o Tallos deixa de fora em vez de chutar.
| Agente | Comando | Instalar no macOS | Instalar no Windows | Login | Chave de API pelo Tallos |
|---|---|---|---|---|---|
| Claude Code | claude | brew install --cask claude-code ou npm @anthropic-ai/claude-code | npm install -g @anthropic-ai/claude-code | claude auth login | Salva, passada como ANTHROPIC_API_KEY |
| Codex | codex | npm install -g @openai/codex ou brew install --cask codex | npm install -g @openai/codex | codex login | Passada uma vez para codex login --with-api-key |
| Gemini CLI | gemini | brew install gemini-cli ou npm @google/gemini-cli | npm install -g @google/gemini-cli | Login com Google na primeira execução do gemini | Salva, passada como GEMINI_API_KEY |
| MiMo Code | mimo | npm install -g @mimo-ai/cli ou o script oficial de instalação | npm install -g @mimo-ai/cli | mimo auth login | Não oferecida; faça login |
| Grok CLI | grok | npm install -g @xai-official/grok ou o script oficial de instalação | npm install -g @xai-official/grok | grok login | Salva, passada como XAI_API_KEY |
| Qwen Code | qwen | brew install qwen-code ou npm @qwen-code/qwen-code@latest | npm install -g @qwen-code/qwen-code@latest | /auth dentro do qwen | Não oferecida; configure dentro do Qwen Code |
| OpenCode | opencode | brew install anomalyco/tap/opencode ou npm opencode-ai@latest | npm install -g opencode-ai@latest | opencode auth login | Não oferecida; o OpenCode guarda chaves por provedor |
Cada agente tem sua própria página em integrações, por exemplo Claude Code e Codex. O Tallos também roda outras CLIs pelo seletor de agentes, como o GitHub Copilot; elas só não têm card em Conexões.
Como funciona a instalação com um clique?
Clique em Instalar num card e o Tallos mostra o comando oficial exato que vai rodar neste computador antes de qualquer coisa. Confirme e a saída aparece no próprio diálogo; dá para parar a instalação a qualquer momento.
- O Tallos escolhe o primeiro método documentado que seu computador consegue rodar. No macOS pode ser Homebrew ou npm; no Windows é npm.
- Se falta uma ferramenta, o Tallos diz qual. Por exemplo: "Precisa do Node.js primeiro. Instale o Node.js em nodejs.org e depois clique em Atualizar."
- Se não existe instalação de um clique verificada, o card mostra Abrir guia de instalação e leva você às instruções do fabricante.
- O Tallos nunca inventa comando. Instalação, login e verificação de status vêm só de fontes oficiais dos fabricantes.
Como faço login num agente pelo Tallos?
Clique em Entrar e o Tallos abre uma aba de terminal no seu workspace local ativo rodando o comando de login documentado pelo fabricante, como claude auth login ou codex login. A CLI então abre o navegador para você concluir o login com a sua conta.
O login acontece neste computador de propósito: a página Conexões mostra as CLIs desta máquina, então fazer login via SSH logaria em outro lugar. Se nenhum projeto local estiver aberto, o Tallos mostra o comando para você rodar em qualquer terminal.
| Status do card | O que significa |
|---|---|
| Não instalado | A CLI ainda não está neste computador |
| Instalado, não conectado | A CLI está instalada e não mostra conta logada |
| Conectado | A CLI está instalada e logada |
| Instalado, login desconhecido | O fabricante não documenta um jeito confiável de checar o login, então o Tallos não chuta |
Baixe o Tallos e conecte seus agentes em poucos cliques.
Como o Tallos guarda e usa minha chave de API?
O Tallos sela a chave de API salva com o armazenamento seguro do seu computador (o cofre do sistema) e nunca grava em texto puro. Se o armazenamento seguro não estiver disponível, o Tallos se recusa a salvar a chave. Depois de salva, a chave nunca é mostrada de novo.
- Só aquele agente recebe. Quando o Tallos inicia o Claude Code, define
ANTHROPIC_API_KEY; quando inicia o Gemini CLI,GEMINI_API_KEY; no Grok CLI,XAI_API_KEY. A chave de um fabricante nunca chega a outra CLI. - Só neste computador. A chave entra nos agentes iniciados localmente e fica de fora das sessões SSH, então nunca sai desta máquina.
- O Codex cuida da própria chave. O Tallos passa a chave uma vez para
codex login --with-api-key, o Codex salva nas configurações dele e o Tallos não guarda cópia. - Alguns agentes gerenciam as próprias chaves. MiMo Code, Qwen Code e OpenCode não recebem chave do Tallos; use o login deles.
- Você pode remover a chave salva no mesmo diálogo quando quiser.
Consigo ver quais modelos cada agente oferece?
Sim. Clique em Modelos no card. Quando a CLI consegue listar os próprios modelos, como opencode models, o Tallos pergunta a ela e marca a lista como "Listados pela própria ferramenta". Senão, mostra os modelos conhecidos, com o aviso de que a ferramenta pode oferecer mais. Se nenhum dos dois for possível, você escolhe o modelo dentro da ferramenta.
As mesmas listas de modelos servem para o resto do app: você escolhe um modelo por sessão, e por líder e membro quando monta uma squad.
Perguntas frequentes
O Tallos inclui modelos ou assinatura de IA próprios?
Não. O Tallos roda as CLIs oficiais dos agentes com as assinaturas ou chaves de API que você já tem. Ele não revende acesso a modelos.
Como instalo o Claude Code pelo Tallos?
Abra Configurações → Conexões e clique em Instalar no card do Claude Code. O Tallos mostra o comando oficial, como brew install --cask claude-code no macOS ou npm install -g @anthropic-ai/claude-code, e roda depois que você confirma.
Onde o Tallos guarda minha chave de API?
No armazenamento seguro do seu computador (o cofre do sistema), selada e nunca em texto puro. O Tallos se recusa a salvar a chave se o armazenamento seguro não estiver disponível.
Um agente consegue ver a chave de API de outro?
Não. O Tallos injeta a chave salva só no ambiente de inicialização do agente dono dela, com o nome de variável documentado por aquele fabricante.
E se a instalação precisar de Node.js ou Homebrew?
O card diz qual ferramenta está faltando e onde conseguir. Instale, clique em Atualizar e a instalação com um clique fica disponível.
Por que um card mostra "Instalado, login desconhecido"?
Alguns fabricantes não documentam um jeito confiável de checar o login de fora da ferramenta. O Tallos mostra desconhecido em vez de chutar; o agente roda normalmente.
As Conexões funcionam no Windows?
Sim. No Windows todo agente suportado instala com o comando npm oficial, então você precisa do Node.js antes.
