Ajuda

O que é o Claude Code Helper?

O Claude Code Helper é um visualizador de ambiente de trabalho para as sessões do Claude Code guardadas na sua própria máquina. Ele encontra-as — no Windows e dentro do WSL — lista-as num único local pesquisável e renderiza cada conversa como um chat legível e exportável.

O Claude Code mantém as suas sessões anteriores em locais de armazenamento ocultos e específicos da máquina, divididos em vários sítios: um armazenamento do Windows e um separado dentro de cada distribuição WSL (Windows Subsystem for Linux) em que executa o Claude. Não há uma forma integrada de navegar ou reler nenhuma delas. Esta aplicação é a porta de entrada: ela mostra essas sessões de cada armazenamento, etiqueta cada uma com a sua origem, une automaticamente as metades do título e da transcrição, e mostra cada conversa como um chat limpo que pode pesquisar, copiar e guardar — sem nunca tocar nos originais.

Há quatro coisas que pode fazer com ele: navegar pelas suas sessões, ler uma transcrição, guardar ou partilhar uma transcrição e ajustar algumas definições.

Navegar pelas suas sessões

O painel esquerdo lista todas as sessões do Claude Code encontradas nesta máquina, as mais recentes primeiro. Cada entrada mostra o título da sessão, a pasta do projeto em que foi executada, a última vez que a focou e um distintivo da sua origem. Clique numa entrada para abrir a sua transcrição à direita.

Sessões e transcrições

Uma sessão é uma conversa do Claude Code. A sua transcrição é o registo completo de tudo o que foi dito e feito nela. Estas duas coisas são armazenadas separadamente na sua máquina: o título da sessão e os detalhes básicos residem num local, e a própria transcrição reside noutro. A aplicação lê ambos e associa-os por um ID de sessão partilhado, para que a lista e a conversa legível se juntem como uma só.

Nunca gere isto sozinho. Importa por apenas uma razão: uma sessão é listada apenas quando a sua transcrição pode realmente ser encontrada. Se o Claude Code removeu uma transcrição antiga (ele as limpa após algum tempo), não há nada para ler, então essa sessão simplesmente não aparece na lista em vez de ser mostrada como uma entrada vazia.

De onde vem uma sessão — o distintivo de origem

Cada entrada possui um pequeno distintivo de origem que indica onde essa sessão reside fisicamente:

Windows — a sessão foi executada com o Claude Code no Windows.
Um nome de distribuição (por exemplo, Ubuntu) — a sessão foi executada dentro desse ambiente Linux WSL. O Claude Code mantém um armazenamento completamente separado dentro de cada distribuição WSL, e a aplicação lê todos eles.

A mesma máquina pode facilmente conter ambos os tipos ao mesmo tempo, em armazenamentos que não têm nada a ver uns com os outros. O distintivo indica-lhe a que mundo uma entrada pertence à primeira vista. Apenas as distribuições WSL que estão atualmente em execução são verificadas — as sessões de uma distribuição parada aparecem assim que a inicia.

Acima da lista, aparece um chip de origem por armazenamento — Windows primeiro, depois cada distribuição em execução. Cada chip contém uma contagem e alterna essa origem para ligada ou desligada, para que possa focar a lista, por exemplo, apenas nas suas sessões WSL e ocultar as do Windows (Mostrar ou ocultar sessões desta origem).

Sessões Ativas, Arquivadas e Perdidas

Cada sessão enquadra-se numa de três categorias, cada uma com o seu próprio chip de filtro e uma contagem em tempo real acima da lista:

Ativo — uma sessão normal e atual.
Arquivado — uma sessão que arquivou no Claude. Ainda é totalmente legível aqui; a etiqueta apenas reflete o seu estado.
Perdidas — uma transcrição do Windows que não tem uma entrada correspondente no Claude Desktop. Como a entrada é o que normalmente contém o título, uma sessão perdida não tem título armazenado, então a aplicação recupera um da primeira mensagem na conversa. Sem isto, uma sessão perdida não teria título para ser listada e seria invisível.

Os três chips mostram ou ocultam cada categoria enquanto procura uma conversa, e as suas contagens refletem as origens atualmente mostradas. Uma entrada que foi recuperada desta forma também possui uma etiqueta Perdida própria — leia-a como "o título aqui foi reconstruído, não o original".

A aplicação nunca altera as suas sessões

O Claude Code Helper apenas lê as suas sessões — nunca as escreve, renomeia ou apaga. Copiar e exportar criam novo texto na área de transferência e novos ficheiros; os originais são deixados exatamente como estavam.

Isto é importante porque estes ficheiros são dados de trabalho ativos para o próprio Claude Code. Um visualizador que os alterasse poderia corromper uma sessão. Assim, pode navegar e exportar livremente sem qualquer risco para o Claude.

A única ressalva: não edite manualmente o ficheiro subjacente de uma sessão (por exemplo, aquele que alcança com Show transcript file in folder) enquanto o Claude estiver a usar ativamente essa sessão — isso é editar dados em tempo real sem o conhecimento do Claude, o que é diferente de qualquer coisa que esta aplicação faça.

Filtrar a lista

Comece a digitar na caixa de filtro acima da lista para a restringir. O filtro corresponde tanto ao título da sessão quanto ao caminho do projeto, para que possa encontrar uma sessão pelo seu assunto ou pela pasta em que foi executada. Um botão de limpar aparece na caixa para a apagar com um clique e ver tudo novamente. Os chips de origem e categoria descritos acima restringem então o que o filtro de texto deixa.

Filtrar por título ou caminho… — a caixa de filtro; restringe a lista a entradas cujo título ou caminho do projeto contenha o que digita.
Limpar filtro — limpa a caixa de filtro.

Atualizar a lista

A lista é lida uma vez quando a aplicação abre. Se iniciar ou continuar sessões no Claude Code enquanto a aplicação já está em execução — ou iniciar uma distribuição WSL que estava parada antes — use o controlo de atualização no topo da lista para reler os armazenamentos e trazer as novas sessões.

Atualizar lista — relê os armazenamentos de sessões para que as sessões criadas (ou distribuições iniciadas) desde que a aplicação abriu apareçam.

Ler uma transcrição

Escolha uma sessão e a sua conversa preenche o painel direito.

Como uma transcrição é apresentada

A transcrição é apresentada como um chat. As suas mensagens ficam à direita. As respostas do Claude preenchem a largura à esquerda. O trabalho da ferramenta que o Claude fez ao longo do caminho aparece como blocos dentro das suas respostas. Tudo é renderizado a partir de Markdown — títulos, listas, código e imagens são todos exibidos corretamente — para que um registo bruto da máquina seja lido como a conversa que realmente teve.

Blocos de ferramentas — uma chamada dobrada com o seu resultado

Sempre que o Claude usou uma ferramenta, duas coisas aconteceram: enviou um pedido e obteve um resultado. A aplicação dobra esse par num único bloco recolhível. Clique no bloco para o abrir — o pedido aparece em cima, o resultado em baixo — e clique novamente para o fechar.

Os pedidos e resultados das ferramentas são volumosos, por isso estes blocos começam fechados, permitindo-lhe ler a conversa sem ter de percorrer detalhes da máquina. Quando quiser ver exatamente o que uma ferramenta fez, abra o que lhe interessa. (Pedidos ou resultados muito longos são cortados para que uma sessão grande continue a ser rápida de renderizar.)

Expandir ou recolher todos os detalhes da ferramenta

O controlo de expandir tudo na barra de ferramentas da transcrição abre ou fecha todos os blocos de ferramentas na transcrição atual com um clique — útil quando quer ter a imagem completa, ou quer dobrar tudo de volta para uma leitura rápida. Ainda pode abrir e fechar blocos individuais clicando neles.

Expandir ou recolher os detalhes da ferramenta — abre ou fecha todos os blocos de ferramentas na transcrição atual de uma só vez.

Uma sessão inteira, uma única resposta ou uma tabela podem sair da aplicação. Três controlos na barra de ferramentas da transcrição pegam na transcrição inteira — copiam-na para a área de transferência, guardam-na como um ficheiro ou abrem o original no disco — e mais dois estão na própria conversa, aparecendo quando passa o rato sobre a parte que deseja.

Como é o Markdown exportado

Tanto Copiar como Markdown quanto Exportar como arquivo Markdown produzem a mesma coisa: um documento Markdown autônomo de toda a conversa. Cada turno recebe um cabeçalho, e o trabalho da ferramenta é escrito em linha. Quaisquer imagens que Claude recebeu ou produziu são incorporadas diretamente no documento, para que ele permaneça completo por si só — ele abre, renderiza e pesquisa em qualquer editor ou aplicativo de notas, sem a necessidade deste visualizador.

Um turno aparece formatado assim:

### User

Can you rename the helper function and update its callers?

### Claude

Done — renamed it and updated the two call sites.

### Tool result

(the file edits Claude made, shown inline)

Os cabeçalhos (### User, ### Claude, ### Tool result) fazem parte do próprio documento exportado, para que sejam lidos claramente mesmo longe deste aplicativo.

Copiar como Markdown

Coloca toda a transcrição na sua área de transferência como Markdown, pronta para colar diretamente em notas, um chat ou um editor.

Copiar como Markdown — copia toda a transcrição para a área de transferência como Markdown.

Copiar uma das respostas de Claude

Por vezes, só quer uma resposta, não a conversa inteira. Passe o rato sobre qualquer uma das respostas de Claude e um botão de copiar aparece logo abaixo; ao clicar nele, essa única resposta é colocada na sua área de transferência como Markdown, formatada exatamente como seria numa exportação completa. O botão confirma com uma marca de verificação por um momento, para que saiba que funcionou.

Isto é oferecido apenas nas respostas de Claude — as suas próprias mensagens já são texto que escreveu e são abrangidas pela cópia de transcrição completa acima.

Copiar resposta como Markdown — copia essa única resposta para a área de transferência como Markdown.

Copiar uma tabela

As tabelas são a parte de uma resposta que mais frequentemente se deseja noutro local — uma comparação, uma lista de definições, um conjunto de resultados. Passe o rato sobre qualquer tabela numa transcrição e um botão de cópia aparece no canto superior direito.

Copia a tabela em duas formas ao mesmo tempo, e a aplicação onde cola escolhe a que entende:

Cole numa folha de cálculo, num processador de texto ou num editor de documentos e obterá uma tabela real — as linhas e colunas chegam intactas, não como uma parede de texto.
Cole num editor de texto simples e obterá linhas separadas por tabulações, que a maioria dos editores e ferramentas de dados lê como colunas.

Não precisa de fazer nada para escolher entre elas; ambas viajam juntas numa única cópia.

Copiar tabela — copia a tabela sobre a qual está a pairar.

Exportar como ficheiro Markdown

Abre uma caixa de diálogo de guardar para que escolha onde o ficheiro .md vai e qual o seu nome. Use-o para arquivar uma sessão ou entregá-lo a outra pessoa.

Exportar como ficheiro Markdown — guarda a transcrição num ficheiro Markdown à sua escolha.

Mostrar o ficheiro de origem na sua pasta

Abre o seu gestor de ficheiros com o ficheiro de transcrição original da sessão selecionado. Use-o quando quiser o próprio ficheiro — para fazer uma cópia de segurança, inspecioná-lo ou apontar outra ferramenta para ele. (Lê-lo e copiá-lo é seguro; editá-lo enquanto Claude está a usar essa sessão não é — veja A aplicação nunca altera as suas sessões.)

Mostrar ficheiro de transcrição na pasta — abre o ficheiro de transcrição original no seu gestor de ficheiros, selecionado.

Definições

Abra as definições a partir do botão na barra superior. Existem dois separadores: Ecrã para idioma e tema, e Sobre para a versão da aplicação.

Abrir definições — abre a caixa de diálogo Definições (idioma, tema e versão da aplicação).

Idioma

Escolha o idioma da interface na lista. A sua escolha é lembrada da próxima vez que abrir a aplicação.

Idioma — escolhe o idioma da interface.

Tema

Escolha uma interface clara ou escura. A escolha aplica-se imediatamente e é lembrada.

Tema — alterna entre a interface Claro e Escuro.

Notificações de atualização

Quando a aplicação é iniciada, verifica silenciosamente se uma versão mais recente foi lançada. Se houver uma, aparece um banner no topo com um link para as notas de lançamento e um botão de download. Apenas informa — nunca instala nada por si só.

Tem três formas de lidar com o banner:

Transferir — abre a página para obter a nova versão.
Dispensar — esconde o banner para esta execução; pode voltar no próximo lançamento.
Ignorar esta versão — esconde o banner até que uma versão ainda mais recente seja lançada, para que não seja lembrado novamente sobre esta.
Novidades — abre as notas de lançamento para a nova versão.

Se estiver offline, já atualizado ou tiver ignorado a versão anunciada, nenhum banner aparece.

Outros controlos

GitHub — abre o repositório de código-fonte da aplicação no GitHub no seu navegador.
Ajuda — abre esta página de ajuda no seu idioma atual.