← Voltar ao curso
Nível 2 — Ferramenta de trabalho · Módulo 2.1 — VS Code: a mesa de trabalho

2.1.7 · Extensão vs CLI, e `/usage`

4 min de vídeo TODOS

Objetivo: ao final, o consultor sabe o que só existe no terminal, e acompanha seu consumo com /usage.

O que você precisa levar desta aula

  1. Extensão e CLI compartilham histórico — você pode alternar entre os dois na mesma sessão.
  2. Comandos/skills completos, tab completion e o atalho ! só existem no terminal.
  3. /usage mostra atribuição de consumo por skill, subagente, plugin e servidor MCP — e aponta o que está inflando o gasto.

O que só existe no CLI

Recurso CLI Extensão
Comandos e skills Todos Subconjunto (digite / para ver)
Configuração de servidor MCP Adicionar (claude mcp add) Gerenciar servidores já configurados, com /mcp
Atalho ! (comando de sistema direto) Sim Não
Tab completion de caminho Sim Não
Checkpoints Sim Sim

Quando precisar de algo da coluna CLI, abra o terminal integrado (Cmd+` ou Ctrl+`) e rode claude ali — não é preciso sair do VS Code.

Indo e voltando entre extensão e CLI

claude --resume

Abre um seletor com as sessões da extensão, porque o histórico é compartilhado. Você pode começar uma conversa na extensão e continuar no terminal, ou o contrário.

/usage

/usage

Mostra:

Os números são aproximados e calculados a partir das sessões locais desta máquina — uso feito em outro dispositivo ou na claude.ai não entra na conta.

Regra Wayon Consulte /usage antes de reportar lentidão ou custo alto. Na maioria dos casos, a tabela de atribuição já mostra a causa — sessão longa demais, ou um subagente sendo chamado repetidamente.

📖 Extensão vs CLI · Acompanhar custos

Quiz — 5 questões

1.Você quer usar o atalho ! para rodar um comando de sistema direto, mas está no painel da extensão e a opção não existe.
  • a)É um bug da extensão

    Não é bug — é uma diferença documentada entre extensão e CLI.

  • b)O atalho ! só existe no terminal — abra o terminal integrado e rode claude ali

    Correto.

  • c)É preciso reinstalar o CLI

    Não resolve; o atalho simplesmente não existe na interface da extensão, independentemente da instalação.

Ver resposta e por quê
❌a) Não é bug — é uma diferença documentada entre extensão e CLI.
✅b) Correto.
❌c) Não resolve; o atalho simplesmente não existe na interface da extensão, independentemente da instalação.
2.Você quer adicionar um novo servidor MCP à sua configuração.
  • a)Pode ser feito direto no painel da extensão, com /mcp

    /mcp gerencia servidores já configurados (habilitar, desabilitar, reconectar) — adicionar é feito pelo CLI.

  • b)Não é possível configurar MCP a partir do VS Code de forma alguma

    É possível gerenciar, só não adicionar novos direto no painel.

  • c)Adicione pelo CLI (claude mcp add); depois, gerencie no painel com /mcp

    Correto.

Ver resposta e por quê
❌a) /mcp gerencia servidores já configurados (habilitar, desabilitar, reconectar) — adicionar é feito pelo CLI.
❌b) É possível gerenciar, só não adicionar novos direto no painel.
✅c) Correto.
3.Você começou uma conversa na extensão do VS Code e quer continuá-la no terminal.
  • a)Não é possível; extensão e CLI têm históricos separados

    Compartilham histórico — é possível continuar em qualquer um dos dois.

  • b)claude --resume no terminal, escolhendo a mesma sessão

    Correto.

  • c)É preciso copiar manualmente o conteúdo da conversa

    Não é necessário — o histórico é compartilhado automaticamente.

Ver resposta e por quê
❌a) Compartilham histórico — é possível continuar em qualquer um dos dois.
✅b) Correto.
❌c) Não é necessário — o histórico é compartilhado automaticamente.
4.Você percebe que uma sessão está consumindo muito mais que o normal, sem saber por quê.
  • a)Troque para um modelo menor imediatamente

    Trocar de modelo não diagnostica a causa do consumo alto.

  • b)Comece uma sessão nova sem investigar

    Pode ajudar no sintoma, mas não revela a causa — que pode se repetir na sessão nova.

  • c)Rode /usage e confira a tabela de atribuição por skill, subagente, plugin e MCP, e os avisos de comportamento

    Correto. É onde a causa normalmente aparece.

Ver resposta e por quê
❌a) Trocar de modelo não diagnostica a causa do consumo alto.
❌b) Pode ajudar no sintoma, mas não revela a causa — que pode se repetir na sessão nova.
✅c) Correto. É onde a causa normalmente aparece.
5.Os números mostrados em /usage cobrem:
  • a)Todo o uso da sua conta, em qualquer dispositivo

    Não cobrem — são aproximados e locais.

  • b)Apenas o uso do dia atual

    Mostra sessão atual e semana, não só o dia.

  • c)Apenas as sessões locais desta máquina — uso em outro dispositivo ou na claude.ai não entra na conta

    Correto.

Ver resposta e por quê
❌a) Não cobrem — são aproximados e locais.
❌b) Mostra sessão atual e semana, não só o dia.
✅c) Correto.