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

> Para conectar um agente de IA ao Tallos, abra Configurações → Conexões, clique em Instalar no cartão do agente e depois em Entrar com sua conta ou Usar chave de API. O Tallos roda o comando oficial de instalação do fabricante, abre o login do próprio agente e guarda chaves no armazenamento seguro do computador, entregando cada chave só ao seu agente. O agente padrão fica em Configurações → Agentes.

- Canonical: https://runtallos.com/pt/aprenda/conectar-seus-agentes
- English: https://runtallos.com/learn/connect-your-agents.md
- Atualizado em: 2026-09-29
- Section: Aprenda

## Em resumo

- Um cartão por CLI oficial: Claude Code, Codex, Gemini CLI, OpenCode, Grok CLI, Qwen Code, MiMo Code
- Instalar roda o comando verificado do fabricante, mostrado antes
- Chaves de API ficam no armazenamento seguro, só para o agente certo
- Usa as assinaturas e chaves que você já tem

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

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. **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. **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. **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. **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. **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. **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ó. → https://runtallos.com/signup

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

| Agente | Comando | Instalação (macOS) | Instalação (Windows) | Login | Chave de API no Tallos |
| --- | --- | --- | --- | --- | --- |
| [Claude Code](https://runtallos.com/pt/integracoes/claude-code) | `claude` | Homebrew cask `claude-code` ou npm `@anthropic-ai/claude-code` | npm `@anthropic-ai/claude-code` | `claude auth login` | Sim, como `ANTHROPIC_API_KEY` |
| [Codex](https://runtallos.com/pt/integracoes/codex) | `codex` | npm `@openai/codex` ou Homebrew cask `codex` | npm `@openai/codex` | `codex login` | Sim, repassada uma vez para `codex login --with-api-key` |
| [Gemini CLI](https://runtallos.com/pt/integracoes/gemini-cli) | `gemini` | Homebrew `gemini-cli` ou npm `@google/gemini-cli` | npm `@google/gemini-cli` | Login com Google na primeira execução | Sim, como `GEMINI_API_KEY` |
| [OpenCode](https://runtallos.com/pt/integracoes/opencode) | `opencode` | Homebrew `anomalyco/tap/opencode` ou npm `opencode-ai` | npm `opencode-ai` | `opencode auth login` | Não; o OpenCode guarda as chaves dos provedores |
| [Grok CLI](https://runtallos.com/pt/integracoes/grok-cli) | `grok` | npm `@xai-official/grok` ou o script oficial | npm `@xai-official/grok` | `grok login` | Sim, como `XAI_API_KEY` |
| [Qwen Code](https://runtallos.com/pt/integracoes/qwen-code) | `qwen` | Homebrew `qwen-code` ou npm `@qwen-code/qwen-code` | npm `@qwen-code/qwen-code` | `/auth` dentro de uma sessão do `qwen` | Não |
| [MiMo Code](https://runtallos.com/pt/integracoes/mimo-code) | `mimo` | npm `@mimo-ai/cli` ou o script oficial | npm `@mimo-ai/cli` | `mimo auth login` | Não |

_Cartões de Conexões no Tallos, conforme a documentação oficial de cada fabricante_

Outros agentes, como o [GitHub Copilot CLI](https://runtallos.com/pt/integracoes/github-copilot), 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.

> **Assinatura ou chave de API?** — Entrar com a sua conta usa o plano que você tem com o fabricante. A chave de API é cobrada por uso pelo fabricante. O Tallos funciona com os dois e não cobra nada pelos modelos.

## 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](https://runtallos.com/pt/aprenda/rodar-varias-sessoes-do-claude-code) ou mistura agentes numa [squad](https://runtallos.com/pt/recursos/squads).

## 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. → https://runtallos.com/signup

## Perguntas frequentes

### O Tallos inclui acesso aos modelos Claude, GPT ou Gemini?

Não. O Tallos usa as assinaturas e chaves de API que você já tem com cada fabricante. Ele não revende acesso a modelos.

### Minha chave de API fica segura no Tallos?

O Tallos guarda as chaves no armazenamento seguro do computador, nunca as mostra de novo e injeta cada chave só no processo do seu agente. Se o armazenamento seguro não estiver disponível, ele não salva a chave.

### Posso usar minha assinatura do Claude em vez de chave de API?

Sim. Clique em Entrar no cartão do Claude Code para rodar `claude auth login` e usar sua conta.

### Por que não tem opção de chave de API para OpenCode ou Qwen Code?

Essas ferramentas gerenciam as chaves sozinhas: o OpenCode guarda as chaves dos provedores via `opencode auth login`, e o Qwen Code configura provedores com `/auth` dentro da sessão.

### Dá para usar o GitHub Copilot CLI no Tallos?

Sim. Instale e faça login pelas instruções do GitHub, e o Tallos inicia a CLI pelo seletor de agentes. Ela não tem cartão em Conexões.

### Como mudo o agente padrão depois?

Vá em Configurações → Agentes → Agente padrão, ou clique em Definir como padrão no seletor de agente ao criar um workspace.

### Preciso de Node.js para conectar agentes?

No Windows, sim, porque toda instalação com um clique usa npm. No macOS, o Homebrew cobre vários agentes, mas algumas instalações ainda usam npm.

---

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