Ajuda

O que é o Claude Code Helper?

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

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

Há quatro coisas que você faz com ele: navegar pelas suas sessões, ler uma transcrição, salvar ou compartilhar uma transcrição e ajustar algumas configurações.

Navegue 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 você a focou e um selo indicando sua origem. Clique em uma entrada para abrir sua transcrição à direita.

Sessões e transcrições

Uma sessão é uma conversa do Claude Code. Sua transcrição é o registro completo de tudo o que foi dito e feito nela. Essas duas coisas são armazenadas separadamente na sua máquina: o título da sessão e os detalhes básicos ficam em um lugar, e a própria transcrição fica em outro. O aplicativo lê ambos e os associa por um ID de sessão compartilhado, para que a lista e a conversa legível se unam como uma só.

Você nunca gerencia isso sozinho. Isso importa por apenas uma razão: uma sessão é listada apenas quando sua transcrição pode ser realmente encontrada. Se o Claude Code removeu uma transcrição antiga (ele as limpa depois de um tempo), não há mais 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 selo de origem

Cada entrada possui um pequeno selo de origem informando 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 o aplicativo lê todos eles.

A mesma máquina pode facilmente conter ambos os tipos de uma vez, em armazenamentos que não têm nada a ver um com o outro. O selo informa a qual mundo uma entrada pertence rapidamente. Apenas as distribuições WSL que estão atualmente em execução são escaneadas — as sessões de uma distribuição parada aparecem assim que você a inicia.

Acima da lista, um chip de origem aparece por armazenamento — Windows primeiro, depois cada distribuição em execução. Cada chip exibe uma contagem e alterna essa origem para ligada ou desligada, para que você 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 se enquadra em uma das três categorias, cada uma com 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 você arquivou no Claude. Ela ainda é totalmente legível aqui; a tag apenas reflete seu status.
Perdidas — uma transcrição do Windows que não possui 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 o aplicativo recupera um da primeira mensagem na conversa. Sem isso, 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 você procura por uma conversa, e suas contagens refletem as fontes atualmente exibidas. Uma entrada que foi recuperada dessa forma também possui uma tag Perdida própria — leia-a como "o título aqui foi reconstruído, não o original".

O aplicativo nunca altera suas sessões

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

Isso é importante porque esses arquivos são dados de trabalho ativos para o próprio Claude Code. Um visualizador que os alterasse poderia corromper uma sessão. Assim, você pode navegar e exportar livremente sem nenhum risco para o Claude.

A única ressalva: não edite manualmente o arquivo subjacente de uma sessão (por exemplo, aquele que você acessa com Mostrar arquivo de transcrição na pasta) enquanto o Claude estiver usando ativamente essa sessão — isso é editar dados ativos pelas costas do Claude, o que é diferente de qualquer coisa que este aplicativo faça.

Filtrar a lista

Comece a digitar na caixa de filtro acima da lista para restringi-la. O filtro corresponde tanto ao título da sessão quanto ao caminho do projeto, para que você possa encontrar uma sessão pelo seu assunto ou pela pasta em que foi executada. Um botão de limpar aparece na caixa para apagá-la em um clique e ver tudo novamente. Os chips de origem e categoria descritos acima então restringem 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 contém o que você digita.
Limpar filtro — limpa a caixa de filtro.

Atualizar a lista

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

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

Ler uma transcrição

Escolha uma sessão e sua conversa preencherá o painel direito.

Como uma transcrição é exibida

A transcrição é apresentada como um chat. 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 de suas respostas. Tudo é renderizado a partir de Markdown — títulos, listas, código e imagens são exibidos corretamente — então um registro bruto da máquina é lido como a conversa que você realmente teve.

Blocos de ferramentas — uma chamada dobrada com seu resultado

Sempre que o Claude usava uma ferramenta, duas coisas aconteciam: ele enviava uma solicitação e recebia um resultado de volta. O aplicativo dobra esse par em um único bloco recolhível. Clique no bloco para abri-lo — a solicitação aparece em cima, o resultado abaixo — e clique novamente para fechá-lo.

As solicitações e resultados das ferramentas são volumosos, então esses blocos começam fechados, permitindo que você leia a conversa sem se aprofundar nos detalhes da máquina. Quando você quiser ver exatamente o que uma ferramenta fez, abra o que lhe interessa. (Solicitações ou resultados muito longos são truncados para que uma sessão grande permaneça rápida para renderizar.)

Expandir ou recolher todos os detalhes da ferramenta

O controle 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 você quer a imagem completa, ou quer dobrar tudo de volta para uma leitura rápida. Você 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 do aplicativo. Três controles na barra de ferramentas de transcrição pegam a transcrição inteira — copiam para a área de transferência, salvam como um arquivo ou abrem o original no disco — e mais dois ficam na própria conversa, aparecendo quando você passa o mouse sobre a parte desejada.

Como o Markdown exportado se parece

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 inline. 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 a transcrição inteira na sua área de transferência como Markdown, pronta para colar diretamente em notas, um chat ou um editor.

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

Copiar uma das respostas de Claude

Às vezes, você quer apenas uma resposta, não a conversa inteira. Passe o mouse sobre qualquer uma das respostas de Claude e um botão de copiar aparecerá logo abaixo dela; clicar nele coloca essa única resposta na sua área de transferência como Markdown, formatada exatamente como estaria em uma exportação completa. O botão confirma com um visto por um momento, para que você saiba que funcionou.

Isso é oferecido apenas nas respostas de Claude — suas próprias mensagens já são texto que você escreveu e são cobertas 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

Tabelas são a parte de uma resposta que você mais frequentemente deseja em outro lugar — uma comparação, uma lista de configurações, um conjunto de resultados. Passe o mouse sobre qualquer tabela em uma transcrição e um botão de cópia aparecerá no canto superior direito.

Ele copia a tabela em duas formas de uma vez, e o aplicativo no qual você cola escolhe a que ele entende:

Cole em uma planilha, um processador de texto ou um editor de documentos e você obterá uma tabela real — as linhas e colunas chegam intactas, não como um bloco de texto.
Cole em um editor de texto simples e você obterá linhas separadas por tabulações, que a maioria dos editores e ferramentas de dados lê como colunas.

Você não precisa fazer nada para escolher entre elas; ambas viajam juntas em uma única cópia.

Copiar tabela — copia a tabela sobre a qual você está passando o mouse.

Exportar como um arquivo Markdown

Abre uma caixa de diálogo de salvamento para que você escolha onde o arquivo .md será salvo e qual será seu nome. Use-o para arquivar uma sessão ou entregá-la a outra pessoa.

Exportar como arquivo Markdown — salva a transcrição em um arquivo Markdown de sua escolha.

Mostrar o arquivo de origem em sua pasta

Abre seu gerenciador de arquivos com o arquivo de transcrição original da sessão selecionado. Use-o quando quiser o arquivo em si — para fazer backup, inspecioná-lo ou apontar outra ferramenta para ele. (Lê-lo e copiá-lo é seguro; editá-lo enquanto Claude está usando essa sessão não é — veja O aplicativo nunca altera suas sessões.)

Mostrar arquivo de transcrição na pasta — abre o arquivo de transcrição original em seu gerenciador de arquivos, selecionado.

Configurações

Abra as configurações pelo botão na barra superior. Existem duas abas: Exibição para idioma e tema, e Sobre para a versão do aplicativo.

Abrir configurações — abre a caixa de diálogo de Configurações (idioma, tema e versão do aplicativo).

Idioma

Escolha o idioma da interface na lista. Sua escolha é lembrada na próxima vez que você abrir o aplicativo.

Idioma — escolhe o idioma da interface.

Tema

Escolha uma interface clara ou escura. A escolha é aplicada imediatamente e é lembrada.

Tema — alterna entre a interface Claro e Escuro.

Notificações de atualização

Quando o aplicativo é iniciado, ele verifica silenciosamente se uma versão mais recente foi lançada. Se houver uma disponível, um banner aparece na parte superior com um link para as notas de lançamento e um botão de download. Ele apenas informa você — nunca instala nada por conta própria.

Você tem três maneiras de lidar com o banner:

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

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

Outros controles

GitHub — abre o repositório de código-fonte do aplicativo no GitHub em seu navegador.
Ajuda — abre esta página de ajuda no seu idioma atual.