Como configurar o Lumi: busca local, CLI e API
Encontre um arquivo local, escolha entre uma CLI, um modelo local e uma API e valide uma resposta curta junto com o modelo e a conta que registra o consumo.
Conteúdo
O Lumi usa caminhos diferentes para pesquisar arquivos e responder a perguntas. A busca consulta o índice do sistema operacional; a pergunta segue para a CLI ou API selecionada. Primeiro encontre um arquivo conhecido. Depois escolha uma conexão, envie uma pergunta curta sem dados sensíveis e confira o modelo e o consumo. Encontrar um documento não significa que o modelo leu seu conteúdo, e o nome de uma CLI no menu não comprova o uso da assinatura.
Os controles e o comportamento descritos aqui correspondem a esta revisão específica do Lumi. Outras versões podem alterar a interface e as opções. Copie os identificadores de modelo do serviço atual, em vez de tratar um menu antigo como catálogo.
Instale o Lumi e teste a busca de arquivos separadamente
Baixe a versão adequada na página de Releases do projeto. No macOS, abra o DMG e arraste o Lumi para Aplicativos; no Windows, há instalador e versão portátil. Se aparecer um aviso de assinatura ou segurança, confirme a origem do arquivo e a política da sua organização antes de continuar. Não desative as proteções gerais do sistema. Consulte as instruções de macOS e Windows.
O atalho padrão é Option mais a tecla física imediatamente à esquerda do 1 no macOS, ou Alt mais essa tecla no Windows. O símbolo impresso varia conforme o teclado. Para resolver um conflito, use Change na janela de boas-vindas. Os nomes de campos abaixo se referem à interface em inglês.
Pesquise um arquivo comum ou aplicativo que você sabe que existe e está indexado. Confira nome e caminho, selecione o resultado com as setas e pressione Enter para abrir. Option+Enter no macOS ou Alt+Enter no Windows mostra o arquivo selecionado no Finder ou no Explorador. Essa etapa não exige uma chave de API de modelo. No Mac, a busca usa o Spotlight; no Windows, usa atalhos do menu Iniciar para aplicativos e o Windows Search para arquivos. Se um arquivo não aparecer, confira o índice e o escopo de busca do sistema, não troque de modelo. Busca e atalhos
Entenda o que é enviado ao modelo
Abrir ou localizar um arquivo nos resultados não anexa automaticamente o documento à conversa. Mesmo que o índice encontre uma palavra no conteúdo, isso não equivale a enviar o texto do documento.
O caminho de API personalizada normalmente envia uma instrução de sistema, o histórico da conversa atual e a nova pergunta. Há uma exceção para os modelos lumi distribuídos para Ollama, que omite a instrução de sistema. A montagem da requisição não inclui automaticamente todos os resultados da busca nem conteúdos arbitrários de arquivos. Texto colado na pergunta, histórico anterior e o tratamento feito pelo serviço escolhido continuam exigindo atenção à privacidade. Montagem da requisição
As CLIs têm limites diferentes. O Claude é iniciado na pasta pessoal do usuário, com WebSearch,WebFetch definidos pelo Lumi. O Codex usa uma pasta dedicada, --sandbox read-only e uma instrução para não executar comandos nem ler arquivos. O Gemini usa outra pasta dedicada e --approval-mode plan. Pasta de trabalho, sandbox e instrução em texto são controles distintos: nenhum deles, isoladamente, comprova que o processo não lê outras configurações ou não acessa a rede. As CLIs mantêm autenticação e configuração próprias. No macOS, o ambiente do processo é herdado antes do ajuste de PATH; no Windows, as variáveis de autenticação também não são apagadas. Execução no macOS; execução no Windows
Escolha o caminho da requisição, não um vencedor por preço
| O que você já tem | Por onde começar | O que conferir |
|---|---|---|
| CLI instalada e acesso autorizado à conta | Claude, Codex ou Gemini CLI | Método de autenticação ativo e conta cuja cota ou cobrança muda |
| Pesos baixados para executar o modelo no computador | Servidor local Ollama ou LM Studio | Modelo carregado, máquina de execução e eventual encaminhamento à nuvem; hardware e energia também são recursos |
| Modelo externo específico e conta de API | Conexão de API personalizada | Endpoint, chave, identificador exato e consumo ou saldo dessa conta |
Essa é uma escolha de configuração, não um ranking de custo. Acesso por assinatura, consumo adicional medido e recursos computacionais locais não são a mesma despesa. Não conclua que uma opção é mais barata sem conferir todas as exigências aplicáveis de assinatura, uso e saldo.
CLI já instalada: confira a autenticação antes de selecioná-la
Configure apenas a CLI que pretende usar. Para o Claude, execute claude, conclua o login oficial e consulte /status na interface interativa. Atenção a ANTHROPIC_API_KEY: a documentação informa que, no modo não interativo -p, a chave é usada quando está presente; outros mecanismos de autenticação podem ter precedência superior. O Lumi inicia o Claude com -p. Portanto, ver uma assinatura na sessão interativa não basta para saber como a requisição do Lumi será cobrada. Confira o ambiente herdado pelo Lumi e o consumo resultante, sem exibir valores secretos. Precedência de autenticação do Claude
No Codex, use codex login e depois codex login status. A OpenAI diferencia login com ChatGPT para acesso por assinatura e chave de API para consumo medido. Confira também configurações existentes de provedor personalizado: o rótulo Codex no Lumi, sozinho, não identifica o serviço efetivamente usado. Autenticação do Codex
No Gemini, execute gemini e siga Sign in with Google quando esse for o método escolhido. Login Google, chave da Gemini API e Vertex AI são caminhos diferentes. A execução sem interface interativa pode reutilizar credenciais em cache; isso não a transforma automaticamente em uma assinatura específica. Autenticação do Gemini
Volte ao Lumi e escolha a CLI correspondente no menu de modelos. Depois de alterar a autenticação ou o ambiente de inicialização, feche e reabra o Lumi antes de verificar. As restrições de conta, região e organização do provedor continuam valendo. Nem o Lumi nem uma conexão de API separada eliminam as restrições de login de outro serviço.
Salve uma conexão de API local ou externa
Saia de qualquer resposta anterior e volte ao campo de entrada vazio antes de abrir Connect a model… no menu de modelos. Em Service, escolha Ollama, LM Studio ou Other address. Preencha Name, Address, Model e API key, clique em Connect e confirme que a conexão salva está selecionada no menu. Formulário de conexão
Address recebe a Base URL, não o endereço completo da pergunta. O Lumi acrescenta /chat/completions. Colar o endpoint inteiro duplica esse trecho. Name é apenas o nome que você dá à conexão; Model precisa ser um identificador exato aceito pelo servidor.
| Destino | Exemplo de Address | Modelo e chave |
|---|---|---|
| Ollama local | http://localhost:11434/v1 | Nome de um modelo local realmente baixado; o servidor local padrão não exige chave de API de nuvem |
| LM Studio local | http://localhost:1234/v1 | Identificador do modelo no LM Studio; informe a credencial do servidor se a autenticação estiver ativada |
| BetterToken personalizado | https://www.bettertoken.ai/v1 | Sua própria chave e um identificador atual copiado do catálogo de modelos ou de Key Setup |
Inicie o servidor Ollama ou LM Studio e prepare um modelo utilizável antes de testar. As portas acima são as dos exemplos oficiais; use a porta real caso tenha alterado a configuração. localhost identifica o primeiro destino da conexão, não garante onde toda a inferência acontece. Para trabalhar offline, confirme que os pesos são executados localmente e que o servidor não encaminha a pergunta para um modelo na nuvem. Compatibilidade do Ollama; servidor e API do LM Studio
O BetterToken é uma opção de conta de API, não um substituto para login de assinatura. Confira sua elegibilidade, crie uma chave na sua conta, siga as instruções atuais de configuração e verifique cota ou saldo e disponibilidade do modelo. YOUR_API_KEY e YOUR_MODEL_ID são exemplos de preenchimento, não credenciais utilizáveis. A chave real vai no campo protegido, nunca na pergunta, em capturas de tela ou em logs. A documentação informa atualmente a Rússia como região de atendimento; em outros locais, confirme antes com o serviço se sua conta é elegível.
A tabela de acesso para desenvolvedores na documentação do BetterToken indica https://www.bettertoken.ai/v1. Somando o sufixo usado pelo Lumi, o resultado é https://www.bettertoken.ai/v1/chat/completions, correspondente à documentação de Chat Completions. Isso é uma dedução do formato da requisição, não uma comprovação de teste completo com sua conta nem uma garantia de todas as funções de todos os modelos. Salvar uma conexão no Lumi não reescreve a configuração de provedor da CLI.
Valide uma resposta completa e o consumo correspondente
Comece uma conversa vazia, selecione a conexão desejada e pergunte: “Converta 2.5 polegadas em centímetros. Responda em uma frase, sem pesquisar na internet.” Envie com Cmd+Enter no macOS ou Ctrl+Enter no Windows, evitando que Enter abra um arquivo selecionado. Ask in ChatGPT, Cmd+Shift+Enter e Ctrl+Shift+Enter usam o navegador, não esse caminho de teste da API. Ações do teclado
Espere a resposta terminar. O resultado esperado é 6,35 centímetros. Com o campo de entrada vazio e nenhum texto selecionado, use Cmd+C ou Ctrl+C para copiar a resposta completa. Guarde-a de forma privada, com horário da requisição e nome da conexão, sem chave. Acertar a conta valida apenas o conteúdo: confira separadamente um resultado local visível, a resposta completa, o provedor/modelo real e o registro de consumo na conta correta.
Na API, compare os registros de requisição e uso dessa conta; o Dashboard do BetterToken mostra requisições, consumo de tokens e saldo. Na CLI, confira a cota da conta autenticada ou sua cobrança de API. Na inferência local, veja o registro de processamento do servidor e o modelo carregado, não uma cobrança de nuvem. Se houver apenas uso agregado, sem evidência do modelo por requisição, marque o modelo como não confirmado. Pedir que o próprio modelo se identifique não substitui essa verificação. Acompanhamento de uso no BetterToken
Identifique a falha antes de tentar novamente
Pressione Esc para interromper a resposta em andamento e Esc novamente para sair da tela de resposta ou erro. Nesta revisão, trocar de modelo depois de uma falha — ou pressionar Enter com o campo vazio — pode reenviar a pergunta anterior. Saia do estado de erro antes de mudar de conexão, para evitar envio involuntário da última pergunta a outro serviço. Interromper o cliente não prova que o servidor deixou de registrar consumo. Reenvio e comportamento de Esc
| Sintoma | Próxima verificação |
|---|---|
| Aplicativos aparecem, mas um arquivo não | Confira índice e escopo de busca do sistema; não troque a chave de API |
| CLI ausente ou erro de login | Resolva essa CLI pelo fluxo oficial no terminal e confira qual executável o Lumi encontra, sem reinstalar todas as ferramentas |
401 ou 403 | Leia a mensagem; separe problemas de credencial de restrições de rede, região ou organização |
404 ou modelo desconhecido | Remova uma duplicação de /chat/completions e confira o identificador exato e a preparação do modelo local |
429 ou erro de cota | Confira cota, saldo e orientação de limite de requisições; siga o servidor em vez de repetir em loop |
HTTP 200, mas saída vazia, parcial ou com erro | Confira o fluxo completo e o erro final; requisição aceita não significa resposta bem-sucedida |
O caminho de API trata explicitamente erros dentro do fluxo e respostas vazias. Ver algum texto aparecer não comprova a conclusão. Corrija um problema identificado, envie uma nova pergunta curta e repita as quatro verificações. Tratamento de erros
Antes de adotar a conexão no dia a dia, faça uma busca simples e uma pergunta inofensiva funcionarem, com o responsável pelo processamento e pela cobrança devidamente identificado.
