Uma nova maneira de extrair transcrições detalhadas do Claude Code
Uma nova maneira de extrair transcrições detalhadas do Claude Code
25 de dezembro de 2025
Eu lancei claude-code-transcripts, uma nova ferramenta Python CLI para converter transcrições do Claude Code em páginas HTML detalhadas que fornecem uma interface melhor para entender o que o Claude Code fez do que o próprio Claude Code. As transcrições resultantes também foram projetadas para serem compartilhadas, usando qualquer hospedagem HTML estática ou mesmo via GitHub Gists.
Aqui está o início rápido, sem necessidade de instalação se você já tiver o uv:
uvx claude-code-transcripts
(Ou você poderia uv tool install claude-code-transcripts ou pip install claude-code-transcripts primeiro, se quiser.)
Isso abrirá uma lista de suas sessões locais do Claude Code. Bata para cima e para baixo para selecionar um e depois aperte index.html arquivo mostrando um resumo da transcrição e um ou mais page_x.html arquivos com todos os detalhes de tudo o que aconteceu.
Visite esta página de exemplo para ver uma transcrição extensa (12 páginas) produzida usando esta ferramenta.
Se você tiver a ferramenta gh CLI instalada e autenticada, poderá adicionar o --gist opção – a transcrição selecionada será automaticamente compartilhada com um novo Gist e um link fornecido para gistpreview.github.io para visualizá-lo.
claude-code-transcripts também pode buscar sessões do Claude Code para web. Fiz engenharia reversa da API privada para isso (então espero que continue funcionando), mas agora você pode executar:
uvx claude-code-transcripts web --gist
Em seguida, selecione um Código Claude para sessão da web e converta-o para HTML e publique-o também como Gist.
O README claude-code-transcripts contém detalhes completos das demais opções fornecidas pela ferramenta.
Por que eu construí isso
Hoje em dia estou escrevendo significativamente mais código por meio do Claude Code do que digitando texto em um editor de texto. Na verdade, estou realizando mais trabalho de codificação no meu telefone do que no meu laptop, graças à interface Claude Code no aplicativo Claude para iPhone da Anthropic.
Ser capaz de ter uma ideia durante uma caminhada e transformá-la em um código funcional, testado e documentado a partir de alguns prompts no meu telefone é uma forma de trabalhar verdadeiramente de ficção científica. Estou gostando muito.
Há um problema: o real trabalhar o que faço é agora cada vez mais representado por estas conversas de Claude. Essas transcrições capturam um contexto extremamente importante sobre meus projetos: o que pedi, o que Claude sugeriu, decisões que tomei e a própria justificativa de Claude para as decisões que tomou durante a implementação de um recurso.
Eu valorizo muito essas transcrições! Eles me ajudam a descobrir quais estratégias de prompt funcionam e fornecem um registro inestimável das decisões tomadas na construção de recursos.
Na era pré-LLM, eu dependia de questões e comentários de questões para registrar todo esse contexto extra do projeto, mas agora essas conversas estão acontecendo na interface do Claude Code.
Já fiz várias tentativas anteriores para resolver esse problema. A primeira foi colar as sessões de terminal do Claude Code em um formato compartilhável – criei uma ferramenta personalizada para isso (chamada terminal-to-html e a usei muito, mas faltam muitos detalhes – incluindo os traços de pensamento invisíveis por padrão que Claude Code gera enquanto trabalha em uma tarefa.
Também construí claude-code-timeline e codex-timeline como visualizadores de ferramentas HTML para transcrições JSON do Claude Code e do Codex. Eles funcionam muito bem, mas ainda não são tão amigáveis quanto eu gostaria.
Um problema ainda maior é o Claude Code para web – o agente de codificação assíncrona da Antrópico, que é o que tenho usado no meu telefone. Obter transcrições disso é ainda mais difícil! Estou sincronizando-os com meu laptop apenas para poder copiar e colar do terminal, mas essa é uma solução bastante deselegante.
Como construí transcrições de código claude
Você não ficará surpreso ao saber que cada centímetro desta nova ferramenta foi construído com Claude.
Você pode navegar no log de commit para encontrar links para as transcrições de cada commit, muitos deles publicados usando a própria ferramenta.
Aqui estão alguns exemplos recentes:
Fiz com que Claude usasse as seguintes dependências:
-
clique e clique em grupo padrão para construir a CLI
-
Jinja2 para modelos HTML – uma refatoração tardia, o sistema inicial usava concatenação de strings Python
-
httpx para fazer solicitações HTTP
-
markdown para converter Markdown em HTML
-
questionário – novo para mim, sugerido por Claude – para implementar a interface de seleção de lista interativa
E para dependências de desenvolvimento:
A única coisa que não foi feita com o Claude Code foi a engenharia reversa do próprio Claude Code para descobrir como recuperar o JSON da sessão do Claude Code para a web.
Eu sei que Claude Code pode fazer engenharia reversa sozinho, mas pareceu um pouco mais subversivo ter o OpenAI Codex CLI fazendo isso. Aqui está a transcrição – usei o Codex npx prettier para imprimir o JavaScript ofuscado do Claude Code e, em seguida, solicitou que ele descobrisse a API e os detalhes de autenticação.
Codex surgiu com isso lindo curl comando:
curl -sS -f \
-H "Authorization: Bearer $(security find-generic-password -a "$USER" -w -s "Claude Code-credentials" | jq-r .claudeAiOauth.accessToken)" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-H "x-organization-uuid: $(jq -r '.oauthAccount.organizationUuid' ~/.claude.json)" \
"https://api.anthropic.com/v1/sessions"
O truque realmente interessante é a maneira como ele extrai o token OAuth de Claude Code do macOS Keychain usando o security find-generic-password comando. Acabei usando esse truque em claude-code-transcripts em si!
