A integração com Chrome funciona com Google Chrome e Microsoft Edge. Ainda não é suportada em Brave, Arc ou outros navegadores baseados em Chromium. Também 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
- 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:- Navegador Google Chrome ou Microsoft Edge
- Extensão Claude in Chrome versão 1.0.36 ou superior, disponível na Chrome Web Store para ambos os navegadores
- Claude Code
- Um plano Anthropic direto (Pro, Max, Team ou Enterprise)
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
1
Inicie Claude Code com Chrome
Inicie Claude Code com a flag Você também pode ativar Chrome dentro de uma sessão existente executando
--chrome:/chrome.2
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:A primeira ação do navegador solicita permissão para usar a skill
claude-in-chrome. Aprove-a e Claude abre uma nova aba e inicia a tarefa./chrome a qualquer momento para verificar o status da conexão, gerenciar permissões, reconectar a extensão ou escolher qual navegador conectado usar. Se mais de um navegador estiver conectado quando uma ação do navegador começar, Claude solicitará que você escolha um.
Para VS Code, consulte automação de navegador em VS Code.
Ativar Chrome por padrão
Para evitar passar--chrome em cada sessão, execute /chrome e selecione “Enabled by default”.
Na extensão VS Code, Chrome está disponível sempre que a extensão Chrome está instalada. Nenhuma flag adicional é necessária.
Ativar Chrome por padrão na CLI aumenta o uso de contexto, pois as ferramentas do navegador estão sempre carregadas. Se você notar aumento no consumo de contexto, desative esta configuração e use
--chrome apenas quando necessário.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.Ferramentas do navegador no modo de plano
No modo de plano, as chamadas de ferramentas do navegador que apenas leem a página ou o estado do navegador são executadas sem um prompt de permissão, e as chamadas que alteram o estado solicitam aprovação.- Chamadas somente leitura:
read_page,get_page_text,find, leitura de mensagens do console ou solicitações de rede, e captura de tela - Chamadas que alteram o estado: cliques, digitação, navegação, gerenciamento de abas e janelas, e gravação de um GIF
createIfEmpty em tabs_context_mcp, clear nos leitores de console e rede, ou save_to_disk em uma captura de tela, também solicita aprovação. Uma chamada browser_batch é executada sem um prompt apenas quando cada ação dentro dela é somente leitura.
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: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:Automatizar preenchimento de formulários
Acelere tarefas repetitivas de entrada de dados:Rascunhar conteúdo no Google Docs
Use Claude para escrever diretamente em seus documentos sem configuração de API:Extrair dados de páginas web
Extraia informações estruturadas de sites:Executar fluxos de trabalho em vários sites
Coordene tarefas em vários sites:Gravar um GIF de demonstração
Crie gravações compartilháveis de interações do navegador: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
/chromee selecione “Reconnect extension” para restabelecer a conexão - Se o problema persistir, reinicie Claude Code e 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
- 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
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”.
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.
Mensagens de erro comuns
Estes são os erros mais frequentemente encontrados e como resolvê-los: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