Existe uma cena que até pouco tempo parecia improvável: abrir o terminal do celular e ver um agente de inteligência artificial criar arquivos e alterar um projeto inteiro, sem computador por perto.
Este guia separa o que funciona hoje do que é promessa de fórum, com versões conferidas em 2026. São quatro rotas, nenhuma oficial.
A Anomaly mantém instaladores para macOS, Linux e Windows, e nada para Android. Quem quer o agente no bolso depende de build comunitário, de um chroot com proot-distro ou de uma arquitetura em que o celular é só tela.
O que é o OpenCode e por que ele não tem app para Android
O projeto é um agente de código aberto, com licença MIT e mais de 200 mil estrelas no GitHub. Ele roda no terminal como interface TUI, e também como app de desktop ou extensão de IDE.
A independência de provedor é o principal atrativo. Você conecta Anthropic, OpenAI, Google, OpenRouter ou um modelo local e escolhe o modelo por sessão, sem ficar preso a um fornecedor só.
No Android, o obstáculo é a distribuição. O pacote opencode-ai no npm não carrega binário único: baixa o executável da plataforma por dependências opcionais. Na versão 1.19.5, são doze pacotes, nenhum para Android.
A linha 2 repete o padrão. O pacote @opencode/cli, na versão 2.2.1, declara os: darwin, linux, win32 nos metadados do npm, então a geração que trocou o CLI isolado por serviço em segundo plano também ficou fora.
No rastreador de issues, o assunto está encerrado. A issue 21043 descreve o lançador confundindo Termux com Linux e tentando rodar binário x64 em aparelho arm64. Foi fechada como não planejada em 3 de julho, e o pull request 21106 caiu sem merge.
O pedido de versão mobile, issue 10288, aparece como concluído desde 20 de outubro, embora o pull request que o resolveria siga fechado.
- Não existe app oficial de OpenCode para Android nem para iOS
- O npm não publica binário Android em nenhuma das duas linhas
- A issue que descreve a falha dentro do Termux foi fechada sem correção
- A saída prática é build de terceiro, chroot ou acesso remoto
Vídeo mostra a instalação do build comunitário no Termux e a primeira sessão rodando no celular
Os caminhos reais para rodar o OpenCode no Android
O build nativo do projeto opencode-termux instala um binário aarch64 dentro do Termux, sem camada de compatibilidade, e é a opção mais próxima de um app. A instalação é mais longa que a dos vídeos, que usam um repositório comunitário de scripts.
A segunda rota é o npm install -g opencode-ai dentro do Termux, que aparece nos tutoriais e funcionou na gravação do OffensiveTech. A terceira monta um Debian com proot-distro e instala o pacote Linux normal no chroot.
A quarta é não instalar nada no aparelho e controlar por navegador uma instância que roda em outra máquina, combinação que muita gente acha mais confortável.
| Caminho | Onde roda | Versão disponível | Custo | Funciona offline |
|---|---|---|---|---|
| Build nativo | Termux aarch64 | 1.17.9 estável; OpenCode 2 em pré-release | Grátis, MIT | Sim |
| npm no Termux | Termux | Depende do aparelho | Grátis | Sim |
| proot-distro | Chroot Debian ou Ubuntu | Versão atual do npm | Grátis | Sim |
| Servidor remoto | Outra máquina, via navegador | A instalada lá | Grátis ou VPS | Não |
A escolha depende de uma pergunta: você precisa que o agente rode no aparelho ou basta que ele responda na tela? A resposta define se você vai brigar com o Termux ou apenas abrir um endereço.
Instalação nativa no Termux com o build da comunidade
O opencode-termux, mantido por guysoft, compila o agente e o runtime Bun para Android aarch64. O trabalho é pesado: a linha estável compila uma versão corrigida do Bun, com WebKit/JavaScriptCore, do zero.
A instalação mais direta usa o gerenciador de pacotes. No Termux, você baixa o arquivo .pkg.tar.xz da última release, instala com pacman -U e roda opencode. Existe equivalente em .deb e uma versão em zip.
curl -LO https://github.com/guysoft/opencode-termux/releases/latest/download/opencode-aarch64.pkg.tar.xz
pacman -U opencode-*.pkg.tar.xz
opencode
O pacote puxa o ripgrep como dependência, que o agente usa para varrer o projeto. A release estável é a v0.2.1, de 25 de junho, que empacota o OpenCode 1.17.9, uma diferença real em relação à 1.19.5 do npm.
A linha nova vem separada. O pacote opencode2, a partir da v1.0.3, traz o OpenCode 2 sobre o alvo Android do Bun e se instala ao lado do antigo, ainda em pré-release.
Um dos defeitos corrigidos derrubava o binário na inicialização. A política seccomp do Android intercepta a chamada close_range e mata o processo com Bad system call, saída 159, agora tratada como erro comum.
A rota com Node.js que os tutoriais mostram
O caminho mais repetido nos vídeos é atualizar os pacotes do Termux, instalar Node.js e Git e usar o gerenciador de pacotes do Node para pôr o OpenCode no sistema. A sequência é curta, o que explica a popularidade.
pkg update && pkg upgrade
pkg install nodejs git
npm install -g opencode-ai
opencode
O ponto frágil é o binário que o lançador escolhe. Sem dependência opcional para Android no npm, o resultado depende do ambiente: em alguns aparelhos a interface sobe, em outros o erro é de binário incompatível.
Se falhar, não insista na mesma instalação. Mude de rota, porque o defeito está no lançador e não na configuração do seu aparelho, e repetir o comando vai devolver exatamente a mesma mensagem de erro.
O vídeo do canal OffensiveTech faz esse caminho do começo ao fim, com uma preocupação que merece repetição. A chave de API colada no terminal é credencial da sua conta, com cobrança por token.
Tutorial instala Node.js no Termux, conecta o OpenRouter e cria um script de senhas com o agente
Depois de conectar o provedor, o teste do vídeo é um script em Python que gera senhas com tamanho ajustável. É pequeno de propósito, e o autor avisa que projeto grande exige teste e correção.
Se você quer só testar código no celular, um IDE como o Pydroid 3 resolve o roteiro de Python sem montar Termux. Para editar arquivos do projeto com syntax highlight, o Acode é leve e abre pasta local.
Primeira sessão: modelos grátis, screen e o assassino de processos
Abrir o agente é só metade do trabalho. A primeira resposta costuma demorar um ou dois minutos, porque o runtime carrega as bibliotecas do Android e reserva memória. Depois disso, as respostas saem em segundos.
Na interface, a tecla Tab alterna entre os agentes de planejamento e de construção, e o comando /model abre a lista de modelos. Existem opções de acesso gratuito, como as dos vídeos, e opções pagas com modelos mais fortes.
O custo não está no agente, que é gratuito: está no provedor do modelo. Modelo gratuito tem limite de uso e pode sair do ar, então vale ter uma segunda opção configurada.
O problema seguinte é o Android encerrando o processo quando você troca de app. Instalar screen e rodar o agente dentro de uma sessão resolve parte do incômodo: sai com Ctrl+A e D, volta com screen -r e encontra tudo como deixou.
Vale somar o termux-wake-lock, que impede o sistema de dormir com o Termux aberto. Ainda assim existe o assassino de processos fantasma do Android 12 em diante, que mata processo em segundo plano com sinal 9.
Controlar o OpenCode do celular pela rede
Essa é a rota que menos depende de sorte. O agente nasceu como servidor com cliente TUI, e o comando opencode serve expõe uma API HTTP com especificação OpenAPI no endereço /doc.
opencode serve --port 4096 --hostname 0.0.0.0
OPENCODE_SERVER_PASSWORD=senha-forte opencode web
opencode attach http://192.168.0.10:4096
O --hostname 0.0.0.0 libera o acesso pela rede local, e o OPENCODE_SERVER_PASSWORD protege a porta com autenticação básica, cujo usuário padrão é opencode. Sem senha, qualquer aparelho na mesma rede abre seus projetos.
Fora da rede local, o caminho seguro é túnel ou VPN, nunca abrir a porta para a internet. A versão 2 encurtou o processo com opencode pair, que imprime um link de uso único, válido por cinco minutos e que morre sozinho depois disso.
Demonstração conecta o navegador do celular ao servidor local do OpenCode, com modelo rodando em llama.cpp
O vídeo do canal Ciprian Turcu mostra a montagem com um modelo local no llama.cpp e contexto de 128 mil tokens, apontando o servidor para o IP da máquina.
Para quem já mantém uma máquina ligada, essa é a combinação mais confortável, e o celular só precisa de um cliente SSH decente como o Termius. Quem prefere editar arquivos no aparelho pode usar o Editor de Código.
O que dá errado quando a IA mexe em APK
Um dos vídeos do lote não é sobre instalar o agente, e sim sobre o que ele faz com um APK. A demonstração usa o REAndroid, ferramenta que roda no Termux com Jadx e APKTool, e pede ao agente que modernize a interface de um app de teste.
Reconstrução de APK no Android com REAndroid e agente de IA, usando apenas um app de teste
O alerta do próprio autor é o ponto mais importante. O teste usa um app que ele mesmo criou, e a recomendação é fazer isso apenas com aplicativos próprios ou com autorização de quem detém os direitos.
Tem também um limite técnico que o vídeo deixa claro. APK não carrega o projeto original, então a IA não recupera o código-fonte: ela trabalha sobre Smali e recursos extraídos, e o resultado depende do que sobrou ali.
Função que depende de serviço ausente não volta por mágica. E clonar app alheio para redistribuir é violação de direito autoral, não atalho de desenvolvimento.
Perguntas frequentes
Dá para rodar OpenCode no Android sem root?
Sim. Todas as rotas deste guia funcionam em aparelho sem root, incluindo o build nativo e o chroot com proot-distro. O root não é requisito em nenhuma delas.
A ferramenta é gratuita?
A licença é MIT e não existe cobrança pelo software em si. O que custa é o modelo: você paga o provedor por token, ou usa o acesso gratuito quando ele existe e aceita o limite de uso, que muda sem aviso.
Qual versão devo instalar?
Para uso diário, a estável do build comunitário, que hoje é a 1.17.9. Para testar recurso novo, a linha opencode2, ciente de que é pré-release e pode quebrar sem aviso.
Rodar o agente no Android ainda é território de quem aceita ler mensagem de erro. O build comunitário resolve a arquitetura, a rota remota resolve a confiabilidade, e nenhuma das duas é oficial.