Instalação

Windows

1. Baixe o instalador:

   https://contextcodedev.iaforged.com/downloads/ContextCode-Setup.exe

2. Execute ContextCode-Setup.exe e siga o assistente (é um instalador NSIS padrão: avançar, avançar, instalar).

3. Ao terminar, abra o Context Code pelo menu Iniciar. Você verá a tela de abertura com o logo e o lema “Crie sem limites”.

Nota

O Context Code usa o WebView2 da Microsoft, que já vem incluído no Windows 11 e na maioria das instalações atualizadas do Windows 10. Se o seu Windows não tiver, o próprio Windows oferece como atualização.

O instalador do Windows: poucos cliques e pronto.

macOS

1. Baixe a imagem de disco:

   https://contextcodedev.iaforged.com/downloads/ContextCode.dmg

2. Abra com dois cliques e arraste o Context Code para a pasta Aplicativos.

3. Abra o app pelo Launchpad ou pela pasta Aplicativos.

Nota

O app é assinado com Developer ID e notarizado pela Apple, então abre sem avisos de segurança e sem precisar mexer no Terminal. Se alguma versão antiga pedia para executar xattr -cr, isso não é mais necessário.

Requer macOS 13 (Ventura) ou posterior em um Mac com Apple Silicon (M1, M2, M3, M4…).

Linux

Existem dois formatos:

• .deb — recomendado para Ubuntu, Debian, Mint e derivados. Instale com o apt apontando para o arquivo (o ./ é obrigatório; assim as dependências se resolvem sozinhas):

  sudo apt install ./context-code-desktop_<versión>_amd64.deb
  context-code-desktop

  Cuidado

  Não use sudo dpkg -i puro: ele não resolve dependências e pode deixar o pacote instalado pela metade em um sistema recém-instalado.

• .AppImage — universal, funciona em qualquer distribuição x86_64 moderna (Fedora, Arch, openSUSE, Manjaro…). Não precisa instalar: basta dar permissão de execução e abrir.

  chmod +x context-code-desktop_<versión>_amd64.AppImage
  ./context-code-desktop_<versión>_amd64.AppImage

Linux Server (sem tela)

Para um servidor ou um VPS sem ambiente gráfico, o instalador de uma linha:

curl -fsSL https://contextcodedev.iaforged.com/downloads/install.sh | bash

Instala o .deb, verifica a soma SHA-256 e oferece fazer login. Para atualizar, o mesmo comando. Depois, por SSH:

contextcode chat                       # o agente no terminal
contextcode serve --print-qr --public  # acesso web/celular com QR

Todo o detalhe está em Context Code pelo terminal.

Android

O APK é baixado na página de downloads, onde há um QR code para instalá-lo direto pelo celular. Como não vem da Play Store, o Android vai pedir permissão uma vez: toque em Configurações, ative «Permitir desta fonte» para o seu navegador, volte e toque em Instalar. A permissão fica concedida só para esse app.

Requisitos

• Windows: Windows 10/11 de 64 bits com WebView2 (incluído no Windows 11).
• macOS: macOS 13 (Ventura) ou posterior, em um Mac com Apple Silicon.
• Linux: distribuição com webkit2gtk 4.1 — Ubuntu 22.04+, Debian 12+ ou equivalente. O .AppImage é a opção mais portátil (no Ubuntu 22.04+ instale também o libfuse2).
• Android: Android 6 ou posterior.
• Você não precisa instalar Node, Rust nem nenhuma ferramenta de desenvolvimento: o instalador já traz tudo. Desde a 3.6.0 isso inclui o motor da conversa em tempo real — o agente de voz, o servidor e os modelos —, então esse modo funciona logo após instalar e sem conexão com a internet.
• Para usar modelos na nuvem você vai precisar de uma conta do provedor escolhido; para modelos locais, quanto mais RAM (e GPU) você tiver, maiores os modelos que poderá rodar.

Depois de instalar

O próximo passo é conectar um provedor de IA e abrir seu primeiro projeto: continue em Seu primeiro chat.

App para celular (opcional)

O Context Code tem um app para celular que se pareia com o seu PC lendo um QR code. Os detalhes estão em App para celular.