Use Claude Code in VS Code

• Revisar e editar os planos do Claude antes de aceitá-los
• Aceitar automaticamente edições conforme são feitas
• @-mencionar arquivos com intervalos de linhas específicas da sua seleção
• Acessar o histórico de conversas
• Abrir múltiplas conversas em abas ou janelas separadas

​

Pré-requisitos

• VS Code 1.94.0 ou superior
• Uma conta Anthropic: qualquer assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou uma conta Claude Console funciona, e nenhuma chave de API é necessária. Você fará login com essa conta quando abrir a extensão pela primeira vez. Se você acessar Claude através de um provedor de terceiros como Amazon Bedrock ou Google Cloud’s Agent Platform, consulte Use third-party providers para instruções de configuração.

​

Instalar a extensão

• Instalar para VS Code
• Instalar para Cursor

• Outros forks do VS Code: a extensão também pode ser instalada em forks como Devin Desktop ou Kiro. Pesquise por “Claude Code” na visualização de Extensões do editor ou instale a partir do registro Open VSX.
• Editores que não conseguem instalar a extensão: instale a CLI e execute claude no terminal integrado do editor. A CLI funciona em qualquer terminal.
• Dev containers: para executar o Claude Code dentro de um dev container, consulte Contêineres de desenvolvimento.

​

Comece a usar

1

Abra o painel do Claude Code

Em todo o VS Code, o ícone Spark indica o Claude Code: A maneira mais rápida de abrir o Claude é clicar no ícone Spark na Editor Toolbar (canto superior direito do editor). O ícone só aparece quando você tem um arquivo aberto.Outras maneiras de abrir o Claude Code:

• Activity Bar: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Clique em qualquer sessão para abri-la no seu local preferido ou inicie uma nova. Esse ícone está sempre visível na Activity Bar.
• Command Palette: Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), digite “Claude Code” e selecione uma opção como “Open in New Tab”
• Status Bar: clique em ✻ Claude Code no canto inferior direito da janela. Isso funciona mesmo quando nenhum arquivo está aberto.

Você pode arrastar o painel do Claude para reposicioná-lo em qualquer lugar do VS Code. Consulte Personalize seu fluxo de trabalho para obter detalhes.

2

Faça login

Na primeira vez que você abre o painel, uma tela de login é exibida. Clique em Sign in e conclua a autorização no seu navegador.Se você vir Not logged in · Please run /login mais tarde, a extensão reabre a tela de login automaticamente. Se ela não aparecer, recarregue a janela pela Command Palette com Developer: Reload Window.Se você tem ANTHROPIC_API_KEY definida no seu shell, mas ainda vê o prompt de login, o VS Code pode não ter herdado o ambiente do seu shell. Inicie o VS Code a partir de um terminal com code . para que ele herde suas variáveis de ambiente, ou faça login com sua conta Claude.Depois que você fizer login, uma checklist Learn Claude Code será exibida. Percorra cada item clicando em Show me ou dispense-a com o X. Para reabri-la mais tarde, desmarque Hide Onboarding nas configurações do VS Code em Extensions > Claude Code.

3

Envie um prompt

Peça ao Claude ajuda com seu código ou arquivos, seja para explicar como algo funciona, fazer a depuração de um problema ou fazer alterações.

O Claude vê automaticamente o texto selecionado. Pressione Option+K (Mac) / Alt+K (Windows/Linux) para também inserir uma referência de @-menção (como @file.ts#5-10) no seu prompt.

Aqui está um exemplo de pergunta sobre uma linha específica de um arquivo:

4

Revise as alterações

Verifique o modo de permissão exibido na parte inferior da caixa de prompt:

• No modo Auto ou Edit automatically, o Claude edita a maioria dos arquivos no seu workspace sem perguntar.
• No modo Manual, quando o Claude quer editar um arquivo, ele mostra uma comparação lado a lado do original e das alterações propostas e, em seguida, pede permissão. Você pode aceitar, rejeitar ou dizer ao Claude o que fazer em vez disso. Se você editar o conteúdo proposto diretamente na visualização do diff antes de aceitar, o Claude é informado de que você o modificou, para que não presuma que o arquivo corresponde à proposta original.

Para revisar uma edição proposta uma alteração por vez, use os botões Accept this change e Reject this change abaixo de cada alteração no diff. Rejeitar uma alteração a reverte no conteúdo proposto; aceitar a marca como revisada. A revisão por alteração requer o Claude Code v2.1.275 ou posterior.Aceitar ou rejeitar o arquivo inteiro ainda conclui a revisão. Um diff com mais de 100 alterações é aberto sem os botões por alteração, portanto revise-o como um arquivo inteiro.As mesmas ações estão disponíveis na posição do cursor pelo menu de contexto do editor e pela Command Palette como Claude Code: Accept Change at Cursor e Claude Code: Reject Change at Cursor.

​

Usar a caixa de prompt

• Modos de permissão: clique no indicador de modo na parte inferior da caixa de prompt para alternar entre modos de permissão. Com o Claude Code v2.1.283 ou posterior, Auto é o modo de permissão inicial padrão e, em versões anteriores, somente nos planos Pro, Max e Team. Consulte como a extensão escolhe o modo de permissão inicial para saber o que altera isso e todos os modos de permissão que o indicador oferece.
  • Auto: um classificador analisa a maioria das ações em vez de perguntar a você. Consulte modo auto para saber o que ele analisa e bloqueia.
  • Manual: o Claude pede permissão antes de edições de arquivos e da maioria dos comandos de shell.
  • Plan: o Claude descreve o que fará e aguarda aprovação antes de fazer alterações. O VS Code abre automaticamente o plano como um documento Markdown completo, no qual você pode adicionar comentários inline para dar feedback antes que o Claude comece. Você também pode digitar /plan na caixa de prompt. Requer o Claude Code v2.1.280 ou posterior.
    • /plan: alterna para o modo de planejamento. Se você já estiver no modo de planejamento, mostra o plano atual.
    • /plan com uma tarefa, como /plan fix the auth bug: alterna para o modo de planejamento e começa a planejar essa tarefa.
    • /plan open: quando você já está no modo de planejamento, abre o arquivo do plano no editor.
  • Edit automatically: o Claude faz edições sem perguntar.
• Modelo: selecione Switch model… no menu de comandos para trocar o modelo no meio da sessão. Você também pode clicar no nome do modelo na parte inferior da caixa de prompt para abrir o mesmo seletor. Com o Claude Code v2.1.284 ou posterior, digitar /model sozinho na caixa de prompt também abre o seletor. Quando o modelo atual oferece suporte a níveis de esforço, o seletor também mostra uma linha Effort e o botão do nome do modelo mostra o nível selecionado. Quando você escolhe um nível diferente de max, o Claude Code o salva para o modelo atual como seu padrão, em modelSettings nas suas configurações de usuário; max se aplica somente à sessão atual. O botão do nome do modelo e a linha Effort requerem o Claude Code v2.1.257 ou posterior. Quando os fluxos de trabalho dinâmicos estão ativados e o modelo atual oferece suporte a eles, um botão Ultracode aparece abaixo da linha Effort. Ative-o para que o Claude planeje um fluxo de trabalho para cada tarefa substancial nesta sessão, no nível de esforço selecionado. Enquanto ele estiver ativado, o botão do nome do modelo mostra · Ultracode após o nível. O botão requer o Claude Code v2.1.284 ou posterior.
• Menu de comandos: clique em / ou digite / para abrir o menu de comandos. As opções incluem anexar arquivos, trocar de modelo e ativar ou desativar o pensamento estendido. A seção Customize inclui entradas como servidores MCP, comandos, estilos de saída, hooks, memória, instruções, permissões e plugins. Itens com um ícone de terminal abrem no terminal integrado.
  • Para navegar por comandos como /usage ou /remote-control, selecione Slash commands na seção Customize. Uma caixa de diálogo os lista com uma caixa de filtro. Escolha um para executá-lo. Digitar / na caixa de prompt continua sugerindo comandos inline. Requer o Claude Code v2.1.257 ou posterior. Digitar /skills também abre essa caixa de diálogo. Cada linha de skill mostra sua visibilidade, como On ou Name only. Clique na visibilidade para alterá-la, exceto em linhas marcadas como locked, como skills de plugins. O atalho /skills e os controles de visibilidade requerem o Claude Code v2.1.280 ou posterior.
  • Selecione Output styles na seção Customize para escolher um estilo de saída, incluindo seus estilos personalizados. Requer o Claude Code v2.1.257 ou posterior. Para criar um estilo personalizado, selecione Build a custom style no menu Output styles. O Claude Code escreve o arquivo de estilo para você no nível do projeto ou do usuário. Requer o Claude Code v2.1.261 ou posterior.
  • Selecione Hooks na seção Customize para ver os hooks carregados na sessão, agrupados por evento. Você pode adicionar, editar ou remover hooks salvos nos seus arquivos de configurações de usuário, de projeto e locais. Hooks de outras fontes, como configurações gerenciadas ou plugins, são somente leitura. Requer o Claude Code v2.1.269 ou posterior.
  • Selecione Permissions na seção Customize para ver as regras de permissão da sessão, agrupadas em Allow, Ask e Deny. Você pode adicionar regras às suas configurações de usuário, de projeto ou locais e remover regras salvas nelas. Regras de outras fontes, como configurações gerenciadas ou aprovações feitas somente para esta sessão, são somente leitura. Requer o Claude Code v2.1.269 ou posterior.
  • Selecione Memory na seção Customize para ativar ou desativar a memória automática. Enquanto ela estiver ativada, você também pode navegar pelas memórias que o Claude salvou e mostrar no seu gerenciador de arquivos as pastas que as armazenam. Requer o Claude Code v2.1.274 ou posterior. Clique em uma memória salva para lê-la na caixa de diálogo, onde você pode editar o texto, excluir a memória ou abrir o arquivo dela no editor. Visualizar, editar e excluir uma memória na caixa de diálogo requer o Claude Code v2.1.275 ou posterior.
  • Selecione Instructions na seção Customize para editar os arquivos CLAUDE.md que o Claude lê. Escolha um arquivo para abri-lo no editor. Se o arquivo ainda não existir, o Claude Code o cria primeiro. Requer o Claude Code v2.1.274 ou posterior.
  • Selecione Status na seção Customize, ou digite /status, para verificar a versão do Claude Code, a conta, o modelo e os detalhes dos servidores MCP da sessão. Requer o Claude Code v2.1.280 ou posterior.
  • Selecione Sandbox na seção Customize, ou digite /sandbox, para ver se os comandos Bash do Claude são executados em sandbox. Você pode alternar o modo do sandbox e adicionar comandos excluídos ali. Requer o Claude Code v2.1.280 ou posterior.
  • Selecione Claude in Chrome na seção Customize, ou digite /chrome, para verificar e gerenciar a conexão do Claude in Chrome. Ambos requerem login com uma conta claude.ai. Requer o Claude Code v2.1.280 ou posterior.
  • Selecione Export conversation na seção Context, ou digite /export, para copiar a conversa como texto simples ou salvá-la em um arquivo. Adicione um nome de arquivo, como /export notes.txt, para pular a caixa de diálogo e escolher onde salvar o arquivo. Requer o Claude Code v2.1.280 ou posterior.
  • A seção Settings inclui Enable Remote Control for all sessions, que define remoteControlAtStartup para controlar se novas sessões interativas se conectam automaticamente ao Remote Control. Requer o Claude Code v2.1.203 ou posterior. Quando você ativa ou desativa essa opção em uma janela do VS Code, a alteração não se limita às sessões que você iniciar depois. Ela também se aplica às sessões já abertas nessa janela do VS Code. Se você a desativar, as sessões abertas se desconectam. Com o Claude Code v2.1.261 ou posterior, a alteração também alcança as sessões abertas nas suas outras janelas do VS Code.
  • A seção Settings também inclui Focus view, que oculta chamadas de ferramenta, resultados de ferramentas e pensamento atrás de linhas expansíveis, deixando seus prompts e as respostas do Claude. Ative ou desative ali, com Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), ou pela Command Palette com Claude Code: Toggle Focus view. A alteração se aplica a todas as sessões abertas e persiste entre sessões. Requer o Claude Code v2.1.221 ou posterior. A lista de tarefas mais recente do Claude permanece visível, assim como o texto ao qual se refere uma pergunta pendente do Claude; isso requer o Claude Code v2.1.225 ou posterior. Enquanto o Claude executa subagentes, linhas de progresso em tempo real com a atividade mais recente deles aparecem abaixo do grupo de chamadas de ferramenta que os iniciou. Isso requer o Claude Code v2.1.269 ou posterior.
  • Para sair da sua conta Anthropic, selecione Sign out na seção Settings ou digite /logout. Em um provedor terceirizado, o menu não oferece nenhum dos dois. Requer o Claude Code v2.1.277 ou posterior.
  • Para relatar um bug, clique em Report a problem na parte inferior do menu, ou digite /bug ou /feedback com uma descrição opcional que preenche previamente o relatório. Quando você envia o relatório e está conectado à Anthropic em uma conexão first-party, o Claude Code o envia à Anthropic. Requer o Claude Code v2.1.229 ou posterior. Em um provedor terceirizado, ou sem credenciais da Anthropic, nada é enviado. A caixa de diálogo informa isso antes de você escrever. Enviar salva o relatório como um arquivo local em ~/.claude/feedback-bundles/, com padrões conhecidos de chaves de API e tokens ocultados. Salvar o relatório no seu computador requer o Claude Code v2.1.284 ou posterior. Depois que o relatório é salvo, a confirmação informa o nome do arquivo e inclui um botão Show folder. Envie esse arquivo ao representante da sua conta Anthropic ou anexe-o a uma solicitação de suporte. Se a política da sua organização desativar o feedback sobre o produto, Report a problem não aparece no menu, e /bug e /feedback mostram o aviso Feedback is turned off by your organization's policy or this environment's settings. em vez de abrir o relatório. Com o Claude Code v2.1.284 ou posterior, se você definir a variável de ambiente DISABLE_FEEDBACK_COMMAND ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, o feedback também é desativado e abrir o relatório mostra esse aviso.
• Perguntas paralelas: digite /btw seguido de uma pergunta para perguntar sobre sua sessão sem adicioná-la à conversa. A resposta abre em um painel ao lado do chat, onde você pode fazer perguntas de acompanhamento. Requer o Claude Code v2.1.227 ou posterior. A conversa paralela sobrevive a recarregamentos da janela. O Claude Code mantém as 20 trocas mais recentes e expira as conversas armazenadas conforme o cronograma de cleanupPeriodDays, desde que o Claude Code consiga determinar com segurança o período de retenção. Para limpar uma conversa paralela, clique no ícone de lixeira no painel.
• Copiar uma resposta: passe o cursor sobre uma resposta e clique em Copy response para copiá-la para a área de transferência, ou digite /copy para copiar a resposta mais recente. /copy 2 copia a penúltima. Requer o Claude Code v2.1.277 ou posterior.
• Favoritos: passe o cursor sobre uma resposta e clique em Bookmark response para salvá-la, ou clique em Remove bookmark em uma resposta salva para removê-la. Para revisar as respostas salvas, abra o painel Bookmarks. Você pode clicar no ícone de favorito na parte superior do painel do Claude Code, selecionar Bookmarks na seção Context do menu de comandos ou digitar /bookmarks. Requer o Claude Code v2.1.286 ou posterior.
• Arquivos que o Claude envia para você: quando a sessão está conectada ao Remote Control e o Claude envia arquivos para você com a ferramenta SendUserFile, a conversa mostra uma linha como Sent report.md, chart.png. Clique no nome de um arquivo para abri-lo no editor. A linha permanece visível no Focus view. Requer o Claude Code v2.1.295 ou posterior. Um arquivo aparece como um caminho completo no qual você não pode clicar, como \\server\share\report.md, quando o caminho dele nomeia um host de rede. O Claude Code não cria um link para esse arquivo porque abri-lo contataria esse host e, no Windows, poderia enviar suas credenciais do Windows para esse host.
• Indicador de contexto: a caixa de prompt mostra quanto da janela de contexto do Claude você está usando. O Claude compacta automaticamente quando necessário, ou você pode executar /compact manualmente.
• Relógio do cache de prompt: um ícone de relógio ao lado do indicador de contexto estima quanto tempo resta antes que o cache de prompt da conversa expire. Ele faz uma contagem regressiva a partir do tempo de vida de cinco minutos ou de uma hora do cache, e cada resposta que usa o cache reinicia a contagem. Exceto pela compactação, as ações que invalidam o cache não reiniciam o relógio, então ele ainda pode mostrar minutos restantes depois que você troca de modelo.
  • Até que a contagem termine, o ícone mostra os minutos restantes, como 12m.
  • Quando a contagem termina, os minutos desaparecem e o ícone fica vermelho, ou na cor de erro do seu tema, até a próxima resposta. O cache provavelmente expirou, então espere uma resposta mais lenta e mais cara à sua próxima mensagem enquanto o cache é reconstruído. Se o tempo de vida de cinco minutos continuar se esgotando entre suas mensagens, consulte Escolher o TTL você mesmo.
  • Logo após a conversa ser compactada, o ícone também fica vermelho sem minutos até a próxima resposta, porque o cache ainda não cobre a conversa compactada.
• Mapa de agentes: quando a conversa inclui subagentes, uma contagem de agentes como 2 agents aparece na parte inferior da caixa de prompt. O ponto dela mostra se algum subagente está trabalhando ou aguardando sua permissão. Clique na contagem de agentes para abrir o mapa de agentes, que desenha os subagentes da conversa como uma árvore abaixo do agente principal, cada um com seu status, tempo decorrido e contagem de tokens. Clique em um subagente para ver seu prompt e suas chamadas de ferramenta, abrir sua transcrição somente leitura ou interrompê-lo enquanto ele é executado. Requer o Claude Code v2.1.269 ou posterior. O mapa também lista as outras tarefas em segundo plano da sessão, como comandos de shell em segundo plano e monitores, abaixo dos agentes. Clique em uma linha para abrir o cartão da tarefa e interrompê-la ali. Para abrir o mapa quando nenhuma contagem de agentes estiver sendo exibida, como quando o Claude iniciou um shell em segundo plano mas nenhum subagente, digite /tasks na caixa de prompt. Tarefas em segundo plano no mapa e o /tasks digitado requerem o Claude Code v2.1.277 ou posterior. Com o Claude Code v2.1.286 ou posterior, quando você clica em Stop ou pressiona Esc, o turno atual termina. Agentes em segundo plano continuam em execução até terminarem ou até você interrompê-los pelo mapa.
• Pensamento estendido: permite que o Claude passe mais tempo raciocinando sobre problemas complexos. Ative-o pelo menu de comandos (/). O raciocínio do Claude aparece na conversa como blocos recolhidos: clique em um bloco para lê-lo ou pressione Ctrl+O para expandir ou recolher todos os blocos de pensamento da sessão. Consulte Pensamento estendido para obter detalhes.
• Entrada de várias linhas: pressione Shift+Enter para adicionar uma nova linha sem enviar. Isso também funciona na entrada de texto livre “Other” das caixas de diálogo de perguntas.

​

Referenciar arquivos e pastas

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

• Quando o arquivo está dentro do seu workspace e corresponde às suas configurações files.exclude ou search.exclude, o Claude recebe no máximo o caminho do arquivo, e não o texto que você selecionou.
• O mesmo se aplica a um arquivo ignorado pelo git, desde que a configuração search.useIgnoreFiles do VS Code e a configuração respectGitIgnore da extensão estejam ambas ativadas, que é o padrão.

• Para anexar uma imagem, cole-a da área de transferência na caixa de prompt.
• Para anexar arquivos, mantenha Shift pressionado enquanto os arrasta para a caixa de prompt.
• Para remover um anexo do contexto, clique no X dele.

​

Incluir a saída do terminal nos prompts

​

Colar texto

• Se um aviso como Removed 3 invisible characters from the pasted text aparecer quando você colar, o texto foi inserido sem esses caracteres.
• Se um aviso sobre caracteres removidos aparecer quando você enviar, nada foi enviado. O texto limpo está de volta na caixa de prompt. Envie novamente para enviar o texto como exibido.

​

Matemática em LaTeX nas respostas

• Matemática em destaque: um bloco $$ … $$ ou \[ … \] em uma ou mais linhas próprias, e um bloco de código delimitado com math como linguagem
• Matemática inline: $…$ ou \(…\) que abre e fecha na mesma linha, como $E = mc^2$ ou \(a^2 + b^2 = c^2\)

​

Retomar conversas anteriores

• Títulos de sessão: novas sessões recebem títulos gerados por IA com base na sua primeira mensagem.
• Renomear e arquivar: passe o cursor sobre uma sessão para exibir essas ações. Renomeie para dar a ela um título descritivo ou arquive para movê-la para o grupo Archived sessions na parte inferior da lista.
• Conversas ausentes com claudeProcessWrapper definido: atualize a extensão para a versão 2.1.304 ou posterior. A lista passa então a incluir as conversas que estavam ausentes, junto com as sessões que claude -p ou o Agent SDK iniciaram neste workspace.

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• Uma sessão: expanda Archived sessions e clique em Unarchive session.
• Todas as sessões arquivadas de uma vez: passe o cursor sobre o cabeçalho Archived sessions na lista de sessões da Activity Bar e clique no ícone de desarquivar. Requer o Claude Code v2.1.277 ou posterior.

• A extensão escolhe o modo de permissão inicial a partir de claudeCode.initialPermissionMode ou de uma escolha que é mantida de uma conversa anterior
• Você tem claudeCode.claudeProcessWrapper configurado
• Uma regra de negação remove a ferramenta ExitPlanMode

​

Retomar sessões na nuvem do claude.ai

​

Verificar conta e uso

• Plano do claude.ai: barras de uso para os limites do seu plano, como a sessão atual e a semana. Cada barra mostra quanto tempo falta para o limite ser redefinido. A caixa de diálogo também detalha o que está contribuindo para os limites do seu plano:
  • Recomendações: alterações que reduzem o seu uso, uma por linha com a parcela do uso recente que ela aborda, como Trim ~/code/api/CLAUDE.md · 49k tokens per request
  • Botão de correção: para que o Claude Code aplique as recomendações que puder, clique no botão abaixo delas, como Fix both. Para saber em quais linhas o botão atua e o que acontece em seguida na sua sessão, consulte Aplicar recomendações com o atalho de correção. Requer o Claude Code v2.1.305 ou posterior. O botão não é exibido enquanto o Remote Control estiver conectado. Se um aviso informar The usage fix wasn’t fully sent. Open usage and try again. depois que o Remote Control se conectou, desconecte o Remote Control antes de tentar novamente.
  • Atribuição: tabelas que mostram quanto do uso veio de cada skill, subagente, plugin e servidor MCP
  Use a alternância Day e Week para alternar entre as últimas 24 horas e os últimos 7 dias. Os números são aproximados e calculados a partir das sessões locais nesta máquina, portanto o uso de outros dispositivos ou do claude.ai não está incluído.
• Outros logins: quando os limites do plano não se aplicam ao seu login, como em um provedor terceirizado ou com uma chave de API, a seção Usage mostra o custo e o uso de tokens da própria sessão. O /usage da CLI mostra os mesmos totais no seu bloco Session. A lista de sessões na Activity Bar também mostra os totais da sessão ativa abaixo do cabeçalho Account & usage. Requer o Claude Code v2.1.277 ou posterior.

​

Retroceder com checkpoints

• Fork conversation from here: inicia um novo branch da conversa a partir desta mensagem, mantendo todas as alterações de código intactas
• Rewind code to here: reverte as alterações de arquivos até este ponto da conversa, mantendo o histórico completo da conversa
• Fork conversation and rewind code: inicia um novo branch da conversa e reverte as alterações de arquivos até este ponto

​

Personalize seu fluxo de trabalho

​

Escolha onde o Claude fica

• Barra lateral secundária: o lado direito da janela. Mantém o Claude visível enquanto você programa.
• Barra lateral primária: a barra lateral esquerda com ícones para Explorer, Search etc.
• Área do editor: abre o Claude como uma aba ao lado dos seus arquivos. Útil para tarefas paralelas.

​

Continue conversas após um recarregamento

• Aba do editor: a conversa volta com sua aba.
• Barra lateral: a conversa volta se você enviou uma mensagem ou se o Claude respondeu nela nos últimos 10 minutos. Se ela não voltar, retome a conversa a partir do Histórico de sessões.

​

Etapas interrompidas após um recarregamento

​

Desative a continuação após um recarregamento

​

Uma conversa não foi reaberta

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• Para abri-la mesmo assim: clique em Open it anyway ou escolha a conversa no Histórico de sessões. Depois que a conversa terminar de abrir, ela volta normalmente após recarregamentos posteriores.
• Se o painel parar de responder enquanto a conversa carrega: recarregue a janela. Um novo chat é aberto.
• Para deixá-la fechada: continue trabalhando no novo chat. O aviso desaparece assim que você envia um prompt.

​

Execute várias conversas

​

Organize sessões em grupos

• Agrupar ou desagrupar uma sessão: clique com o botão direito em uma sessão para criar um grupo a partir dela, movê-la para um grupo existente ou removê-la de seu grupo. Cada sessão pertence a um grupo por vez, então movê-la para outro grupo a remove do primeiro.
• Mover várias sessões de uma vez: clique com Cmd (Mac) / Ctrl (Windows/Linux) em cada sessão, ou clique com Shift para selecionar um intervalo, e então clique com o botão direito na seleção.
• Agrupar uma sessão a partir de sua aba: execute Claude Code: Add Session Tab to Group na Command Palette e, em seguida, escolha ou crie um grupo. Requer o Claude Code v2.1.257 ou posterior.
• Renomear ou excluir um grupo: clique com o botão direito no cabeçalho de um grupo. Excluir um grupo remove apenas o grupo, e suas sessões voltam para a lista não agrupada.

​

Filtre a lista de sessões

• Active: ative esta opção para mostrar apenas as sessões que precisam da sua entrada, estão em andamento ou não foram lidas, além da sessão na aba do Claude que você focou por último.
• Filtrar por status: clique no ícone de funil e marque Needs input, Working ou Completed para mostrar as sessões em qualquer um desses estados. Marque Open ou Closed para filtrar conforme a sessão esteja aberta ou não. Uma sessão é considerada aberta quando tem uma aba nesta janela ou está em execução em outro processo do Claude Code nesta máquina, como em um terminal.

​

Mude para o modo terminal

​

Gerenciar plugins

​

Instalar plugins

• Plugins instalados aparecem no topo com interruptores para ativá-los ou desativá-los.
  • Se você desativar um plugin que o .claude/settings.json compartilhado do seu projeto ativa, a extensão pergunta primeiro: Disable for me o desativa apenas para você, enquanto Disable for everyone altera o arquivo compartilhado.
  • Um plugin que não conseguiu carregar mostra um motivo curto em sua linha. Clique no motivo para ver o que você pode fazer a respeito, incluindo copiar a mensagem de erro completa para consultar em Solução de problemas de plugins.
• Plugins disponíveis dos seus marketplaces configurados aparecem abaixo
• Pesquise para filtrar plugins por nome ou descrição
• Clique em Install em qualquer plugin disponível

• Install for you: disponível em todos os seus projetos (escopo de usuário)
• Install for this project: compartilhado com os colaboradores do projeto (escopo de projeto)
• Install locally: apenas para você, apenas neste repositório (escopo local)

​

Desinstalar plugins

• Um plugin que o .claude/settings.json compartilhado do seu projeto ativa: escolha Disable for me, que mantém o plugin instalado para seus colaboradores, ou Uninstall for everyone, que remove a instalação do projeto com --keep-data, de modo que o diretório de dados salvos do plugin permanece. Se você já desativou o plugin para si mesmo, o ícone de lixeira remove sua própria instalação sem a pergunta.
• Caso contrário, a última instalação de um plugin com dados salvos: escolha se deseja manter ou excluir os dados; Keep é o padrão

​

Compartilhar um link de instalação de plugin

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

• Nome do plugin: no máximo 100 caracteres, começando com uma letra ou dígito ASCII e, no restante, usando apenas letras ASCII, dígitos, ., _ e -.
• Origem do marketplace: apenas as formas que o parâmetro marketplace lista, portanto não um caminho local, um endereço http:// ou o nome do marketplace, como claude-plugins-official. Uma URL https:// não pode conter nome de usuário, senha ou query string.
• Ref do Git: para fixar o marketplace em um branch ou tag, acrescente a ref à origem após %23, a forma codificada de #, como em marketplace=owner/repo%23v1.0. Um link com um # não codificado falha. Marketplaces na organização anthropics do GitHub não podem ser fixados em um link.

• O marketplace não lista um plugin com esse nome: a caixa de diálogo informa que o plugin não foi encontrado. Verifique o valor de plugin em relação à listagem do marketplace.
• O plugin já está instalado: a caixa de diálogo informa isso, e nada muda.
• Um marketplace diferente com o mesmo nome já foi adicionado: a caixa de diálogo informa que o marketplace do link não foi adicionado, e nada é instalado.

​

Gerenciar marketplaces

• Insira um repositório do GitHub, uma URL ou um caminho local para adicionar um novo marketplace
• Clique no ícone de atualizar para atualizar a lista de plugins de um marketplace
• Clique no ícone de lixeira para remover um marketplace. Removê-lo desinstala todos os plugins que você instalou a partir dele, então uma confirmação nomeia esses plugins primeiro

​

Plugins que desenham no painel

• Um painel ao lado da conversa ou acima da caixa de prompt
• Uma notificação toast ou uma linha de status acima da caixa de prompt
• Uma mensagem ou uma chamada de ferramenta desenhada à maneira do próprio plugin

• From the token-chart plugin: o plugin desenhou ou imprimiu isto, ou este cartão é o plugin perguntando algo a você
• Edited by the token-chart plugin: o plugin alterou algo que o Claude Code desenha, como uma chamada de ferramenta
• Prompt from the token-chart plugin: o plugin enviou esta mensagem em seu nome

​

Automatize tarefas do navegador com o Chrome

@browser go to localhost:3000 and check the console for errors

• Ativar o Chrome por padrão: faça com que cada sessão se conecte ao seu navegador ao iniciar, sem precisar digitar @browser
• Prompts de permissão em sessões do VS Code: quando o Claude Code pede sua confirmação antes de uma ação no navegador
• Usar o Claude Code com o Chrome: instruções de configuração, a lista completa de recursos e solução de problemas

​

Trabalhar com git

​

Criar commits e pull requests

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

​

Executar trabalho em segundo plano

​

Mover um comando ou subagente em execução para segundo plano

• Momento: a ação aparece quando um comando está em execução há cerca de dois segundos, ou assim que Claude começa a esperar por um subagente que ele iniciou a partir da conversa principal.
• Depois de clicar: Claude para de esperar e continua o turno. O comando ou subagente continua em execução como uma tarefa em segundo plano que notifica Claude quando termina.

​

A ação Run in background não aparece abaixo de um subagente

• Spawned by the main agent: o subagente foi iniciado em segundo plano, então Claude não está esperando por ele e você não precisa fazer nada. Para que Claude espere pelos subagentes, consulte Deixar Claude esperar por um subagente.
• Spawned by nomeia outro subagente: a ação aparece apenas para subagentes que o agente principal iniciou, não para um subagente aninhado pelo qual outro subagente está esperando. Para encerrar o subagente aninhado antecipadamente, clique em Stop agent no cartão dele. O subagente que estava esperando então continua sem esse resultado.

​

Monitorar processos em segundo plano

​

Ver as chamadas de ferramenta de um subagente em segundo plano

​

Comandos e atalhos do VS Code

​

Abrir uma aba do VS Code a partir de outras ferramentas

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

​

Definir configurações

• Configurações da extensão no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com Cmd+, (Mac) ou Ctrl+, (Windows/Linux) e, em seguida, vá para Extensions > Claude Code. Você também pode digitar / e selecionar General config… para abrir as configurações.
• Configurações do Claude Code em ~/.claude/settings.json: compartilhadas entre a extensão e a CLI. Use-as para comandos permitidos, variáveis de ambiente, hooks e servidores MCP. Com o Claude Code v2.1.283 ou posterior, elas também são uma das entradas que determinam o modo de permissão em que as conversas começam; em versões anteriores, isso vale apenas nos planos Pro, Max e Team. Alternar modos de permissão lista a ordem. Consulte Configurações para obter detalhes.

​

Configurações da extensão

​

Usar provedores terceirizados

​

Usar um leitor de tela

• Respostas do Claude: a extensão anuncia cada resposta uma única vez, quando ela está completa, e permanece em silêncio enquanto o texto é transmitido. Seu leitor de tela lê blocos de código como um resumo da contagem de linhas, lê links pelo rótulo e lê tabelas célula por célula; a resposta completa continua legível na transcrição.
• Requisições de permissão e perguntas: a extensão anuncia uma requisição quando o prompt de permissão aparece, nomeando a ferramenta que o Claude quer usar. Ela anuncia da mesma forma quando o Claude faz uma pergunta a você e quando o Claude conclui um plano e aguarda sua revisão.
• Mudanças de status: a extensão anuncia quando o Claude começa a trabalhar, quando o Claude está pronto para sua entrada e quando o Claude Code começa a compactar a conversa. Se você enviar um prompt enquanto os hooks SessionStart da sessão ainda estiverem em execução, seu leitor de tela também diz “Running start-up hooks.”
• Mensagens na fila: quando você envia uma mensagem enquanto o Claude está trabalhando, a extensão anuncia “Message queued.” para essa mensagem.
• Erros e prompts de modelo: a extensão anuncia erros na conversa e anuncia quando o prompt de consentimento de créditos de uso ou o prompt de requisição sinalizada aparece.

​

Usar o painel de chat pelo teclado

• Suas mensagens: “You”
• Mensagens do Claude: “Claude”
• Etapas de ferramenta: “Claude” mais o nome da ferramenta, como “Claude, Bash”
• Blocos de pensamento: “Claude, thinking”

• Com essa opção em foco, pressione a tecla de seta Left ou Right. A extensão anuncia cada destino à medida que você passa para ele. As teclas de seta requerem o Claude Code v2.1.268 ou posterior.
• Clique no destino no rótulo.

​

Extensão do VS Code vs. CLI do Claude Code

​

Executar a CLI no VS Code

​

Alternar entre a extensão e a CLI

​

Conectar a ferramentas externas com MCP

• Adicionar servidores
• Remover servidores salvos no escopo local, de usuário ou de projeto
• Ativar ou desativar servidores
• Reconectar a um servidor
• Gerenciar a autenticação OAuth

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

​

O servidor MCP integrado do IDE

• Abre diffs no visualizador de diff nativo do VS Code
• Lê sua seleção atual para @-menções
• Pede ao VS Code para executar células quando você está trabalhando em um notebook Jupyter

• Mensagens na fila: se você colocar uma mensagem na fila enquanto Claude trabalha, ela mantém a seleção que você tinha quando pressionou Enter, independentemente do que você selecionar depois.
• Arquivos sensíveis: para excluir um arquivo sensível como .env, adicione uma regra de negação de Read para o caminho dele. Uma regra de negação correspondente impede que tanto o texto selecionado quanto o aviso de arquivo aberto desse arquivo cheguem a Claude.
• Attach Open File desativado: se você desativar a configuração Attach Open File, a CLI recebe o caminho do arquivo ativo somente enquanto você tiver texto selecionado nele.

• Transporte: ws:// não criptografado. Como o socket é somente loopback, qualquer processo capaz de capturar o tráfego também pode ler o token do arquivo de bloqueio, então o TLS não acrescentaria proteção.
• Token de autenticação: cada ativação da extensão gera um novo token de autenticação aleatório e o grava em um arquivo de bloqueio em ~/.claude/ide/<port>.lock. A CLI precisa apresentar o token como o cabeçalho X-Claude-Code-Ide-Authorization para se conectar.
• Permissões do arquivo de bloqueio: o arquivo de bloqueio tem permissões 0600 em um diretório 0700, de modo que somente o usuário que executa o VS Code pode lê-lo. Se CLAUDE_CONFIG_DIR estiver definida, o arquivo de bloqueio é gravado em $CLAUDE_CONFIG_DIR/ide/.

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. O código é inserido como uma nova célula no final do notebook ativo.
2. O VS Code rola a célula até que ela fique visível.
3. Um Quick Pick nativo pede que você escolha Execute ou Cancel.

​

Corrigir problemas comuns

​

A extensão não instala

• Certifique-se de ter uma versão compatível do VS Code (1.94.0 ou posterior)
• Verifique se o VS Code tem permissão para instalar extensões
• Tente instalar diretamente pelo VS Code Marketplace

​

Ícone Spark não visível

1. Abra um arquivo: O ícone exige que um arquivo esteja aberto. Ter apenas uma pasta aberta não é suficiente.
2. Verifique a versão do VS Code: Requer 1.94.0 ou posterior. Verifique em Help > About
3. Reinicie o VS Code: Execute “Developer: Reload Window” na Paleta de Comandos
4. Desative extensões conflitantes: Desative temporariamente outras extensões de IA (Cline, Continue etc.)
5. Verifique a confiança do workspace: A extensão não funciona no Modo Restrito

​

Cmd+Esc não faz nada no macOS

1. Abra os Ajustes do Sistema
2. Vá para Teclado, depois Atalhos de Teclado, depois Controles de Jogo
3. Desmarque a caixa de seleção Game Overlay

​

Uma conversa retomada fica em branco no início

​

O painel para de responder sempre que um recarregamento reabre uma conversa

​

Uma fórmula aparece como LaTeX bruto

• A fórmula é inline e o painel não a trata como matemática: peça ao Claude para enviá-la novamente como um bloco $$ em linhas próprias. O painel deixa uma fórmula inline como foi escrita quando o texto entre seus delimitadores $…$:
  • É mais do que aritmética simples, mas não tem nenhum caractere como =, + ou ^ que o marque como matemática, como em $O(n log n)$
  • Começa com um dígito e não tem nenhum caractere desse tipo, como em $30$ e $1/N$
  • Tem espaços dentro dos cifrões, como em $ x^2 $
  • Tem mais de 60 caracteres
  • Está dividido em duas linhas. Uma fórmula \(…\) dividida em duas linhas também não é renderizada.
• A fórmula tem um erro de sintaxe TeX: peça ao Claude para reescrevê-la com o erro corrigido.
• A fórmula define uma macro: uma fórmula com uma definição de macro como \newcommand ou \def aparece como foi escrita. Peça ao Claude para reescrevê-la sem a macro.
• A fórmula contém um % sem escape: peça ao Claude para reescrevê-la com \% para o sinal de porcentagem.
• A fórmula é grande demais: uma fórmula com mais de 8.192 caracteres, ou uma cuja saída renderizada seria muito maior do que seu código-fonte TeX, aparece como foi escrita. Peça ao Claude para dividi-la em fórmulas menores ou para escrevê-la de forma mais compacta.
• A fórmula vem depois de uma grande quantidade de matemática: dentro de um bloco de texto em uma resposta, o painel renderiza as fórmulas em ordem até um limite. Uma fórmula posterior que ultrapassaria o limite aparece como foi escrita. Peça ao Claude para enviar novamente, sozinha, a fórmula de que você precisa.

​

O Claude Code nunca responde

1. Verifique sua conexão com a internet: Certifique-se de ter uma conexão estável com a internet
2. Inicie uma nova conversa: Tente iniciar uma nova conversa para ver se o problema persiste
3. Experimente a CLI: Execute claude no terminal para ver se você recebe mensagens de erro mais detalhadas

​

Desinstalar a extensão

1. Pressione Cmd+Shift+X no Mac ou Ctrl+Shift+X no Windows/Linux para abrir a visualização de Extensões
2. Pesquise por “Claude Code”
3. Clique em Uninstall

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

​

Próximos passos

• Explore fluxos de trabalho comuns para aproveitar ao máximo o Claude Code
• Configure servidores MCP para estender os recursos do Claude com ferramentas externas. Adicione-os e gerencie-os com /mcp no painel de chat.
• Defina as configurações do Claude Code para personalizar comandos permitidos, hooks e muito mais. Essas configurações são compartilhadas entre a extensão e a CLI.
• Revise as proteções de segurança e o uso de dados do Claude Code