Use Claude Code with Chrome

Claude Code integra-se com a extensão Claude in Chrome do navegador para oferecer recursos de automação de navegador a partir da CLI ou da extensão VS Code. Construa seu código, depois teste e depure no navegador sem trocar de contexto. Claude abre novas abas para tarefas do navegador e compartilha o estado de login do seu navegador, para que possa acessar qualquer site em que você já esteja conectado. As ações do navegador são executadas em uma janela Chrome visível em tempo real. Quando Claude encontra uma página de login ou CAPTCHA, ele pausa e pede que você a manipule manualmente. A extensão coleta as abas que Claude abre em um grupo de abas do Chrome vinculado à sua sessão. Em sessões locais, se Claude Code fecha esse grupo quando a sessão termina depende de como ela termina:

Quando você digita /clear, Claude Code fecha o grupo, incluindo páginas abertas, a menos que o trabalho que sobrevive ao clear ainda esteja em execução
Quando você muda de sessões com um comando como /resume, sai de Claude Code ou executa um /clear enquanto o trabalho que sobrevive a ele ainda está em execução, Claude Code fecha o grupo apenas se ele contiver nada além de novas abas vazias, para que as páginas que você ainda pode estar lendo permaneçam abertas

A integração com Chrome funciona com Google Chrome e Microsoft Edge. Claude Code também detecta a extensão e configura a conexão em outros navegadores baseados em Chromium, incluindo Brave, Arc, Vivaldi e Opera. A integração com Chrome não é suportada no Windows Subsystem for Linux (WSL).

Recursos

Com Chrome conectado, você pode encadear ações do navegador com tarefas de codificação em um único fluxo de trabalho:

Depuração ao vivo: leia erros de console e estado do DOM diretamente, depois corrija o código que os causou
Verificação de design: construa uma interface a partir de um mock do Figma, depois abra-a no navegador para verificar se corresponde
Teste de aplicativo web: teste validação de formulário, verifique regressões visuais ou verifique fluxos de usuário
Aplicativos web autenticados: interaja com Google Docs, Gmail, Notion ou qualquer aplicativo em que você esteja conectado sem conectores de API
Extração de dados: extraia informações estruturadas de páginas web e salve-as localmente
Automação de tarefas: automatize tarefas repetitivas do navegador como entrada de dados, preenchimento de formulários ou fluxos de trabalho em vários sites
Uploads de arquivo: anexe arquivos da sua máquina para carregar em campos de upload em páginas web
Gravação de sessão: grave interações do navegador como GIFs para documentar ou compartilhar o que aconteceu

Pré-requisitos

Antes de usar Claude Code com Chrome, você precisa de:

Google Chrome, Microsoft Edge ou outro navegador baseado em Chromium, como Brave, Arc, Vivaldi ou Opera
Extensão Claude in Chrome versão 1.0.36 ou superior, disponível na Chrome Web Store
Claude Code
Um plano Anthropic direto (Pro, Max, Ultra, Team ou Enterprise)

Em organizações Enterprise que têm HIPAA habilitado, o Claude in Chrome fica desativado por padrão, e um Owner pode ativá-lo em Organization settings > Claude in Chrome. Seu Business Associate Agreement (BAA) com a Anthropic não cobre dados enviados a sites de terceiros através do Claude in Chrome. Consulte o Guia de Implementação para obter uma lista de Serviços Elegíveis. A integração com Chrome também requer fazer login com /login. Se você se autenticar com uma chave de API ou um token de longa duração de claude setup-token, Claude Code mantém a integração com Chrome desativada, mesmo quando você passa --chrome. A extensão do navegador não consegue se autenticar com essas credenciais.

A integração com Chrome não está disponível através de provedores terceirizados como Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft Foundry. Se você acessa Claude exclusivamente através de um provedor terceirizado, você precisa de uma conta claude.ai separada para usar este recurso.

Comece na CLI

Inicie Claude Code com Chrome

Inicie Claude Code com a flag --chrome:

claude --chrome

Na primeira vez que você inicia com Chrome, Claude Code mostra um diálogo único que apresenta a integração e explica como as permissões de site funcionam. Pressione Enter para continuar.Para ativar Chrome para futuras sessões sem a flag, consulte Ativar Chrome por padrão.

Peça a Claude para usar o navegador

Este exemplo navega para uma página, interage com ela e relata o que encontra, tudo a partir do seu terminal ou editor:

Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear

Se Claude Code solicitar permissão antes de uma ação do navegador, aprove-a. O diálogo começa com Claude in Chrome wants to e oferece uma opção para permitir todas as ações naquele site durante a sessão. Claude abre uma nova aba e inicia a tarefa.

Execute /chrome a qualquer momento para verificar o status da conexão, gerenciar permissões, reconectar a extensão ou escolher qual navegador conectado usar. A integração está funcionando quando o painel de status mostra “Status: Enabled” e “Extension: Installed”. Se mais de um navegador estiver conectado, você escolhe qual Claude usa. Quando uma ação do navegador começa antes de você ter escolhido, Claude solicita que você escolha um. Para alternar navegadores depois, execute /chrome e selecione Select browser…. Claude continua usando sua escolha mesmo quando outro navegador se conecta. Para VS Code, consulte automação de navegador em VS Code.

Instale a extensão quando Claude pedir

Quando Claude precisa do seu navegador em uma sessão interativa e Claude Code não detecta a extensão, Claude Code mostra um prompt de instalação intitulado “Claude wants to use your browser”. Claude Code pergunta no máximo uma vez por sessão. O prompt oferece três opções:

Install extension: abre a página de instalação da extensão no seu navegador e inicia uma configuração guiada. Claude Code aguarda a instalação, conecta a extensão e ativa as ferramentas do navegador na mesma sessão. Quando a conexão estiver pronta, selecione “Continue with browser tools” e Claude retoma a tarefa no seu navegador. Você pode sair da configuração selecionando “Continue without browser tools” e terminar depois com /chrome.
Not now: continua a tarefa sem ferramentas do navegador. Claude Code pode perguntar novamente em uma sessão posterior.
Don’t ask again: interrompe o prompt em futuras sessões. Você ainda pode configurar a integração a qualquer momento com /chrome.

Duas políticas MCP gerenciadas desativam o prompt:

Se sua organização bloqueia o servidor MCP claude-in-chrome com a configuração gerenciada deniedMcpServers, Claude Code não mostra o prompt de instalação.
Se sua organização implanta um arquivo managed-mcp.json sem permitir Claude in Chrome junto com o conjunto gerenciado, Claude Code não mostra o prompt de instalação.

Ativar Chrome por padrão

Para conectar o Chrome sem passar --chrome toda vez, execute /chrome em uma sessão da CLI e selecione Enabled by default. Na extensão VS Code, digite /chrome na caixa de prompt e ative a opção Enabled by default. As duas compartilham uma única configuração, portanto ativá-la em qualquer um dos lugares a ativa tanto para a CLI quanto para o VS Code. Com a configuração ativada e Claude Code v2.1.287 ou posterior, cada sessão do VS Code se conecta ao seu navegador ao iniciar, para que Claude possa usá-lo antes de você digitar @browser. Em versões anteriores, ou com a configuração desativada, uma sessão do VS Code se conecta quando você digita @browser. Claude Code inicia normalmente quando Chrome não está em execução.

Ativar Chrome por padrão aumenta o uso de contexto, pois as ferramentas do navegador e suas instruções estão sempre carregadas. Se você notar aumento no consumo de contexto, desative a configuração e conecte apenas quando necessário, com --chrome na CLI ou digitando @browser na caixa de prompt do VS Code.

Responder ao diálogo de inicialização

Se o diálogo “Claude in Chrome extension detected” aparecer quando você iniciar claude, sua resposta altera a configuração Enabled by default:

Yes, use my browser: ativa a configuração e conecta esta sessão
No, keep browser tools off, ou Esc: desativa a configuração, e Claude Code deixa de oferecer a configuração do Chrome

Para alterar sua resposta para sessões posteriores, execute /chrome.

Gerenciar permissões de site

As permissões no nível do site são herdadas da extensão Chrome. Gerencie permissões nas configurações da extensão Chrome para controlar quais sites Claude pode navegar, clicar e digitar. No modo auto, quando o próprio classificador do modo auto aprova uma chamada do navegador para um site, a extensão pula sua própria verificação por site para essa chamada, a menos que suas regras de permissão neguem qualquer site a Claude in Chrome.

Prompts de permissão em sessões do VS Code

Em uma sessão do VS Code, quando Claude Code pergunta a você antes de uma ação do navegador, o prompt aparece como um cartão no painel de chat. Quando a ação tem como alvo um site que você não permitiu, o cartão também oferece a opção de permitir esse site. Em uma sessão que se conectou ao seu navegador ao iniciar porque Enabled by default está ativado, Claude Code pergunta a você antes de ações do navegador em um site que você não permitiu, nos modos de permissão Manual, Edit automatically, Auto e Bypass permissions. Nos modos de permissão Auto e Bypass permissions, isso se aplica até que você digite @browser nessa sessão.

Ferramentas do navegador no modo de planejamento

No modo de planejamento, um prompt de permissão aparece antes de Claude gravar um GIF ou abrir uma nova aba. Em uma sessão interativa da CLI, se o modo de bypass de permissões estiver disponível e a busca de feature flags estiver desativada, essas chamadas são executadas sem um prompt. Uma chamada tabs_context_mcp também solicita quando define createIfEmpty, e o mesmo ocorre com uma chamada browser_batch que inclui qualquer uma dessas ações.

Fluxos de trabalho de exemplo

Estes exemplos mostram maneiras comuns de combinar ações do navegador com tarefas de codificação. Execute /mcp, selecione claude-in-chrome e, em seguida, selecione View tools para ver a lista completa de ferramentas de navegador disponíveis.

Teste um aplicativo web local

Ao desenvolver um aplicativo web, peça a Claude para verificar se suas alterações funcionam corretamente:

I just updated the login form validation. Can you open localhost:3000,
try submitting the form with invalid data, and check if the error
messages appear correctly?

Claude navega para seu servidor local, interage com o formulário e relata o que observa.

Depurar com logs de console

Claude pode ler a saída do console para ajudar a diagnosticar problemas. Diga a Claude quais padrões procurar em vez de pedir toda a saída do console, pois os logs podem ser verbosos:

Open the dashboard page and check the console for any errors when
the page loads.

Claude lê as mensagens do console e pode filtrar padrões específicos ou tipos de erro.

Automatizar preenchimento de formulários

Acelere tarefas repetitivas de entrada de dados:

I have a spreadsheet of customer contacts in contacts.csv. For each row,
go to the CRM at crm.example.com, click "Add Contact", and fill in the
name, email, and phone fields.

Claude lê seu arquivo local, navega pela interface web e insere os dados para cada registro.

Carregar arquivos em páginas web

Claude pode anexar arquivos de sua máquina para fazer upload em campos de uma página. Claude Code lê o arquivo e envia seu conteúdo para o navegador, portanto os uploads funcionam em sessões locais e remotas. Este exemplo anexa um arquivo de log a um formulário:

Open the bug tracker at bugs.example.com, create a new issue,
and attach logs/session.log to it

Se Claude se recusar a anexar um arquivo ou um upload falhar, verifique estas causas:

Permissões: Claude pode fazer upload de um arquivo apenas quando a sessão tem permissão para lê-lo, portanto regras de permissão que negam acesso Read a um arquivo também bloqueiam seu upload.
Tamanho: um único upload pode incluir até 10 MB de arquivos no total.
Hard links: Claude recusa arquivos que possuem múltiplos hard links, o que é comum dentro de lojas de gerenciadores de pacotes como node_modules. Copie o arquivo e faça upload da cópia.
Nomes de credenciais: Claude recusa um arquivo cujo nome ou pasta seja um daqueles em que credenciais são mantidas, como .env, um arquivo .pem ou .key, ou qualquer coisa dentro de .ssh. Requer Claude Code v2.1.293 ou posterior.

Rascunhar conteúdo no Google Docs

Use Claude para escrever diretamente em seus documentos sem configuração de API:

Draft a project update based on the recent commits and add it to my
Google Doc at docs.google.com/document/d/abc123

Claude abre o documento, clica no editor e digita o conteúdo. Isso funciona com qualquer aplicativo web em que você esteja conectado: Gmail, Notion, Sheets e muito mais.

Extrair dados de páginas web

Extraia informações estruturadas de sites:

Go to the product listings page and extract the name, price, and
availability for each item. Save the results as a CSV file.

Claude navega para a página, lê o conteúdo e compila os dados em um formato estruturado.

Executar fluxos de trabalho em vários sites

Coordene tarefas em vários sites:

Check my calendar for meetings tomorrow, then for each meeting with
an external attendee, look up their company website and add a note
about what they do.

Claude trabalha em abas para reunir informações e concluir o fluxo de trabalho.

Gravar um GIF de demonstração

Crie gravações compartilháveis de interações do navegador:

Record a GIF showing how to complete the checkout flow, from adding
an item to the cart through to the confirmation page.

Claude grava a sequência de interação e a salva como um arquivo GIF. A gravação captura tudo o que está visível no navegador, incluindo detalhes da conta em páginas conectadas, portanto revise-a antes de compartilhá-la fora de sua equipe.

Salvar capturas de tela em disco

Peça a Claude para manter uma captura de tela como um arquivo:

Take a screenshot of the checkout page and save it to disk

Claude salva a imagem em disco e relata o caminho do arquivo.

Troubleshooting

Extensão não detectada

Se Claude Code não conseguir detectar a extensão Chrome:

Verifique se a extensão Chrome está instalada e ativada em chrome://extensions
Verifique se Claude Code está atualizado executando claude --version
Verifique se Chrome está em execução
Execute /chrome e selecione “Reconnect extension” para restabelecer a conexão
Se o problema persistir, reinicie Claude Code e Chrome

Na primeira vez que você ativa a integração com Chrome, Claude Code instala um arquivo de configuração do host de mensagens nativas. Chrome lê este arquivo na inicialização, portanto, se a extensão não for detectada na sua primeira tentativa, reinicie Chrome para pegar a nova configuração. Claude Code abre uma aba do navegador solicitando que você conecte a extensão apenas nessa primeira instalação. Claude Code não a reabre quando uma sessão posterior reescreve o arquivo de configuração, por exemplo após alternar entre compilações ou diretórios de configuração. Se a conexão ainda falhar, verifique se o arquivo de configuração do host existe em: Para Chrome:

macOS: ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Linux: ~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Windows: verifique HKCU\Software\Google\Chrome\NativeMessagingHosts\ no Registro do Windows

Para Edge:

macOS: ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Linux: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Windows: verifique HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ no Registro do Windows

Outros navegadores baseados em Chromium leem o mesmo arquivo de seu próprio diretório de configuração, nomeado de acordo com o navegador. Por exemplo, Brave no macOS usa ~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/, e no Windows cada navegador tem sua própria chave de registro, como HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\.

As configurações do projeto não podem ativar o Chrome

Este aviso no seu terminal significa que o projeto em que você está trabalhando tentou ativar a integração com Chrome, e Claude Code não permitiu:

Claude Code ignored CLAUDE_CODE_ENABLE_CFC in this project's settings: a project can't turn on Claude in Chrome. To turn it on yourself, run /chrome or start with --chrome.

O .claude/settings.json ou .claude/settings.local.json do projeto define CLAUDE_CODE_ENABLE_CFC como 1 em seu bloco env para ativar a integração com Chrome. Claude Code não aplicou essa configuração, portanto a integração com Chrome está desativada nesta sessão e Claude não tem ferramentas do navegador. Claude Code ignora a configuração porque esses arquivos ficam armazenados no diretório do projeto, e um repositório que você clona não deve ser capaz de conectar Claude ao seu navegador. Você pode continuar trabalhando como está. Se quiser ferramentas do navegador, ou quiser que o aviso desapareça, faça uma das seguintes ações:

Para obter ferramentas do navegador agora: saia e inicie novamente com claude --chrome no seu shell.
Para obter ferramentas do navegador em sessões posteriores: execute /chrome no prompt do Claude Code e selecione Enabled by default. Isso se aplica às sessões que você iniciar depois, não à que está em execução.
Para interromper o aviso sem ferramentas do navegador: remova a linha CLAUDE_CODE_ENABLE_CFC do arquivo de configurações do projeto.

Navegador não respondendo

Se os comandos do navegador de Claude pararem de funcionar:

Verifique se uma caixa de diálogo modal (alerta, confirmação, prompt) está bloqueando a página. Caixas de diálogo JavaScript bloqueiam eventos do navegador e impedem que Claude receba comandos. Feche a caixa de diálogo manualmente, depois diga a Claude para continuar.
Peça a Claude para criar uma nova aba e tentar novamente
Reinicie a extensão Chrome desativando-a e reativando-a em chrome://extensions

Conexão cai durante sessões longas

O service worker da extensão Chrome pode ficar inativo durante sessões estendidas, o que quebra a conexão. Se as ferramentas do navegador pararem de funcionar após um período de inatividade, execute /chrome e selecione “Reconnect extension”. Ao executar /chrome, verifique a linha Status. Se ela indicar “Not connected”, a própria conexão da sessão em execução com o Chrome falhou. Selecione “Reconnect extension” para reiniciar essa conexão. Depois que a conexão for bem-sucedida, a página de reconexão da extensão é aberta no Chrome. Antes da v2.1.290, “Reconnect extension” apenas abria essa página e não reiniciava uma conexão com falha, portanto, se as ferramentas do navegador não voltarem em uma versão anterior, atualize Claude Code.

Extensão conectada a uma organização diferente

Se você pertence a mais de uma organização do claude.ai, a extensão deve estar conectada à mesma organização que Claude Code. Se as duas forem diferentes, as ferramentas do navegador de Claude retornam “Browser extension is not connected”, mesmo quando ambas usam a mesma conta claude.ai. Para ver a qual organização Claude Code está conectado, execute /status no prompt do Claude Code e leia a linha Organization.

Se você fizer logout da extensão, perderá os atalhos e as tarefas agendadas salvos nela. Tente primeiro as outras correções em Mensagens de erro comuns.

Para alterar a organização da extensão, faça logout nas configurações da extensão, depois faça login e selecione a organização que /status mostra.

Problemas específicos do Windows

No Windows, você pode encontrar:

Conflitos de named pipe (EADDRINUSE): se outro processo estiver usando o mesmo named pipe, reinicie Claude Code. Feche qualquer outra sessão de Claude Code que possa estar usando Chrome.
Erros de host de mensagens nativas: se o host de mensagens nativas falhar na inicialização, tente reinstalar Claude Code para regenerar a configuração do host.
Páginas de configuração falham ao abrir: atualize Claude Code. Antes da v2.1.211, a aba do navegador solicitando que você conecte a extensão poderia falhar ao abrir no Windows.

Mensagens de erro comuns

Estes são os erros mais frequentemente encontrados e como resolvê-los:

Erro	Causa	Solução
”Browser extension is not connected”	A extensão não está instalada e em execução no Chrome, a extensão está conectada a uma conta ou organização do claude.ai diferente da de Claude Code, ou a allowlist de IP da sua organização rejeita a conexão com `bridge.claudeusercontent.com`	Verifique se a extensão está conectada à mesma conta claude.ai e à mesma organização que Claude Code, reinicie Chrome e Claude Code, depois execute `/chrome` para reconectar. Se sua organização usa allowlist de IP e o erro persistir, consulte Organization IP allowlists and proxy egress
Extension shows “Not detected” in `/chrome`	A extensão Chrome não está instalada ou está desativada	Instale ou ative a extensão em `chrome://extensions`
”No tab available”	Claude tentou agir antes de uma aba estar pronta	Peça a Claude para criar uma nova aba e tentar novamente
”Receiving end does not exist”	O service worker da extensão ficou inativo	Execute `/chrome` e selecione “Reconnect extension"
"No browsers are connected”	O Chrome não está aberto com a extensão conectada à mesma conta e organização do claude.ai que Claude Code, ou Claude Code não consegue alcançar `bridge.claudeusercontent.com`	Confirme que o Chrome está aberto e que a extensão está conectada à mesma conta claude.ai e à mesma organização que Claude Code. Se estiver, verifique se sua rede permite que Claude Code alcance `bridge.claudeusercontent.com`, listado em Requisitos de acesso à rede

Veja também

Computer use: controle aplicativos nativos do macOS quando uma tarefa não pode ser feita em um navegador
Use Claude Code in VS Code: automação de navegador na extensão VS Code
Referência CLI: flags de linha de comando incluindo --chrome
Fluxos de trabalho comuns: mais maneiras de usar Claude Code
Dados e privacidade: como Claude Code manipula seus dados
Getting started with Claude in Chrome: documentação completa para a extensão Chrome, incluindo atalhos, agendamento e permissões

Primeiros passos

Conceitos principais

Use o Claude Code

Plataformas e integrações

Revisão de código e pull requests

Recursos

Pré-requisitos

Comece na CLI

Instale a extensão quando Claude pedir

Ativar Chrome por padrão

Responder ao diálogo de inicialização

Gerenciar permissões de site

Prompts de permissão em sessões do VS Code

Ferramentas do navegador no modo de planejamento

Fluxos de trabalho de exemplo

Teste um aplicativo web local

Depurar com logs de console

Automatizar preenchimento de formulários

Carregar arquivos em páginas web

Rascunhar conteúdo no Google Docs

Extrair dados de páginas web

Executar fluxos de trabalho em vários sites

Gravar um GIF de demonstração

Salvar capturas de tela em disco

Troubleshooting

Extensão não detectada

As configurações do projeto não podem ativar o Chrome

Navegador não respondendo

Conexão cai durante sessões longas

Extensão conectada a uma organização diferente

Problemas específicos do Windows

Mensagens de erro comuns

Veja também