App open-source para o Claude Code

O Claude Code é o agente que o Happier consegue executar dentro da interface de terminal do próprio agente, em vez de à frente dela. Ative o runtime de terminal unificado e o Happier arranca a verdadeira TUI do claude num host de terminal partilhado, transmite essa sessão para os seus dispositivos e escreve nela diretamente o que enviar a partir da app — para que uma correção possa entrar no turno que já está a decorrer, em vez de esperar pelo fim dele. É o próprio terminal da Anthropic que aceita a correção, e o Happier está a segurar-lhe o teclado; é um arranjo diferente de falar com um runner sobre uma sessão, e é a razão por que esta página existe.

O runtime predefinido é o do Agent SDK e, para a maioria das sessões, é o indicado. Retoma uma conversa, lista as sessões do Claude Code nesse computador, consegue levar o estado do fornecedor para um segundo computador e, quando um limite de utilização o trava, consegue ir perguntar se o limite já foi de facto levantado, em vez de o deixar a adivinhar. O que não faz é levar uma mensagem para um turno que já está a decorrer: a Anthropic documenta a entrada em streaming do Agent SDK como mensagens em fila, processadas sequencialmente, com a possibilidade de interromper. Escolher entre os dois runtimes altera esse comportamento e mais nada sobre onde vive o seu código.

O início de sessão continua a ser o fluxo da Anthropic, começado a partir de onde estiver. A página do fornecedor Claude Code executa claude no computador que escolheu e envia-lhe /login, para que o passo do navegador aconteça no computador que vai guardar a credencial e não no telemóvel que tem na mão. O Happier procura o binário onde o instalador da Anthropic o coloca — ~/.local/bin, a diretoria com versão dentro de ~/.local/share/claude, um prefixo do Homebrew, ~/.claude/local/cli.js — antes de se oferecer para lhe mostrar um comando de instalação, porque na maioria dos computadores já lá está.

O Claude Code é o agente de programação em terminal da Anthropic: executa claude num repositório e ele lê ficheiros, edita-os e corre comandos. O Happier não altera nada disso. happier claude arranca o mesmo binário, na mesma diretoria, com o mesmo início de sessão, e espelha a conversa para todos os dispositivos onde tem sessão iniciada.

O que ganha com isso é poder afastar-se. Comece uma refatoração à secretária, leia o diff no telemóvel a caminho do almoço, responda ao pedido de permissão em que ele parou e retome a sessão no seu terminal quando voltar a sentar-se. O repositório fica no computador onde já estava.

Orientar e interromper não são o mesmo gesto, e o Claude Unified trata do primeiro. Interromper para o turno e começa outro; orientar acrescenta ao turno que está a decorrer. A Anthropic documenta a entrada em streaming do Agent SDK como mensagens em fila, processadas sequencialmente, com a opção de interromper — que é aqui o runtime predefinido, e é o indicado para a maioria das sessões. O terminal do próprio Claude Code aceita a outra forma: escreva enquanto ele trabalha e a instrução junta-se ao trabalho em curso. O Unified conduz esse terminal, para que a app o possa fazer a partir de um telemóvel.

De qualquer das formas, é um só processo do Claude Code. No modo unificado, o terminal e a app estão ativos ao mesmo tempo — pode estar a escrever na TUI no computador enquanto a sessão é respondida a partir de um telemóvel, e nenhum dos dois fica de fora. É isso que “unificado” significa aqui: um processo, uma transcrição, dois sítios de onde pode escrever nele.

As aplicações iOS e Android, a aplicação de desktop para macOS, Windows e Linux, e o app.happier.dev são todos clientes sobre o processo Claude Code que corre no seu computador — não espelhos apenas de leitura. Responda a um pedido de permissão, envie a instrução seguinte, percorra o repositório, leia o diff. A transcrição é encriptada de ponta a ponta antes de sair do seu computador, por isso o servidor que a transporta guarda texto cifrado.

O Happier instala-se no computador que já guarda o seu repositório, e happier claude inicia lá o Claude Code como um subprocesso normal, no diretório para onde o apontar, com a sessão iniciada da forma como a iniciou. Não há gateway nenhum entre o agente e a Anthropic, nem cópia nenhuma do seu código em mais lado nenhum.

O Happier procura claude no seu PATH e corre a cópia que instalou. A Anthropic distribui-o com um script de instalação em vez de um pacote; o Happier pode mostrar-lhe esse comando, e não executa um script de instalação do fornecedor por iniciativa própria — as receitas de fornecedores são recusadas a menos que as permita explicitamente.

O guia de instalação e login da própria Anthropic está em code.claude.com/docs/en/setup. O Happier não o espelha, porque uma cópia das instruções de instalação de outra pessoa é uma cópia que fica desatualizada.

Referência de configuração do lado do Happier — Claude Code na documentação do Happier.

O Claude Code é um dos agentes que o Happier consegue apontar para uma credencial conectada uma única vez, em vez da conta em que aquele computador está logado. Ele aceita a Claude subscription or an Anthropic API key.

Os serviços conectados são indexados pela credencial, não pelo agente, então o mesmo Claude subscription pode ser selecionado para qualquer agente que o aceite, em todos os computadores que você conectou — o que também é o que torna útil um pool das suas próprias contas em mais de um deles. A credencial é criptografada e descriptografada nos seus próprios dispositivos; a página da documentação traz as regras por perfil, porque quais tipos de perfil cada agente aceita é exatamente o tipo de detalhe que muda entre versões.

O Claude Code é um de 13 agentes de programação de linha de comandos que o Happier corre, e todos partilham uma lista de sessões, uma caixa de entrada de permissões, um conjunto de atalhos de teclado e uma configuração MCP.

You define an MCP server once and Claude Code receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

Isso conta sobretudo nos dias em que está a correr mais do que um: sessões de fornecedores diferentes lado a lado, e um toque numa notificação a abrir a sessão que levantou o pedido em vez da porta de entrada da aplicação. A lista completa está aqui.

Escrever happier claude num terminal inicia a sessão mesmo onde está, e a mesma sessão está na aplicação ao mesmo tempo. O que lê nessa shell é a apresentação que o próprio Happier faz da sessão — a transcrição, os pedidos de permissão, a saída das ferramentas — e não a interface do Claude Code. Ninguém tem de abdicar do terminal para ter um cliente de telemóvel.

Quando você quiser a TUI do próprio Claude Code, happier attach <session-id> no computador dono da sessão a entrega para você dentro do tmux, com o histórico já ali. No runtime padrão essa entrega é exclusiva: enquanto o terminal está com a sessão, uma mensagem enviada pelo app espera na fila em vez de ser digitada por baixo de você, e sai quando você devolve o controle. O runtime de terminal unificado é o outro arranjo: um único processo do Claude Code em um host de terminal compartilhado, gravável pelo terminal e pelo app ao mesmo tempo.

O guia de attach lista os casos em vez de prometer todos eles.

Um comando no computador que guarda o seu código, e depois happier claude no repositório em que quer trabalhar.

Os passo a passo estão nos guias. Tudo isto tem licença MIT, e o relay é um que pode correr você mesmo.