Extensão do navegador

A extensão do Context Code transforma seu navegador em um braço do agente: ele abre páginas, lê o conteúdo, clica, preenche formulários e tira capturas nas suas abas reais, com suas sessões iniciadas. É a diferença em relação ao Playwright: lá o agente abre um navegador separado e limpo; aqui ele trabalha onde você já está dentro (seu e-mail, seu painel, sua loja).

Tudo acontece no seu computador. A extensão só fala com o aplicativo de desktop por 127.0.0.1; nenhuma página, cookie ou captura sai para a internet por ela.

Navegadores compatíveis

Navegador	Pacote
Chrome, Edge, Brave, Opera, Vivaldi	`ContextCode-Extension-chrome.zip`
Firefox 121 ou superior	`ContextCode-Extension-firefox.zip`

Os dois estão na página de downloads do site, ao lado dos instaladores.

Instalação

Chrome, Edge, Brave, Opera e Vivaldi

Baixe o zip e descompacte em uma pasta que você não vá apagar (a extensão é carregada de lá).
Abra chrome://extensions (no Edge, edge://extensions; no Brave, brave://extensions).
Ative o Modo do desenvolvedor (canto superior direito) e clique em Carregar sem compactação.
Escolha a pasta descompactada. O ícone do Context Code aparece na barra; fixe-o para ter à mão.

Firefox

Baixe o zip (não precisa descompactar).
Abra about:debugging#/runtime/this-firefox e clique em Carregar extensão temporária; escolha o zip.
Clique no ícone do Context Code: na primeira vez ele pede para conceder acesso aos sites. É necessário para ler e agir nas páginas.

Emparelhar com o Context Code

No Context Code Desktop abra Canais e entre na aba Extensão do navegador.
Clique em Gerar código. Aparece um código de seis dígitos e a porta em que o aplicativo escuta. O código vale cinco minutos, uma única vez e só a partir deste computador.
No navegador, clique no ícone do Context Code, digite o código e clique em Emparelhar. Se mudou a porta do Acesso web, informe-a em Avançado.
Pronto: a extensão aparece no passo 3 com todos os comandos ativados. Se quiser limitar o que ela pode fazer, desmarque ali os que não quiser permitir.

A partir daí o ícone da extensão mostra um ponto verde (conectada). Se o Context Code fechar, a extensão fica «conectando» e volta sozinha quando você abrir o app de novo.

A barra lateral: Context Code dentro do navegador

Ao clicar no ícone da extensão abre-se uma barra lateral ao lado da aba (Chrome, Brave e Edge) com um chat do Context Code:

É um chat do desktop. O que você escreve vai para o Context Code Desktop e a resposta volta ao vivo. O chat fica guardado na seção Chats do aplicativo (não dentro de nenhum projeto) e você pode continuá-lo no desktop ou na barra. Com o botão de lista você troca para qualquer outro chat dessa seção; com + começa um novo, que só é criado ao enviar a primeira mensagem.
Seus provedores e modelos. Os seletores do rodapé mostram exatamente as contas configuradas no Context Code (ContextCode IA, Claude, OpenAI, Gemini, Context Forge…) e seus modelos; mudar ali muda o motor daquele chat.
A aba como contexto. Com «Esta aba» marcado, a mensagem leva o título e a URL da aba ativa (só quando a aba muda, para não inchar a conversa) e o agente lê o conteúdo pelo navegador apenas quando precisa, então você pode pedir «resuma isto» ou «o que diz este e-mail» sem copiar nada. Os atalhos «Resumir esta página» e «O que há aqui» fazem isso com um clique. Em um site protegido nada é anexado.
Modo de aprovação, voz e ditado. O escudo do rodapé abre o mesmo menu do desktop («Como as ações devem ser aprovadas?»: só leitura, pedir aprovação, aprovar por mim, acesso completo) para aquele chat. Cada resposta tem um botão para ler em voz alta e o microfone dita com a voz do navegador (no Brave o ditado vem desativado pelo próprio navegador).
Permissões e perguntas sem trocar de janela. Quando o agente precisa de permissão (por exemplo, para clicar no seu navegador) ou faz uma pergunta, o cartão aparece na própria barra e você responde ali.
Se o Context Code estiver fechado, a barra avisa e oferece tentar de novo; se a extensão ainda não estiver emparelhada, mostra o campo do código. Os ajustes (pausar, desemparelhar, sites protegidos) ficam na engrenagem da barra.

O que o agente pode fazer

Com a extensão emparelhada, o agente tem a ferramenta Navegador com estas ações:

Ação	O que faz	Risco
`tabs`	Lista as abas abertas.	Só lê
`snapshot`	Árvore da página com referências (`e1`, `e2`…) a cada elemento.	Só lê
`find`	Busca elementos pelo texto visível.	Só lê
`text`	Texto legível do conteúdo principal.	Só lê
`screenshot`	Captura da aba, que o modelo vê como imagem.	Só lê
`wait`	Espera um texto aparecer ou desaparecer.	Só lê
`navigate`	Abre uma URL na aba ativa ou em uma nova.	Age
`click`, `type`, `press`, `select`, `scroll`	Interage com a página por referência.	Age
`back`, `forward`, `reload`	Histórico e recarga.	Age
`close_tab`	Fecha uma aba.	Sensível

O agente prefere Navegador quando a tarefa é sobre algo que você já tem aberto ou onde já fez login, e o Playwright quando precisa navegar do zero ou testar um site.

Permissões e segurança

Permissão por tarefa. Os comandos da extensão ficam ativados ao emparelhar (você pode desativar algum no Context Code). Em cada tarefa, o agente pede permissão uma única vez antes da primeira ação que mude algo (navegar, clicar, escrever); ler não pergunta e fechar abas sempre é confirmado. É a mesma porta do uso do computador: nos canais (WhatsApp, Telegram, Slack) só funciona se o canal tiver permissão de controlar o computador.
Sites protegidos. A extensão traz uma lista de domínios de bancos e pagamentos em que o agente não lê nem age mesmo que você peça; tabs nem mostra o título deles. Edite-a no popup da extensão (Sites protegidos): um domínio por linha; uma palavra sem ponto, como banco, veta qualquer host que a contenha.
Senhas. O agente só escreve uma senha que você deu a ele naquele chat, somente em um campo de senha, e pede confirmação cada vez (o cartão não mostra a senha e a resposta da página também não a repete). Nunca inventa nem reutiliza senhas de outros sites, e dados de pagamento nunca escreve.
Senhas do cofre. Se a senha do site está guardada no cofre do projeto, o agente pede sua autorização para usá-la (como com qualquer segredo) e depois a escreve no campo de senha sem vê-la: o app coloca o valor no momento de enviá-lo à extensão, e você confirma a escrita como com uma senha dada no chat.
Páginas internas. Não age em chrome://, about:, file:// nem em outras extensões.
Grupo de abas. As abas em que o agente age são agrupadas em «Context Code» (grupo verde) para você ver de relance quais ele está mexendo; olhar sem agir não agrupa. Um grupo «Claude» laranja é da extensão Claude in Chrome, não desta.
Indicador visível. Cada ação mostra por alguns segundos um aviso no canto da aba («Context Code: clique em …»), para você sempre saber quando ele está agindo.
Conteúdo não confiável. O agente trata o texto das páginas como dados: não segue instruções que apareçam em um site.
Revogar. No Context Code (Desemparelhar na aba da extensão) a extensão perde o acesso na hora. No popup, Pausar detém o agente temporariamente sem desemparelhar.

Vários navegadores

Você pode emparelhar mais de um navegador (por exemplo Chrome e Firefox). Cada um aparece separado com seus comandos aprovados; se houver vários online, o agente usa o primeiro e avisa, e você pode indicar qual usar.

Se algo não funcionar

«Não foi possível contatar o Context Code» ao emparelhar: o aplicativo precisa estar aberto e o código recém-gerado. Confira a porta em Avançado (8787 por padrão).
Ícone com «!» amarelo: há comandos pendentes de aprovação no Context Code.
Ícone com «x» vermelho: a extensão foi revogada no Context Code; gere um código novo e emparelhe de novo.
«Site protegido» na resposta do agente: esse domínio está na sua lista de protegidos. Remova-o no popup se realmente quiser que o agente aja ali.
Firefox não age em nenhuma página: falta conceder o acesso aos sites no popup.