Instalar o Foxl

Primeiro, baixe o Foxl na página Download. Esta página mostra como instalar.

O que você precisaCopiar link da seção

• macOS: macOS 13 (Ventura) ou posterior, num Mac com Apple Silicon (M1 ou posterior) ou Intel.
• Windows: Windows 10 ou posterior, 64 bits.
• Linux: um sistema de 64 bits (x86-64) com FUSE, que o AppImage precisa para rodar.

Você não precisa instalar mais nada. O Foxl traz o próprio runtime de servidor (Bun no macOS e no Linux, Node.js no Windows).

Procurando o app para celular? O de iOS está na App Store, e o de Android é instalado direto por um APK: veja Apps para celular.

macOSCopiar link da seção

1. Abra o arquivo .dmg que você baixou.
2. Arraste o Foxl para a pasta Aplicativos.
3. Abra o Foxl pela pasta Aplicativos.
4. Na primeira vez, o macOS pode perguntar se você tem certeza. Clique em Abrir.

O download para Mac é uma versão universal: funciona em Macs com Apple Silicon e com Intel. Se você usa o Homebrew, brew install --cask foxl-ai/tap/foxl instala a mesma versão, e o cask é atualizado a cada lançamento.

WindowsCopiar link da seção

Instalador: execute o Foxl-latest-setup.exe e siga os passos. Ele instala o Foxl e cria um atalho na área de trabalho. Esta é a versão que se atualiza sozinha.

Portátil: baixe o Foxl-latest-portable.zip, descompacte e execute o Foxl.exe. Nada é instalado.

Se o Foxl já estiver aberto, ele continua rodando enquanto você passa pelo instalador, e também se você cancelar. Ele só é fechado quando você clica em Instalar. Quando o Foxl está instalado só para você, o instalador pergunta antes de fechá-lo. Quando há uma versão mais antiga instalada para todos os usuários, e durante uma atualização automática, o Foxl é fechado sem perguntar.

LinuxCopiar link da seção

1. Torne o arquivo executável: chmod +x Foxl-latest.AppImage
2. Execute: ./Foxl-latest.AppImage

Se ele parar com dlopen(): error loading libfuse.so.2, está faltando o FUSE 2 no seu sistema, que o Ubuntu 22.04 e posteriores não instalam mais por padrão. Execute sudo apt install libfuse2 (no Ubuntu 24.04 o pacote é libfuse2t64) e tente de novo.

A primeira vez que você abre o FoxlCopiar link da seção

1. Entre com Google, Apple, GitHub ou seu e-mail (com um link mágico, ou com uma senha, se você tiver definido uma). O seletor de idioma abaixo das opções de login define o idioma do Foxl antes de você entrar, e a sua escolha continua valendo depois.
2. Uma configuração rápida aparece por cima do app. Escolha o seu visual: claro, escuro ou sistema, e um de dezenove temas de cor. Fale ao Foxl sobre você: sua função e o seu nível técnico, em três cartões (todos os detalhes técnicos, os conceitos sem os detalhes internos, ou linguagem simples). Nada é obrigatório: Continuar funciona sem nada escolhido, e Ignorar tudo ou a tecla Escape fecham a configuração a qualquer momento.
3. Configurar o Foxl Notes (app para desktop). Uma única tela, com todas as linhas opcionais:
   • Num Mac com Apple Silicon, Rodar o Notes neste Mac (num PC com Windows ou num computador Linux x64, Rodar o Notes neste computador) instala juntos o mecanismo de voz no dispositivo e o Gemma, cerca de 6,5 GB (só a parte que falta no seu computador). A linha mostra quanto falta, pode ser pausada e continua em segundo plano depois que você avança. Um computador que já consegue transcrever e resumir mostra Pronto no lugar. Em outros computadores, a linha Transcrição de reuniões oferece uma chave da AssemblyAI, ou mostra Pronto quando o computador já consegue transcrever. Quando o computador já tem uma chave do Gemini para o chat (em Configurações > Modelo e provedor), a linha oferece Usar Gemini em vez de pedir uma segunda chave.
   • Microfone e Áudio de outros apps: Permitir mostra o pedido de permissão do sistema, e a linha passa a mostrar Permitido. O Windows pede só o microfone, e o Linux grava só o microfone.
   • Tradução ao vivo: fica desligada, a menos que você ative, junto com o idioma para o qual traduzir.
4. Traga sua configuração. Só aparece quando o Foxl encontra no computador uma configuração do Claude Code ou do Codex com algo que o Foxl ainda não tem: instruções, habilidades e servidores MCP, com tudo o que é novo já marcado. Importar traz o que estiver marcado (as instruções são adicionadas ao final do AGENTS.md do Foxl), e nada que o Foxl já tem é substituído; Continuar sem nada marcado não traz nada. A mesma importação fica disponível depois em Configurações > Avançado.
5. Conecte um modelo. Num computador em que nada consegue responder a um chat ainda, a última tela ajuda você a conectar um: o OpenRouter, outro provedor ou, num Mac com Apple Silicon, Rodar IA neste Mac (Rodar IA neste computador no Windows e no Linux; quando Rodar o Notes neste Mac já ofereceu esse download, esta tela não oferece de novo, mas mostra o progresso do download se você pressionou Instalar lá). Um computador que já consegue conversar, com credenciais da AWS, um login do Claude Code ou do ChatGPT, o Ollama ou uma chave de provedor, não vê esta tela. Veja Primeiros passos.
6. Um tour rápido aponta para Agendamentos, Agentes e Chat; no app para macOS e Linux, para o ponto verde na barra de título (ele abre um painel de status com o que está rodando, os tokens e o custo do chat e o que resta do seu plano ou dos seus créditos); e no app para desktop, para as configurações de Modelo e provedor. Na primeira vez que você abre o Foxl Notes, um tour curto mostra os controles principais, e na primeira vez que você abre as Configurações, outro mostra alguns recursos que só existem ali (a extensão do Chrome, o uso do computador num Mac, Ditado em qualquer app e, num Mac ou num PC com Windows, Continuar em execução ao fechar), terminando em conectar uma agenda ao Foxl Notes.

Numa instalação nova, o Foxl não avisa quando um agendamento ou um agente termina; ele continua avisando quando um deles falha, quando um dispositivo se conecta e quando algo precisa da sua resposta. Se quiser esses avisos, ative Tarefa Concluída em Agendamentos ou Agente, em Configurações > Notificações. Um computador que já usava o Foxl mantém as notificações como estavam.

No Windows, a configuração também mostra Iniciar o Foxl ao fazer login, ativado, ao lado de Continuar. O Foxl só entra nos apps que abrem quando você faz login se você sair da configuração com essa opção ativada. Você pode mudar isso depois em Configurações > Geral > Iniciar ao fazer login.

Quer ver a configuração de novo? Configurações > Aparência tem Mostrar a configuração de novo e, logo abaixo, Redefinir a introdução, que recomeça a configuração da sua conta quando você está conectado: ela roda mais uma vez, no primeiro dos seus dispositivos que você abrir. Concluir ou pular a configuração em um dispositivo conectado à conta conclui a configuração em todos eles. Os apps para celular pulam essa configuração e vão direto para o app, a menos que você peça por ela lá, com Mostrar a configuração de novo, ou que uma redefinição peça por ela; no celular, a tela de visual pede então só Claro, Escuro ou Sistema. No app.foxl.ai, o primeiro login de uma conta nova mostra as telas de visual e sobre você e o tour; as telas do Notes, de Traga sua configuração e de Conecte um modelo existem só no app para desktop.

Windows e Linux: a bandeja, a janela e os menusCopiar link da seção

• O ícone da bandeja abre a janela. No Windows, clique ou clique duas vezes no ícone do Foxl na bandeja do sistema para trazer a janela de volta. No Linux, um clique abre a janela onde o ambiente de desktop permitir. No macOS, um clique no ícone da barra de menus abre o menu dele.
• Fechar a janela. No Windows, fechar a janela mantém o Foxl rodando, com ou sem o ícone na bandeja (Mostrar na bandeja do sistema, em Configurações > Geral). No Linux, depende dessa opção: com o ícone na bandeja ativado, o Foxl continua rodando (na primeira vez, uma notificação avisa isso e explica como voltar); com ele desativado, fechar a janela encerra o Foxl.
• Os menus seguem o idioma do app, tanto a barra de menus quanto o menu da bandeja. Logo depois de uma instalação nova, eles ficam em inglês até a janela do Foxl carregar uma vez.
• No Linux, a barra de menus fica oculta até você pressionar Alt. Atalhos como Ctrl+Q funcionam de qualquer jeito.
• Ctrl+R não recarrega o app. Exibir > Recarregar continua no menu, sem atalho, e no terminal o Ctrl+R continua indo para o shell. No macOS, o Cmd+R não mudou.
• Fixar na barra de tarefas do Windows. O Foxl roda com a mesma identidade de app do atalho no menu Iniciar, que o Windows usa para as notificações e para agrupar um Foxl fixado com a janela dele. A inicialização ao fazer login usa essa identidade também, então o Foxl não abre duas vezes quando você faz login. Um atalho fixado a partir da janela do Foxl na versão 0.7.36 ou anterior é movido para essa identidade pouco depois que o Foxl abre. Se você ainda vir dois botões do Foxl, desafixe o Foxl e fixe de novo.

Claro, escuro e a janelaCopiar link da seção

O Foxl segue a configuração de modo claro ou escuro do seu sistema. Para escolher você mesmo, abra Configurações > Aparência; a mesma página tem dezenove temas de cor e quinze superfícies (veja Aparência). Sua escolha vale para o app para desktop, o app.foxl.ai e os apps para celular.

No macOS 26 (Tahoe) e posteriores, a moldura externa da janela é translúcida, então a sua área de trabalho aparece atrás da barra lateral, enquanto o conteúdo continua sólido. As versões mais antigas do macOS, o Windows e o Linux usam uma janela sólida comum.

AtualizaçõesCopiar link da seção

O Foxl procura atualizações sozinho e as instala quando você sai do app.

Se uma atualização não consegue terminar (algo ainda estava usando o app), o Foxl avisa na próxima vez que abrir, no sino e nas Configurações, e oferece tentar de novo.

Atualizações betaCopiar link da seção

Em Configurações > Geral, na seção Atualizações, a chave Atualizações beta traz as versões beta assim que saem, uma versão à frente de todo mundo.

• Uma beta é o mesmo Foxl, assinado do mesmo jeito, na sua conta e com os seus dados de sempre. Só o app está adiantado.
• Quando a versão estável correspondente sai, você passa para ela automaticamente.
• Desligar a chave mantém você na versão atual até essa versão estável chegar. Ela nunca faz você voltar para uma versão anterior.
• As betas são publicadas como pré-lançamentos, então, com a chave desligada, nenhuma beta é oferecida a você, e os links de download sempre levam à versão estável.

Precisa de ajuda?Copiar link da seção

Veja Solução de problemas ou pergunte na nossa comunidade no Discord.