Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Claude TodosNew to Visual Studio Code? Get it now.
Claude Todos

Claude Todos

Carlos Junior

|
151 installs
| (1) | Free
Live task list for your Claude Code agents, with agent tree, tokens and cache — scoped to your workspace. Claude Code 2.1.233+: task tools are off by default; the extension turns them on in one click.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Claude Todos para VSCode e JetBrains

Português · English · Español · 简体中文 · 繁體中文

VS Code Marketplace Open VSX JetBrains Marketplace CI License: MIT

A lista de tarefas dos seus agentes Claude Code, ao vivo — com árvore de agentes, tempos, tokens e cache, restrita ao workspace aberto na janela atual do VSCode. Tudo 100% local: duas janelas em projetos diferentes nunca veem os dados uma da outra.

Painel Claude Todos: agente principal e sub-agents com as tasks avançando de pending → in_progress → completed ao vivo, com tempos por task

⚠️ Claude Code 2.1.233 ou mais recente? Nos modelos novos, as ferramentas de tasks (TodoWrite, TaskCreate) vêm desligadas por padrão e a lista deste painel fica vazia até você reativá-las — veja Instalação. A extensão oferece ligar com um clique ao ser instalada e mostra uma faixa no painel enquanto estiverem desligadas.

O que você vê

  • Tasks em tempo real — cada item transiciona pending → in_progress → completed conforme o agente trabalha; clicar numa task abre o transcript na linha da última mudança de status. Se o orquestrador para de atualizar a lista enquanto sub-agents seguem rodando, o painel sinaliza a defasagem.
  • Árvore de agentes ao vivo ("mission control") — main → sub-agents → agentes aninhados, com badge de tipo (Explore, Plan, general-purpose…), status e tokens por agente.
  • Tempos por task — duração de cada task concluída, tempo ao vivo da task em andamento e estimativa (rotulada como estimativa) do restante.
  • Tokens, contexto e cache — tabela por modelo ou por agente, indicador da janela de contexto com semáforo e eficiência de cache (reaproveitado × criado × novo).
  • Dashboard "Últimos 7 dias" — uso agregado do projeto, por modelo e por tipo de agente.
  • Notificações — toast quando a sessão fica ociosa aguardando você, ou quando todas as tasks completam (só com a janela sem foco).
  • Perguntas pendentes — uma faixa no topo do painel lista o que a sessão está esperando (uma pergunta do agente ou um plano aguardando aprovação), independente do foco da janela; clicar leva à linha do transcript.
  • Sessões ao vivo e nomes reais — o seletor de sessão marca com "● ao vivo" as sessões cujo processo do Claude Code ainda está rodando, e o modo automático prioriza uma sessão viva; nomes definidos com /session-name aparecem no lugar do título derivado.
  • UI em 5 idiomas — en, pt-br, es, zh-cn e zh-tw; segue o idioma do VS Code, com override via setting.

Como funciona

Painel Claude Todos atualizando ao vivo durante uma sessão do Claude Code

O painel Claude Todos (na Barra de Atividades, à esquerda) lê os transcripts que o próprio Claude Code já grava em disco — nenhum proxy, nenhuma API — e reflete tudo em tempo real conforme o agente trabalha.

Não importa onde o claude esteja rodando: pode ser o terminal integrado do VSCode, qualquer terminal externo (Windows Terminal, iTerm, gnome-terminal) ou até a CLI do Claude Code em outra janela. Desde que o diretório de trabalho da sessão bata com o workspace aberto no VSCode, o painel reflete.

As tasks vêm das chamadas TodoWrite e TaskCreate que o agente grava no transcript. Árvore de agentes, tokens, contexto, notificações e perguntas pendentes vêm do restante do transcript e não dependem delas.

Instalação

Editor Onde instalar
VS Code VS Code Marketplace
Cursor · Windsurf · VSCodium Open VSX
IntelliJ IDEA · PyCharm · WebStorm · Rider · … (2024.2+) JetBrains Marketplace
Qualquer um (offline) .vsix (VS Code) / .zip (JetBrains) — GitHub Release

Plugin JetBrains: o mesmo painel roda nos IDEs da JetBrains — mesma árvore de agentes, tempos, tokens e dashboard, com toasts nativos, clique na task abrindo o transcript e picker de sessão. Requer Node.js no PATH (quem roda Claude Code já tem). O hook é o mesmo dos dois lados: instalar por um IDE já vale para o outro.

  1. Instale a extensão (tabela acima). O guia "Comece com o Claude Todos" aparece na página Welcome/Get Started do editor e acompanha os passos abaixo.
  2. No primeiro uso, aceite o aviso para instalar os hooks em ~/.claude/settings.json — a extensão adiciona dois: SessionStart e UserPromptSubmit. Hooks existentes são preservados.
  3. Abra uma pasta e execute claude em qualquer terminal. A visão Claude Todos (Barra de Atividades) é populada assim que a sessão tem atividade.

Sessões que já estavam em execução quando você instalou os hooks são detectadas na próxima mensagem que você enviar a elas (é para isso que serve o UserPromptSubmit). Sessões novas são rastreadas imediatamente.

Ative as ferramentas de tasks (Claude Code 2.1.233 ou mais recente)

Desde a versão 2.1.233 (14/08/2026), o Claude Code desliga por padrão as ferramentas de lista de tasks — TodoWrite, TaskCreate, TaskUpdate, TaskList e TaskGet — quando o modelo é Opus 4.8, Sonnet 5, Fable 5, Mythos 5 ou mais novo. A decisão é da Anthropic: está no CHANGELOG e foi confirmada como intencional em #86929; a issue que acompanha o assunto é #80015. Sem essas ferramentas o agente não registra tasks no transcript e a lista deste painel fica vazia. A árvore de agentes, os tokens, o contexto, o cache, as notificações e as perguntas pendentes continuam funcionando.

Para reativá-las, adicione a variável CLAUDE_CODE_ENABLE_TODO_TOOLS ao ~/.claude/settings.json. Se a chave env já existir, acrescente a linha dentro dela:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"
  }
}

A chave env do settings.json vale para toda sessão do Claude Code, em qualquer modelo e superfície (terminal, extensão oficial do VS Code). Reinicie as sessões abertas: o conjunto de ferramentas é definido quando a sessão começa. Se o Claude responder que "não tem TaskCreate ou TodoWrite", é este o motivo. A extensão não altera essa configuração por você.

Comandos

Comando Atalho padrão
Claude Todos: Open in Editor Ctrl+Alt+T / Cmd+Alt+T
Claude Todos: Choose Session Ctrl+Alt+S / Cmd+Alt+S
Claude Todos: Refresh —
Claude Todos: Install Session Hook —
Claude Todos: Choose Theme —

Configurações

Configuração Padrão Efeito
claudeTodos.claudeDir "" (detecção automática via os.homedir()) Sobrescreve a localização de ~/.claude.
claudeTodos.autoInstallHook true Mostra o aviso de primeira execução pedindo para instalar os hooks.
claudeTodos.language auto Idioma da UI do painel (auto | en | pt-br | es | zh-cn | zh-tw).
claudeTodos.theme classic Tema do painel (classic | papel | painel | terminal | mission). Em alto contraste, usa sempre o Clássico.
claudeTodos.notifications true Toast quando a sessão fica ociosa ou completa todas as tasks (janela sem foco).
claudeTodos.activeFolder "" Multi-root: pasta do workspace a acompanhar; vazio = seguir a sessão mais ativa.

Temas

O painel tem cinco temas, cada um em claro e escuro, de acordo com o seu editor:

  • Clássico (padrão): segue o tema do editor, como sempre foi.
  • Papel: calmo e espaçado, com uma única cor de destaque.
  • Painel: o azul do seu editor por função, forte para o consumo e vivo para o que está rodando agora, com uma faixa de agentes em anéis. Clicar num anel abre o card do agente.
  • Terminal: monoespaçado, com status em texto e barras ASCII.
  • Mission Control: denso, com medidores no topo e agentes em linhas com luzes de status.

No VS Code, rode Claude Todos: Choose Theme para ver a prévia ao vivo (Esc cancela) ou use a configuração claudeTodos.theme. No JetBrains, use o botão Tema… no título do painel. Em alto contraste, o painel usa sempre o Clássico.

Tema Clássico, escuro Tema Clássico, claro

Painel no tema Papel, escuro Painel no tema Papel, claro

Tema Painel, escuro Tema Painel, claro

Tema Terminal, escuro Tema Terminal, claro

Tema Mission Control, escuro Tema Mission Control, claro

Privacidade e fluxo de dados

Esta extensão é totalmente local. Nada é enviado para nenhum servidor.

Arquivo Como é acessado Por quê
~/.claude/settings.json Lido + escrito (só com sua permissão) Adiciona dois comandos de hook em hooks.SessionStart e hooks.UserPromptSubmit; quando você clica em Ativar ferramentas de tasks, a chave env.CLAUDE_CODE_ENABLE_TODO_TOOLS; e, quando você ativa os Dados exatos, a pasta do mod em env.CLAUDE_CODE_PLUGIN_DIRS. Outros hooks e configurações são preservados; um arquivo inválido nunca é sobrescrito.
~/.claude/.vscode-todos-bridge/sessions.json Escrito pelo script de hook embarcado Registra {cwd, sessionId, terminalPid, startedAt} para a extensão saber qual sessão do Claude pertence a qual janela do VSCode. Limitado a 200 entradas.
~/.claude/.vscode-todos-bridge/mod/ Escrito pela extensão (só com sua permissão) Cópia do mod todos-panel-bridge do Claude Code e a data da ativação. Apagada quando você desativa os Dados exatos.
~/.claude/.vscode-todos-bridge/live/<sessionId>.json Escrito pelo mod, dentro do Claude Code Por sessão: janela de contexto, limites de uso de 5h e 7 dias, fim do último turno e início e fim de cada sub-agent (tipo, descrição, modelo). Nada de custo nem do conteúdo das mensagens. Arquivos com mais de 30 dias são apagados.
~/.claude/projects/{cwd-encoded}/… Apenas leitura Transcripts da sessão e dos sub-agents (.jsonl + .meta.json), gravados pelo próprio Claude Code — fonte das tasks, árvore, tempos e tokens.
~/.claude/todos/ Não é tocado Localização legada do Claude Code 1.x. Ignorada.

A extensão nunca modifica seus transcripts. Ela só apaga o que ela mesma criou: a cópia do mod, quando você desativa os Dados exatos, e os arquivos da ponte com mais de 30 dias.

Requisitos

  • VSCode 1.85 ou mais recente
  • Claude Code 2.x (qualquer versão que escreva transcripts em ~/.claude/projects/). A partir da 2.1.233, com modelos novos, a lista de tasks exige CLAUDE_CODE_ENABLE_TODO_TOOLS=1 — veja Instalação.
  • Node.js 20+ no PATH (o script de hook é um pequeno programa Node)

Compilando a partir do código-fonte

git clone <repo-url>
cd claude-todos-vscode
npm install
npm test         # vitest
npm run build    # esbuild para a extensão + hook, vite para o webview Svelte
npx vsce package # gera claude-todos-<versão>.vsix

Para rodar a extensão em um host de desenvolvimento: abra a pasta no VSCode e pressione F5 (usa .vscode/launch.json).

Limitações conhecidas

  • O script de hook precisa estar acessível pelo caminho armazenado em ~/.claude/settings.json. Se você apagar a extensão manualmente sem desinstalá-la, esses comandos de hook permanecem como no-ops — remova-os à mão ou reinstale e use Claude Todos: Install Session Hook novamente.
  • Se as ferramentas de tasks do Claude Code estiverem desligadas (padrão a partir da 2.1.233 nos modelos novos), a lista fica vazia e o painel mostra "Sessão ativa — aguardando tasks" mesmo com o agente trabalhando. O resto do painel não depende delas. Como reativar: Instalação.
  • Os Dados exatos dependem dos Mods do Claude Code, em early access. Se o rodapé do bloco de uso disser que a ponte não respondeu, os Mods podem estar desligados na sua conta, ou um CLAUDE_CODE_PLUGIN_DIRS definido no ambiente pode estar prevalecendo sobre o do settings.json; o painel continua com as estimativas. Desinstalar a extensão não remove a pasta do mod nem a entrada no settings.json: rode antes Claude Todos: Disable exact data from Claude Code ou remova as duas à mão.

Contribuindo

Veja CONTRIBUTING.md para o checklist de smoke-test e o plano de testes manuais.

Licença

MIT

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft