Extensão do Claude Code no Chrome: como funciona e o que continua rodando na sua máquina

Fala aí, beleza? Se você foi na Chrome Web Store caçar a extensão do Claude Code e voltou de mãos vazias, relaxa: não é você que está pesquisando errado

Não existe uma extensão de Chrome chamada "Claude Code"

A integração existe, mas vem por outro caminho: a extensão Claude in Chrome, publicada pela Anthropic na Chrome Web Store. É ela que o Claude Code usa pra ganhar automação de navegador, e a ordem sempre parte do Claude Code rodando no CLI ou na extensão do VS Code, nunca de dentro da extensão do browser

Ou seja: o motor continua na sua máquina

O navegador vira só os olhos e as mãos, e é exatamente essa distinção que a busca por extensão do Claude Code no Chrome costuma embolar. Bora separar cada caminho?

Três caminhos diferentes: extensão, Claude Code on the web e navegador do app desktop

Antes de instalar qualquer coisa, se liga: hoje existem TRÊS coisas distintas que as pessoas chamam de "Claude Code no navegador"

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Reparou? Só o primeiro caminho mexe no SEU Chrome

E tem mais um nome nessa sopa: o Claude Cowork passou a rodar no painel lateral do Chrome, anunciado em 12 de agosto de 2026, disponível em Max e Team, com liberação para Pro nas semanas seguintes. Ele é outro produto, não é o Claude Code de terminal com outra roupa

Detalhe que evita frustração: a extensão Claude in Chrome, sozinha, cuida do trabalho baseado na web. Quem lê e escreve os seus arquivos locais é o Claude Code rodando na sua máquina, no CLI ou no VS Code, e não a extensão do navegador 🙂

O que você precisa antes de conectar o Claude Code ao Chrome

Lista seca, sem enrolação:

• Extensão Claude in Chrome na versão 1.0.36 ou superior
• Claude Code v2.0.73 ou superior
• Login feito com /login: a integração não funciona com autenticação por API key nem com token de longa duração
• Plano Pro, Max, Team ou Enterprise direto da Anthropic. Via Amazon Bedrock, Google Cloud Agent Platform e Microsoft Foundry a integração não está disponível
• Nada de WSL: o Windows Subsystem for Linux não é suportado pela integração

Esse último item pega bastante gente no Windows, então confere isso ANTES de brigar com a ferramenta achando que é bug 😅

O requisito de plano direto da Anthropic também muda a conversa dentro de empresa, porque deixa de fora quem consome o modelo por provedor de nuvem. Se for o seu caso, costuma valer mais rodar um piloto com um time pequeno do que mexer no contrato inteiro de uma vez

Como conectar o Claude Code à extensão Claude in Chrome

A referência oficial da integração está na documentação do Claude Code

1. Inicie o Claude Code já com a flag do navegador

claude --chrome

O erro comum deste passo: achar que precisa fechar tudo e recomeçar. Se a sua sessão já está aberta, dá pra conectar sem reiniciar nada, é só digitar /chrome ali dentro

/chrome

2. Use /chrome pra checar o status da conexão, gerenciar permissões, acionar "Reconnect extension" e escolher qual navegador conectado usar

O erro comum deste passo: tratar /chrome como comando de estreia, de rodar uma vez e esquecer. Ele pode ser chamado a qualquer momento, e é ele que te salva quando a conexão cai no meio do trampo

3. Opcional: dentro de /chrome, ligue a opção "Enabled by default" e pare de digitar a flag em toda sessão

O erro comum deste passo: ligar isso e depois estranhar o contexto acabando mais rápido. A contrapartida está documentada: as ferramentas de navegador ficam sempre carregadas, e isso aumenta o uso de contexto

4. Revise as permissões por site

As permissões de nível de site que o Claude Code usa são HERDADAS da extensão do Chrome. O controle de em quais sites o Claude pode navegar, clicar e digitar mora nas configurações da extensão, e os sites já liberados ficam listados em "Your approved sites"

O erro comum deste passo: procurar essa configuração dentro do terminal. Ela não está lá, está na extensão

Ah, e tem o passo invisível: ao habilitar a integração pela primeira vez, o Claude Code instala um arquivo de configuração de native messaging host, e o Chrome lê esse arquivo na inicialização. Se a extensão não for detectada de cara, reinicia o Chrome…

O que o Claude consegue fazer no seu navegador (e o que pede aprovação)

As ferramentas de navegador se dividem em dois times bem diferentes, e entender essa divisão é o que separa "o Claude me ajudou a testar" de "o Claude clicou onde não devia"

Somente leitura:

• ler a página e pegar o texto
• encontrar elementos
• ler mensagens de console
• ler requisições de rede
• tirar screenshots

Alteração de estado:

• cliques e digitação
• navegação
• gerenciamento de abas e janelas
• gravar GIF

Percebeu o pulo do gato? O primeiro time só observa, o segundo age

No plan mode isso vira comportamento explícito: as chamadas que só leem a página ou o estado do navegador rodam sem pedir permissão, e as que alteram estado pedem aprovação

E mesmo com "Always allow actions on this site" ligado, o Claude continua pedindo aprovação explícita antes de certas ações. Ou seja, o "sempre permitir" não é um cheque em branco, beleza?

O fluxo que a Anthropic desenha em claude.com/chrome é bem direto: você constrói com o Claude Code no terminal, publica numa URL que o Claude alcance e depois testa e verifica no navegador com a extensão

É o ciclo de verificação, não o ciclo de construção. Faz diferença na expectativa

Problemas comuns ao ligar o Claude Code no Chrome

A extensão não é detectada na primeira tentativa

Sintoma: você roda o comando, o Claude Code diz que habilitou, e a extensão simplesmente não aparece conectada

Causa: na primeira habilitação o Claude Code instala o arquivo de configuração de native messaging host, e o Chrome só lê esse arquivo na inicialização

Solução: reiniciar o Chrome, depois rodar /chrome pra conferir o status

Como prevenir: já deixa o hábito de reiniciar o navegador logo após a primeira habilitação, aí você nunca passa por esse susto de novo

A conexão não sai com API key ou token de longa duração

Sintoma: tudo instalado, versões certas, e a integração continua indisponível

Causa: a integração exige login com /login. Com autenticação por API key ou por token de longa duração ela não funciona

Solução: autenticar com /login na sessão do Claude Code

Como prevenir: se a sua máquina é compartilhada com scripts que rodam por API key, separa o ambiente de uso interativo do ambiente automatizado, senão você vai ficar alternando credencial no susto

O ambiente não tem suporte, ponto

Sintoma: nada dá certo e você começa a desconfiar da própria sanidade haha

Causa: dois cenários documentados como sem suporte. WSL não é suportado, e planos consumidos via Amazon Bedrock, Google Cloud Agent Platform ou Microsoft Foundry não têm a integração do Chrome

Solução: nesses casos não tem gambiarra que resolva. Ou você muda de ambiente, ou usa o Claude Code sem a integração de navegador

Como prevenir: checar os requisitos ANTES de reservar a tarde pra configurar 😀

O que continua rodando na sua máquina

Vamos ao veredito honesto, porque a promessa de "programar pelo navegador" costuma ser maior que a entrega

Com a extensão, absolutamente nada do seu código migra pra lugar nenhum. O Claude Code segue no seu terminal ou no seu VS Code, lendo e escrevendo os seus arquivos como sempre fez. O navegador é periférico: olhos pra ler console, rede e tela, e mãos pra clicar e digitar

Quem quer execução de verdade fora da máquina precisa do outro caminho, o Claude Code on the web. Lá cada tarefa roda num sandbox isolado, com restrições de rede e de sistema de arquivos, e as interações com Git passam por um proxy seguro que limita o acesso a repositórios autorizados. A configuração de rede permite escolher a quais domínios o Claude Code pode se conectar a partir do sandbox, por exemplo pra baixar pacotes npm e rodar testes

E tem um detalhe que quase ninguém comenta: o handoff é de mão única no CLI

A flag --teleport puxa sessões da nuvem pro terminal, mas o CLI não empurra uma sessão local pra web. Quem faz esse caminho de volta é o app Desktop, pelo menu "Continue in"

Agora o alerta que eu não deixaria passar de jeito nenhum: a extensão compartilha o estado de login do navegador. O Claude enxerga a página em que você está, INCLUSIVE conteúdo atrás de autenticação. Sem a integração do 1Password ele não consegue filtrar conteúdo sensível, e a orientação oficial é não usar em sites sensíveis

Traduzindo: banco, painel de produção, e-mail da empresa? Fecha a aba antes de chamar o agente

Conclusão

No fim das contas, quem procurava a extensão do Claude Code no Chrome estava procurando a Claude in Chrome, e o que ela faz é dar ao Claude Code (que continua rodando na sua máquina, no CLI ou na extensão do VS Code) a capacidade de ler e agir no seu navegador

O próximo passo prático é simples: confere as versões (extensão 1.0.36 ou superior, Claude Code v2.0.73 ou superior), roda /chrome numa sessão que já está aberta e começa pelo fluxo de verificação, construindo no terminal e testando no navegador, antes de sair liberando as ações que alteram estado

Começa observando, depois você decide o quanto quer soltar a mão do agente 🙂

até o próximo post!