💬Sessões

Uma sessão é uma conversa do Claude Code rodando na pasta de um tópico. As sessões são persistentes: feche o navegador, reinicie o servidor, volte no mês que vem – a conversa continua de onde parou.

Layout

• Painel da esquerda: a árvore de projetos / tópicos. Emblemas mostram as sessões em andamento e as respostas não lidas.
• Área principal: uma ou mais colunas, cada uma com uma sessão. Abra várias sessões lado a lado, redimensione e reordene as colunas, ou destaque uma delas para uma janela própria.
• Grade: com duas sessões ou mais, o botão de grade no canto superior direito empilha as sessões de duas em duas por coluna (quatro sessões = 2x2). Você também pode soltar uma coluna na parte de baixo de outra, ou escolher Colocar abaixo da coluna da esquerda no menu … dela. Só a sessão em que você clicou mostra a caixa de mensagem completa; as outras mostram uma barra fina Escrever… - clique nela para escrever ali. Arraste a linha entre duas sessões empilhadas para dividir a altura (clique duplo: metade e metade). O mesmo botão, ou Dar uma coluna própria, coloca as sessões de volta lado a lado.
• Rolagem lateral (deslizar no trackpad, ou a roda do mouse entre as sessões) move as colunas; quando você solta perto da borda de uma sessão, a faixa desliza até ela.
• Layouts prontos: mantenha o botão do mouse pressionado na alça de uma sessão (os pontinhos à esquerda do título): pequenos layouts aparecem, clique na zona onde ela deve ficar (as outras preenchem o resto). Ou arraste a sessão pela alça: uma barra de layouts desce no topo das sessões, solte-a em uma zona. Deixe o ponteiro parado sobre o botão de grade para organizar todas as sessões abertas de uma vez. Pelo teclado: menu … > Layouts….
• Recolha a barra lateral com o botão na parte de baixo dela; recolha a árvore de sessões com o botão no canto superior esquerdo (um trilho fino permanece para reabri-la).
• Em um celular ou tablet (o layout de toque), uma sessão ocupa a tela toda e o app abre na última sessão. ☰ no canto superior esquerdo abre todas as suas sessões: um campo de busca, Nova sessão (no tópico da sessão que está na tela), os filtros Todas / Em andamento / Não lidas, depois seus projetos e tópicos. Pressione e segure uma sessão, um tópico ou um projeto para abrir o menu dele (renomear, favoritar, arquivar, excluir...). O botão de plano (ícone de lista de verificação) fica à direita do nome da sessão; o menu … da sessão também tem Notificações do Telegram. ⊞ no canto superior direito abre o resto do app (veja Configurações).

Mover uma sessão para outro tópico

Abaixo do título da sessão, o projeto / tópico é um botão: clique nele, digite para pesquisar, escolha outro tópico. Ou arraste a sessão na lista de sessões e solte-a em outro tópico (ou em qualquer sessão desse tópico) - é o mesmo movimento. Uma sessão que está trabalhando não pode ser movida até terminar; dentro do próprio tópico a ordem segue a ordenação da lista, então soltar ali não muda nada. A sessão vai para lá (a lista é atualizada) e o Claude continua a mesma conversa, agora trabalhando na pasta do novo tópico, com o contexto desse tópico. Só é possível depois que o Claude terminar (não durante um turno nem enquanto há mensagens esperando). A conversa dela no Telegram é renomeada. Os arquivos que ela criou ficam onde estão.

A lista de sessões

No topo da lista:

• Projetos / Sessões (o botão com dois ícones, o aceso é a visualização atual): clique para alternar.
• Projetos: as sessões agrupadas por projeto e tópico (o padrão).
• Sessões: todas as sessões em uma única lista, não importa o projeto, mais usadas primeiro: as sessões com as quais você mais conversou recentemente vêm primeiro (uma sessão longa usada esta semana antes de uma avulsa desta manhã; uma antiga vai descendo aos poucos). Uma linha cada: o título e o # tópico à direita; passe o mouse para ver projeto › tópico.
• Busca (a lupa): abre o filtro; digite para reduzir a lista, Esc ou × fecha.
• Novo projeto (a pasta com um +).

A barra na parte de baixo da lista:

1. Em Projetos, o layout - clique para alternar:

Em Sessões, o que aparece é a ordenação: mais usadas, atividade recente, A → Z, data de criação (clique para mudar). 2. Opções da lista (o ícone de controles deslizantes): marque os blocos Favoritos e Recentes para mostrá-los no topo da lista, e quantas sessões recentes mostrar (3, 5, 10 ou 20). O bloco Favoritos só aparece quando você tem um favorito.

• Emoji do projeto: o menu … de um projeto -> Definir um emoji… (uma lista de emojis comuns, ou digite / cole qualquer emoji). Ele aparece antes do projeto na lista e nos rótulos, e nas conversas dele no Telegram (🛒 acme/blog · Launch plan). Ele é salvo com a pasta do projeto (mantido ao renomear, na lixeira e no backup).
• Favoritos: adicione uma sessão pelo menu … dela (ou com o botão direito) -> Adicionar aos favoritos; o mesmo menu serve para remover. Uma estrela marca as sessões favoritas. Os favoritos são salvos no servidor: iguais no seu computador, no celular e no app instalado, e uma sessão continuada (cont.) continua favorita.
• Recentes: as sessões com atividade mais recente (um favorito não se repete ali enquanto Favoritos está sendo exibido).
• A visualização, o layout, a ordenação e os blocos ficam guardados neste navegador. A busca mostra todas as correspondências, não importa a visualização.

Iniciando uma sessão

Escolha um tópico, clique em Nova sessão, escreva sua mensagem. A sessão roda na pasta do tópico, então o Claude carrega automaticamente a memória do workspace, do projeto e do tópico (veja Memória).

O título é curto: o início da mensagem aparece de imediato, depois um título encurtado o substitui (saudações e "você pode…" removidos, cortado em uma palavra): "Tu vas me créer une session d'automatisation de E-ink" vira Créer une session d'automatisation. Com Títulos escritos pelo Claude ativado (Configurações -> Claude, desativado por padrão: uma chamada rápida ao menor modelo por nova sessão, contada no seu plano do Claude), o título passa a nomear o assunto - Automatisation E-ink - alguns segundos depois (se a chamada falhar, a mensagem é encurtada). O mesmo vale para uma sessão iniciada pelo Telegram (a conversa dela também é renomeada) e para uma sessão vazia na primeira mensagem. Um título que você digitou, uma conversa do Telegram que você nomeou, ou um nome alterado nesse meio-tempo, nunca é substituído. Desative em Configurações -> Claude (Títulos curtos de sessão): o título será então o início da primeira mensagem.

A caixa de mensagem

• Enter envia, Shift+Enter adiciona uma nova linha.
• Anexos: arraste e solte arquivos, cole uma imagem, ou use o clipe de papel. Os arquivos são salvos em <topic>/attachments/YYYY-MM/ e os caminhos deles são passados ao Claude. Com muitos arquivos, eles ficam em uma pequena faixa de duas linhas que rola (os mais novos à vista), para que a conversa mantenha seu espaço.
• Fila: você pode enviar enquanto o Claude ainda está trabalhando. As mensagens esperam em um cartão acima da caixa de mensagem, com o texto completo, e são enviadas uma após a outra; o × dele as apaga. O cartão mostra todas as mensagens em espera, também após recarregar a página ou em outro dispositivo; uma que veio do Telegram, de uma tarefa agendada ou do próprio Harness avisa isso antes do texto.
• Parar interrompe o turno em andamento.

Redirecionar enquanto o Claude trabalha. Uma mensagem enviada durante um turno espera na fila acima da caixa de mensagem. Clique em Redirecionar (no cartão de mensagens em espera) para usá-la imediatamente: o turno atual é interrompido, o Claude mantém tudo o que já fez (mesma conversa) e continua a tarefa levando em conta sua nova mensagem. Várias mensagens na fila são enviadas juntas. Editar devolve as mensagens em espera para a caixa de mensagem de imediato (anexos incluídos) para que você possa alterá-las antes de enviar de novo; se uma delas já começou nesse meio-tempo, só as outras voltam para a caixa de mensagem. O × do cartão também esvazia a fila de imediato (ela volta se o servidor recusar). Parar ainda cancela o turno e a fila.

Perguntar sem interromper. Pergunta (no mesmo cartão) envia as mensagens em espera como uma pergunta à parte: o Claude responde sobre a sessão - em que ponto está, por que fez algo, o que falta - sem interromper a tarefa. A resposta abre em um painel maior acima da caixa de mensagem; feche-o com o ×. Ela não é adicionada à conversa e o trabalho do Claude não é afetado (ele responde a partir de uma cópia da conversa, somente leitura).

Citar parte de uma resposta. Selecione um texto em uma das respostas do Claude (ou na resposta de uma pergunta à parte) e clique em Citar acima da seleção (abaixo dela em um celular). O texto vai para um cartão Citação acima da caixa de mensagem; cite várias passagens se quiser, e remova uma com o × dela (ou todas com o × do cartão). Ao enviar, as citações vão primeiro, como blocos de citação em Markdown (> …), seguidas do que você digitou - você também pode enviar só as citações. As citações são guardadas com o rascunho e mostradas como blocos de citação na sua mensagem.

O que você vê

• As respostas chegam em tempo real (markdown, código, imagens).
• As chamadas de ferramentas (ler arquivos, executar comandos, editar) aparecem como cartões compactos; expanda-os para ver a entrada e a saída. As edições são mostradas como diffs.
• Agentes e comandos em segundo plano: quando o Claude passa trabalho para um subagente, ou executa um comando em segundo plano, o cartão dele continua girando, com o tempo de execução, até que esse trabalho realmente termine (✓ concluído, ✗ falhou, ⊘ parado ou interrompido). Expanda-o para ver em que ponto está: a última ação, as ferramentas e os tokens usados até agora, e depois o relatório do agente quando terminar. Enquanto algum ainda estiver rodando, uma pílula acima da caixa de mensagem avisa (2 agentes em execução): clique nela para listá-los, clique em um para ir até o cartão dele. Tudo volta como estava após recarregar a página ou perder a conexão.
• Diagramas: para explicar como algo funciona, o Claude pode desenhar um pequeno diagrama (um fluxograma, uma sequência, os estados de algo...) direto na resposta. Clique nele para abri-lo no visualizador de arquivos como uma imagem (zoom, tela cheia, ← / → com os outros arquivos da conversa, Código-fonte para ver o código); passe o mouse para ver Mostrar o código e Copiar. No Telegram ele chega como código.
• Gráficos do Git: quando o Claude fala de um repositório, ele mostra o gráfico real das branches e dos commits (lido ao vivo); clique em um commit para ver os arquivos. Veja Git e GitHub.
• Imagens e vídeos citados em uma resposta aparecem como miniaturas abaixo dela (clique para abrir), e os arquivos de áudio como um pequeno player que você pode tocar ali mesmo (o nome dele abre o visualizador de arquivos); o áudio que você envia toca do mesmo jeito. As miniaturas acompanham os arquivos: quando o Claude reescreve uma imagem com o mesmo nome, a nova versão aparece assim que a ferramenta termina (também no visualizador e no HUD).
• Clique com o botão direito em uma imagem, um vídeo, um anexo ou um caminho de arquivo (pressione e segure no Android): Abrir, Baixar, Citar (adiciona o arquivo à sua próxima mensagem como uma linha com o caminho - o Claude só o lê se precisar, a imagem não ocupa o contexto) e Copiar caminho.
• Os caminhos de arquivo são clicáveis e abrem o visualizador de arquivos: ← / → percorrem todos os arquivos da conversa (veja Arquivos).
• O cabeçalho mostra o modelo que de fato respondeu, o custo e um medidor de contexto (o quanto a janela de contexto do Claude está cheia, medido em relação à janela real do modelo em uso - ele acompanha quando você troca de modelo).
• Uma linha abaixo de cada resposta mostra o modelo, o tempo que levou, o custo, os tokens (entrada → saída) e a parcela da entrada servida pelo cache. Passe o mouse (ou toque) em qualquer um deles para ver o que significa: a contagem de tokens separa entrada sem cache, leituras de cache, gravações de cache e saída.
• Sobre o custo: é o que a resposta custaria nos preços da API da Anthropic, calculado pelo Claude Code. Com login por assinatura do Claude (Pro / Max) ele não é cobrado - só mostra o quanto você usou; com login por chave de API ele é cobrado na sua conta da Anthropic. A dica na tela informa qual caso se aplica ao seu servidor.
• Escolha o que a linha mostra: clique na ⚙ no final dela (aparece ao passar o mouse; sempre visível em telas de toque), ou Configurações → Geral → Linha abaixo de cada resposta. A escolha vale para todos os dispositivos; ocultar o custo também oculta o total da sessão no cabeçalho.

Modo plano

Com o modo plano ativado, o Claude não altera nada antes de você concordar. Ele lê e explora o que precisa, depois responde com um plano: objetivo, etapas, arquivos envolvidos, riscos e perguntas em aberto. Neste modo, ele não pode gravar arquivos nem executar comandos que modifiquem alguma coisa.

• Ative-o com o botão de plano (ícone de lista de verificação) no cabeçalho da sessão, ou marque Modo plano quando você iniciar uma nova sessão. A caixa de mensagem mostra um chip Modo plano (clique nele para sair).
• Quando o turno termina, uma linha fina Plano pronto aparece no topo da caixa de mensagem (as mensagens em espera tomam o lugar dela enquanto houver alguma):
• Ajustar (ou simplesmente escreva): diga o que deve mudar - o Claude envia o plano atualizado. Repita quantas vezes quiser.
• Validar: publica Plano validado - pode seguir., o modo plano é desativado e o Claude executa a versão mais recente do plano.
• ×: sai do modo plano sem executar o plano.
• O HUD mostra o plano como resposta e tem um botão Validar o plano.
• O modo plano vale para todas as mensagens da sessão, inclusive as do Telegram; valide o plano pelo app web ou pelo HUD. Compactar e passar adiante continuam funcionando normalmente.

Modo Maxxing

Para muitas sessões ao mesmo tempo: assim que uma termina, ela vem para a frente para você digitar o que vem a seguir na hora.

Beta, desativado por padrão. Primeiro ative-o para a instalação em Configurações -> Recursos -> Modo Maxxing (beta): o interruptor, a barra e o atalho abaixo só aparecem depois disso (desativá-lo ali o encerra em todos os navegadores).

• Ative-o com ⚡ Maxxing no canto superior direito da página Sessões (Alt+M), ou ⚡ no cabeçalho de uma sessão em um celular. A configuração pertence a este navegador.
• A sessão que vem para a frente substitui as outras colunas na tela: ela fica sozinha na faixa, em largura total. Suas colunas não se perdem: desativar o modo Maxxing as coloca de volta.
• Uma sessão que termina seu turno (ou cujo plano está esperando, ou que parou por um erro) entra em uma fila. A primeira ocupa a largura toda (ela desliza para onde estava a anterior), a caixa de mensagem dela recebe o foco e ela brilha por um instante; em um celular ela abre em tela cheia.
• Você nunca é interrompido: enquanto a sessão da frente espera seu prompt, ou enquanto você digita em qualquer caixa de mensagem, as próximas esperam. A seguinte vem logo depois que você enviar. ⏭ N em espera mostra a fila; clique nele para deixar a sessão da frente como está e ir para a próxima. ⏮ (Voltar) traz de volta a sessão que você acabou de deixar (um prompt enviado rápido demais: pare-o ou edite-o ali); ela fica na frente até você enviar algo para ela de novo, até ela terminar ou até você seguir em frente, e a sessão que estava na frente volta para o início da fila.
• Nada para fechar à mão: uma sessão por vez, e, ao desativar, seu arranjo anterior volta (mais a sessão que está na tela). Os rascunhos continuam salvos na própria sessão.
• A barra líquida ao lado (sempre se movendo suavemente, do verde ao laranja) é um jogo: nos últimos 10 minutos, 70 % é o tempo em que suas sessões trabalharam em vez de esperar por você, 30 % é a rapidez com que você respondeu (meta de 30 s). Mais rápido que isso e ela transborda, até 110 %. Passe o mouse para ver os detalhes; ela fica neste navegador e recomeça ao recarregar a página.

Modo HUD

Uma pequena barra flutuante para conduzir uma sessão enquanto você trabalha em outros apps. Ative-o em Configurações → Recursos → Modo HUD, depois clique no botão HUD no cabeçalho de uma sessão (ou Abrir o HUD no menu dela).

• Enquanto o Claude trabalha, ela mostra seu prompt e as três últimas etapas do Claude (ferramentas, raciocínio). Quando termina, mostra a resposta com as imagens dela - uma de cada vez, ‹ › para percorrê-las; um clique abre o arquivo no app. A seta ao lado do botão de enviar a recolhe em uma barra fina (só as etapas) e a expande de novo.
• Enter envia; durante um turno a mensagem espera na fila e Redirecionar a envia na hora. O botão quadrado para o turno.
• Compartilhar minha tela (o ícone de tela): escolha uma tela ou uma janela uma vez; a partir daí uma captura é anexada a cada mensagem que você enviar pelo HUD, para que o Claude veja o que você vê. Quando ajuda, o Claude responde com uma cópia da captura anotada (setas, caixas) para mostrar onde olhar. A captura geralmente vai direto ao Claude junto com sua mensagem, então ele vê sua tela desde o primeiro passo. As capturas são salvas junto com os anexos da sessão (<topic>/attachments/). Clique no ícone de novo, ou use o Parar compartilhamento do navegador, para parar.
• No topo: Voltar ao app traz a janela principal para a frente, × fecha o HUD; passe o mouse sobre a resposta para copiá-la.
• No Chrome e no Edge a barra fica por cima de todos os apps e pode ser movida para qualquer lugar, inclusive para uma segunda tela, e fecha junto com a aba do app. Os outros navegadores a abrem em uma pequena janela própria.
• O HUD só conversa com o Claude: ele não controla seu computador. Não está disponível em celular.

Modelos

Cada sessão pode usar seu próprio modelo (menu no cabeçalho da sessão). Vazio = o modelo padrão de Configurações -> Claude. O rótulo sempre mostra o modelo que realmente respondeu ao último turno; se ele for diferente da sua escolha, um marcador avisa. Cada modelo tem seu próprio cache de prompt: em uma sessão com mais de 50k tokens de contexto, a troca pergunta antes, porque o novo modelo lê a conversa inteira uma vez sem cache (Compacte antes para tornar a troca barata).

Compactar vs. passar adiante

Quando uma conversa fica longa, o contexto se enche e as respostas ficam mais lentas e mais caras.

Compactação automática (Configurações -> Claude, 400k tokens por padrão): quando um turno termina com mais contexto que o limite, o Harness compacta a sessão sozinho antes da sua próxima mensagem - uma nota na conversa avisa. As sessões longas deixam então de reenviar todo o histórico a cada chamada, o que reduz aproximadamente pela metade os tokens que usam. Escolha um limite maior (ou Desativada) para uma sessão que precisa de todos os detalhes de uma troca muito longa. Um único turno longo (muitas chamadas de ferramentas em sequência) também é compactado pelo caminho, perto do mesmo limite, em vez de crescer até o limite do modelo. maxxing sessions token-report mostra, nas suas próprias sessões, o que cada limite teria economizado.

Compactar quando você voltar (Configurações -> Claude, 200k tokens por padrão): o Claude guarda o início de uma conversa em cache por alguns minutos (até uma hora). Quando você escreve em uma sessão que ficou parada por mais tempo e tem pelo menos essa quantidade de contexto, o cache se foi e todo o histórico seria reenviado a preço cheio - então o Harness resume a sessão antes (uma nota diz "De volta após 2 h: ...") e sua mensagem roda em uma nova conversa iniciada com o resumo. Você espera um turno de resumo antes da resposta; todos os turnos seguintes ficam muito menores. Mensagens de tarefas agendadas nunca o disparam, nem uma sessão cujo contexto é em sua maior parte o que toda nova conversa carrega de qualquer jeito (CLAUDE.md, memória): resumi-la não economizaria nada. Escolha Desativada para manter a conversa inteira, qualquer que seja a pausa. Parar durante o resumo cancela só o resumo, sua mensagem permanece: ela roda logo depois, na conversa completa.

Editar ou excluir uma mensagem que ficou sem resposta

Uma mensagem que você interrompeu antes de o Claude responder (mostra Interrompida. abaixo dela) pode ser corrigida ou removida. Clique com o botão direito nela (pressione e segure no Android), ou use os botões ao lado da hora dela (sempre visíveis no celular): - Editar (lápis): o texto, as citações e os anexos dela voltam para a caixa de mensagem (antes do que você já tinha digitado), e a mensagem sai da conversa. Corrija e envie de novo. - Excluir esta mensagem (lixeira): ela sai da conversa junto com a linha "Interrompida."; Desfazer no aviso a traz de volta.

Só a conversa mostrada aqui muda: o que o Claude já recebeu continua na memória própria dele sobre a sessão.

Iniciar uma nova sessão a partir de uma mensagem

Clique com o botão direito em qualquer mensagem (pressione e segure no celular) - sua, mesmo já respondida, ou uma resposta do Claude - e escolha Nova sessão a partir desta mensagem: uma nova sessão do mesmo tópico abre com a mensagem já na caixa (uma resposta vem como citação). Leia, altere se quiser e envie. Copiar está no mesmo menu. Um trecho de texto selecionado mantém o menu do próprio navegador (e o botão Citar), um arquivo mantém o menu dele (Abrir, Baixar, Citar, Copiar caminho).

Notificar, arquivar, excluir

• Notificar (sino): quando um turno termina, uma mensagem curta é publicada na conversa do tópico no Telegram.
• No navegador: Configurações -> Notificações -> Avisar-me quando uma sessão terminar mostra uma notificação do sistema quando a aba está em segundo plano (um pequeno banner com Abrir caso contrário), com um sinal sonoro opcional. Um turno que falhou também é notificado; as tarefas agendadas não. Testar verifica se funciona neste navegador. As respostas não lidas mostram um contador redondo verde na barra lateral, no botão ☰ e na árvore; ele pode pulsar até você lê-las (Emblema pulsante). Clique em um contador - em andamento ou concluído, na barra lateral ou em um projeto / tópico da árvore - e a árvore de sessões mostra só essas sessões, expandidas. Abrir tudo as abre ao lado das colunas já abertas; × traz de volta a árvore inteira (digitar uma busca também). O próprio link Sessões traz de volta o seu último layout.
• Arquivar oculta uma sessão da lista sem excluí-la (veja o filtro Arquivadas).
• Excluir interrompe um turno em andamento e remove os arquivos da sessão.

Busca

Ctrl/⌘+K (ou a barra de busca no topo da barra lateral) é a busca única do app. Ela encontra:

• sessões, pelo título e pelo que você e o Claude escreveram;
• a memória (memory.md, CLAUDE.md), as tarefas (título, notas, etiquetas) e o conteúdo dos arquivos de texto do workspace (markdown, código, configuração…), além dos nomes de arquivos e pastas. Todo memory.md / CLAUDE.md é sempre encontrado; em um workspace muito grande cada tópico recebe sua parte justa dos outros arquivos, e os arquivos de dados (.json, .csv, .xml, .svg) ficam de fora. Os arquivos novos aparecem em até 10 minutos, a memória na hora;
• páginas, configurações, tópicos e ações.

Digite algumas palavras em qualquer ordem: cada palavra pode ser o início de uma palavra ("fact" encontra "facture"), os acentos não importam, e as melhores correspondências vêm primeiro, com as palavras encontradas destacadas. Uma mensagem pode ser pesquisada um segundo depois de escrita; os arquivos editados, em até meio minuto.

Sessões do Telegram e dos crons

As conversas do Telegram e as tarefas cron do Claude criam sessões normais (marcadas com a origem delas). Uma sessão do Telegram pode ser continuada pela interface web e vice-versa.

Atalhos de teclado

Bom saber

• Cada turno roda em sua própria unidade do systemd (maxxing-<id>): ele sobrevive a uma reinicialização do servidor.
• O Claude Code guarda as transcrições por ~10 anos (cleanupPeriodDays está definido como 3650), então as sessões antigas sempre podem ser retomadas. Se uma transcrição estiver faltando, um novo contexto do Claude é iniciado automaticamente e uma nota é exibida.

Fechar tudo / Abrir tudo (layout Vertical): o botão rápido na parte de baixo da lista de sessões recolhe todos os projetos e tópicos assim que algo está aberto, e expande tudo quando tudo está recolhido.