Guias
Como conectar uma CLI de IA local ao Pluely
Mande as perguntas do Pluely por uma CLI que você já usa (Claude Code, Gemini CLI, OpenAI Codex, Qwen Code ou Ollama) para que as respostas venham de uma ferramenta na sua própria máquina. Depois de conectada, sua CLI fica no topo do seletor de modelos da sobreposição.
O que “Sua CLI” significa no Pluely
O seletor de modelos da sobreposição é dividido em grupos: Sua CLI, Pesquisa na web / Modelos do Pluely e Seus provedores. “Sua CLI” é uma ferramenta de linha de comando de IA instalada na sua máquina à qual o Pluely se conecta diretamente. Enquanto uma CLI está conectada, ela é a opção ativa: as respostas rodam localmente por ela, não por nenhum modelo hospedado.
CLIs compatíveis
- Claude Code: a CLI da Anthropic; Sonnet / Opus / Haiku na sua assinatura do Claude.
- Gemini CLI: a CLI do Google, no seu plano Google AI ou com uma chave de API do Gemini.
- OpenAI Codex: modelos da classe GPT-6 no seu plano do ChatGPT.
- Qwen Code: modelos Qwen3-Coder com um Alibaba Cloud Coding Plan ou uma chave de API do Model Studio.
- Ollama: modelos abertos rodando totalmente offline no seu hardware.
Passo a passo: como conectar uma CLI
- Confirme que a CLI está instalada e funcionando no seu terminal (faça login lá primeiro, se ela exigir uma conta).
- Abra o Painel (ícone Início no canto superior esquerdo da sobreposição) → Dev Space → Conecte sua CLI.
- O Pluely detecta as CLIs instaladas automaticamente e mostra a versão de cada uma, sem caminhos para digitar. Acabou de instalar uma? Clique no botão de atualizar ao lado do título da seção para procurar de novo.
- Clique em Conectar na CLI que você quiser.
- Um painel Modelo aparece abaixo da linha conectada: escolha um modelo conhecido, digite um ID de modelo personalizado ou deixe em Padrão (a CLI decide). O Ollama é a exceção: nele é obrigatório escolher um dos modelos que você baixou localmente.
- Abra o seletor de modelos da sobreposição: sua CLI é a primeira opção, exibida com o modelo (por exemplo, Claude Code · opus).
Capturas de tela e modelos com raciocínio
- O painel Modelo informa se a configuração atual consegue ver imagens: Claude Code, Gemini CLI, OpenAI Codex e Qwen Code têm visão; no Ollama, depende do modelo baixado (llava, gemma3, qwen-vl e outras famílias multimodais).
- Modelos de raciocínio funcionam em todas as CLIs: a cadeia de raciocínio é removida automaticamente para você ver só a resposta final.
Por que o local-first importa
Uma CLI conectada roda na sua própria máquina, então as solicitações nunca precisam sair do seu dispositivo para chegar à infraestrutura gerenciada do Pluely. Se você já paga ou mantém uma assinatura de CLI, o Pluely vira uma sobreposição prática sobre uma ferramenta em que você já confia, sem nenhum modelo gerenciado novo no meio do caminho.
Como voltar para os modelos gerenciados
Abra o seletor de modelos e selecione qualquer opção em “Modelos do Pluely” ou “Seus provedores”: isso desativa o modo CLI por enquanto, e reconectar é um clique no Dev Space. Para remover a conexão de vez, use Desconectar na linha da CLI.
Solução de problemas quando a CLI não responde
- Execute a CLI no terminal, fora do Pluely: se falhar lá (login expirado, assinatura ausente), resolva lá primeiro; o Pluely acompanha.
- O Pluely mostra a própria mensagem de erro da CLI quando algo dá errado, então a solução costuma aparecer escrita ali mesmo na sobreposição.
- Acabou de instalar ou atualizar uma CLI? Clique no botão de atualizar ao lado de “Conecte sua CLI” para detectá-la de novo.
- Escolheu um ID de modelo personalizado que dá erro? Volte para Padrão (a CLI decide): sempre funciona.
- A exigência de “trusted directory” do Gemini CLI e a verificação de repositório git do Codex são tratadas pelo Pluely automaticamente, sem nenhuma flag.
Dicas
- Claude Code, Gemini CLI, OpenAI Codex e Qwen Code exigem contas próprias: o Pluely não gerencia essa cobrança, só se conecta ao que já está instalado.
- O Ollama é uma ótima escolha para inferência local totalmente offline e sem custo.
- Mantenha sua CLI atualizada por conta própria; o Pluely chama a versão que estiver na sua máquina.
- Se você alterna entre uma CLI e os modelos gerenciados com frequência, o seletor de modelos no topo da sobreposição resolve isso em um clique.
Relacionados
Última atualização: 10 de julho de 2026 · pluely.com