# Conexões de agentes: instale, faça login e escolha modelos em cada CLI

> Conexões de agentes é a página Configurações → Conexões do Tallos: um card para cada CLI oficial de agente (Claude Code, Codex, Gemini CLI, MiMo Code, Grok CLI, Qwen Code e OpenCode). Em cada card você instala a CLI com o comando verificado do fabricante, abre o login, salva uma chave de API no armazenamento seguro e vê os modelos. O que o Tallos não consegue verificar leva ao guia oficial.

- Canonical: https://runtallos.com/pt/recursos/conexoes-de-agentes
- English: https://runtallos.com/features/agent-connections.md
- Atualizado em: 2026-09-29
- Section: Recursos

## Em resumo

- 7 CLIs de agentes, um card para cada
- Instala só com o comando documentado pelo fabricante
- Chaves de API seladas no armazenamento seguro do computador
- Uma chave salva só chega àquele agente, só neste computador
- Usa suas próprias assinaturas; nenhum plano novo de IA

## 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](https://runtallos.com/pt/aprenda/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 |

_CLIs de agentes na página Conexões do Tallos, como registradas no app_

Cada agente tem sua própria página em [integrações](https://runtallos.com/pt/integracoes), por exemplo [Claude Code](https://runtallos.com/pt/integracoes/claude-code) e [Codex](https://runtallos.com/pt/integracoes/codex). O Tallos também roda outras CLIs pelo seletor de agentes, como o [GitHub Copilot](https://runtallos.com/pt/integracoes/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. → https://runtallos.com/signup

## 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](https://runtallos.com/pt/recursos/squads).

## 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.

---

**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+)