Configurações
Conectar uma CLI local
A área Conecte sua CLI do Dev Space (Painel → Dev Space) permite que o Pluely detecte e use uma CLI de IA que você já tem instalada na máquina, para que as suas solicitações rodem por essa ferramenta local em vez de um dos modelos gerenciados do Pluely.
CLIs compatíveis
O Pluely consegue detectar e se conectar a cinco CLIs de IA populares, cada uma com sua própria página de configuração:
- Claude Code: a CLI da Anthropic; Sonnet / Opus / Haiku na sua assinatura do Claude.
- Gemini CLI: a CLI do Google, com um plano Google AI ou uma chave de API do Gemini; Gemini 3 Pro/Flash e 2.5 Pro/Flash.
- 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.
- Ollama: modelos totalmente locais e totalmente offline.
Se alguma delas estiver instalada localmente, o Conecte sua CLI a encontra sem você precisar digitar um caminho ou uma configuração à mão.
Como conectar uma CLI
- Abra o Dev Space e vá até Conecte sua CLI (no Dev Pro: Etapa 2. Conecte uma IA para receber respostas e depois Usar uma CLI neste computador).
- O Pluely procura na sua máquina as CLIs compatíveis instaladas localmente (com as versões exibidas).
- Clique em Conectar na que você quiser.
- A CLI conectada passa a aparecer no topo do seletor “Selecione um modelo” da sobreposição como Sua CLI, pronta para qualquer pergunta.
Se a CLI funciona no terminal, mas não no Pluely
Clique em Testar ao lado de conectado (no Dev Pro, fica em Etapa 2 → Usar uma CLI neste computador). O Pluely pede à CLI uma resposta de uma palavra pelo mesmo caminho que a sobreposição usa e mostra “Conectado e testado” ou o próprio erro da CLI abaixo da linha; esse texto é o diagnóstico. O Pluely também repassa o PATH do seu terminal para a CLI, então ferramentas instaladas com npm ou nvm (que são scripts Node) iniciam do mesmo jeito que num shell. Se uma pergunta na sobreposição falhar, a mensagem agora cita o que a CLI informou, em vez de um erro genérico.
Como escolher um modelo, em qualquer CLI
Cada CLI conectada ganha um painel Modelo logo abaixo da linha dela:
- Claude Code, Gemini CLI, OpenAI Codex, Qwen Code: escolha entre os modelos mais conhecidos (por exemplo, Sonnet/Opus/Haiku, Gemini 3 Pro, GPT-6 Astra, Qwen3 Coder), digite um ID de modelo personalizado ou deixe em Padrão (a CLI decide).
- Ollama: o painel lista os modelos que você baixou localmente; escolher um é obrigatório (não há padrão).
A sua escolha aparece no cartão da conexão e no seletor da sobreposição (por exemplo, Claude Code · opus, Ollama · llama3.2).
Capturas de tela e imagens
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 ativam o suporte a imagens automaticamente). Quando há visão, Capturar, Seleção e “Usar imagem” funcionam pela sua CLI.
Modelos de raciocínio
Os modelos de raciocínio são totalmente compatíveis com todas as CLIs: a cadeia de raciocínio que eles produzem é removida automaticamente, então você sempre recebe uma resposta final limpa.
Atualizar e Desconectar
- Atualizar: o botão de atualizar ao lado do título “Conecte sua CLI” faz uma nova busca, por exemplo, logo depois de instalar uma CLI nova (ele gira enquanto detecta).
- Desconectar: remove a conexão atual com a CLI. O grupo “Sua CLI” da sobreposição some até você conectar de novo.
Este é um recurso Pro
Conectar uma CLI exige uma licença ativa: qualquer plano pago ou a licença vitalícia Dev Pro. Sem ela, esta área mostra o convite “Desbloquear a CLI” em vez do fluxo de conexão.
Por que conectar uma CLI
Rodar as suas solicitações por uma CLI já instalada na sua máquina (Claude Code, Gemini CLI, OpenAI Codex, Qwen Code ou Ollama) mantém essas solicitações totalmente fora dos servidores do Pluely. A solicitação é tratada localmente pela ferramenta que você conectou, e o Pluely apenas a encaminha. Essa é a opção certa quando você quer a garantia mais forte de que suas perguntas e seu contexto nunca saem da sua máquina.
Relacionados
Última atualização: 10 de julho de 2026 · pluely.com