Documentação / Primeiros passos

Instalar o Yuli

Baixe gratuitamente o IDE para Windows, macOS ou Linux de 64 bits e abra-o pela primeira vez.

BETAYuli Code 0.0.78 (BETA) · 19 de outubro de 2026

O instalador desta versão será publicado muito em breve.

O Yuli é instalado no seu computador e trabalha localmente: só a IA que você escolher se conecta à internet. É gratuito e não pede conta.

O Yuli está em Beta. Se algo falhar, use Ajuda → Relatar um problema… e compartilhe no GitHub: cada relato nos ajuda a aprimorá-lo.

Requisitos do sistema

Requisito Detalhe
Sistema operacional Windows, macOS ou Linux, 64 bits.
Para projetos JVM Java, Maven, Gradle ou Ant. O Yuli os detecta e oferece baixar o que estiver faltando.

Só para algumas ferramentas

O Yuli avisa se algo estiver faltando e explica como instalar.

Para É necessário
Oracle Oracle Instant Client 19c ou posterior. SQL Server, MySQL, MariaDB, MongoDB e SQLite não precisam de nada extra.
Contêineres Docker e, para Kubernetes, kubectl com um contexto configurado.
Desenvolvimento remoto por SSH Cliente OpenSSH.
Modo assinatura Seu próprio Claude Code, Kiro CLI, Codex CLI ou servidor ACP do Antigravity, instalado por você.

Download

O botão desta página detecta o seu sistema e leva você à última versão publicada. Você também pode escolher outro formato.

Sistema Formatos
Windows x64 Instalador .exe, .zip e portátil Yuli-Code-Portable-<versión>-x64.exe.
macOS .dmg e .zip.
Linux x64 .AppImage e .deb.

Instale

Windows

  • Instalador: execute o .exe. Você pode escolher a pasta de instalação; ele cria atalhos na área de trabalho e no menu Iniciar.
  • Portátil: execute Yuli-Code-Portable-<versión>-x64.exe de onde quiser, sem instalar. Na primeira vez, ele descompacta o aplicativo na sua pasta local; nas seguintes, inicia instantaneamente.
  • Zip: descompacte-o em qualquer pasta e execute o Yuli a partir dela.

A versão portátil não se atualiza sozinha. Para ter as atualizações automáticas, use o instalador.

macOS

Abra o .dmg e arraste o Yuli para Aplicativos.

Linux

  • AppImage: dê permissão de execução (chmod +x no arquivo) e abra-o.
  • Debian e Ubuntu: instale o .deb com o seu gerenciador de pacotes (sudo apt install ./archivo.deb).

Primeira inicialização

  1. Boas-vindas. Aparece “Bem-vindo ao Yuli Code” com o essencial do IDE.
  2. Idioma. O Yuli usa o idioma do seu sistema, se estiver disponível; caso contrário, inglês. Altere quando quiser. Veja Idiomas.
  3. Como você quer conectar a IA? Escolha Com a sua assinatura (Claude Code, Kiro, Codex ou Antigravity; é a opção padrão) ou Com a sua API key. Você pode Pular e decidir depois.
  4. Tela inicial. Sem nada aberto, o editor oferece quatro caminhos: Pedir algo à IA, Abrir um arquivo, Desenhar uma tela e Executar e testar.

Para ver as boas-vindas novamente, use Ajuda → Configuração inicial…. Para um tour guiado de sete passos, Ajuda → Tour e configuração inicial….

Confiança do projeto

Na primeira vez que você abre um projeto, o Yuli pergunta “Você confia neste projeto?”:

  • Confiar: executa os processadores de anotações (Lombok) e o Maven/Gradle do projeto para uma análise completa.
  • Modo restrito: não executa código do repositório.

Escolha Confiar apenas com projetos que você conhece. Você pode alterar isso em Opções globais → Segurança. Veja Sandbox e permissões.

Atualizações

O instalador procura atualizações ao iniciar, faz o download e as aplica ao fechar. Cada download é verificado com sua assinatura e sua soma SHA-512. Configure o canal (estável ou beta) e a busca automática em Ajuda → Procurar atualizações….

Desinstalar

  • Windows: em Configurações → Aplicativos, ou apague a pasta da versão portátil ou do zip.
  • macOS: arraste o Yuli de Aplicativos para a lixeira.
  • Linux: apague o AppImage ou desinstale o pacote.

Suas configurações ficam na pasta .yulicode do seu usuário; apague-a se quiser começar do zero.