Este é o passo a passo completo: instalar o VS Code, conectar o Claude Code, gerar o token do Meta Ads e liberar o acesso à API do Google Ads. Feito uma vez, serve para sempre.
O guia é linear: faça as partes na ordem. Se você já tem alguma etapa pronta (já tem MCC, já usa VS Code), pode pular, mas confira o checklist do final antes de dizer que terminou.
A parte do Meta você resolve em uns 10 minutos e já sai daqui com o token na mão. O Google é mais burocrático e ainda passa por uma aprovação humana que costuma levar de 24 horas a 7 dias. Por isso a ordem do guia é essa: primeiro o Meta, para você já ver a coisa funcionando, e depois o Google. Se você usa muito Google Ads e tem pressa, dá para adiantar o pedido de acesso na Parte 5 e voltar para o começo enquanto a resposta não chega.
Meta, Google, Claude e VS Code mexem nas telas e nos nomes dos menus o tempo todo. É bem possível que, quando você estiver lendo, um botão esteja em outro canto ou com outro nome, ou que apareça uma etapa nova que não existia aqui. Isso não significa que você errou.
Nada aqui é opcional. Se faltar um item desta lista, o passo a passo trava no meio.
Um token de acesso é, na prática, o seu login, a sua senha e o seu segundo fator resumidos numa linha de caracteres. Quem tiver o token entra nas suas contas de anúncio sem precisar de mais nada.
Você não precisa entender o que cada coisa faz por dentro. Precisa só reconhecer o nome quando ele aparecer na tela.
| Nome | O que é, em português |
|---|---|
| API | A "porta dos fundos" oficial da plataforma. É por onde um programa fala com o Meta ou com o Google sem precisar clicar no gerenciador. |
| SDK | Kit de desenvolvimento. O pacote oficial que traduz os pedidos para essa porta. O do Meta existe desde 2018, não é gambiarra nem coisa nova. |
| Token | A chave que prova que é você quem está pedindo. É o item sigiloso da história. |
| MCC | Conta de administrador do Google Ads. Uma central que enxerga várias contas de anúncio de uma vez. |
| .env | Um arquivo de texto que fica só no seu computador e guarda as chaves. Nunca sai da sua máquina. |
| Skill | Uma receita salva. Você ensina o seu jeito de subir campanha uma vez e depois só chama pelo nome. |
| Python | A linguagem que roda por baixo. O Claude instala e usa sozinho, você não vai programar nada. |
O VS Code nasceu como programa de programador, mas é um ótimo lugar para rodar o Claude Code: você abre várias conversas ao mesmo tempo, enxerga as pastas dos seus clientes em tempo real e compartilha essa mesma estrutura com o time. É gratuito.
Existem outros editores que fazem o mesmo papel, como Cursor, Antigravity e outros que vão surgindo. Vários deles são, inclusive, feitos em cima do próprio VS Code, então a lógica de pastas, extensões e atalhos é praticamente a mesma. Use o que você preferir.
Aqui as telas foram feitas no VS Code, por ser gratuito e o mais comum. Se você escolher outro, os nomes dos menus podem mudar um pouco, mas o caminho é o mesmo: instalar o editor, instalar a extensão, fazer login e abrir uma pasta de trabalho.
O site detecta o seu sistema sozinho, mas confira antes de clicar. Escolha a sua aba abaixo.
.exe (User Installer, o recomendado).Ctrl + S.zip. Clique duas vezes para descompactar.Cmd + SMesmo em português, várias mensagens do Claude continuam em inglês (o famoso Yes / No nas confirmações). É normal e não indica erro.
Aqui você liga a sua assinatura do Claude ao VS Code e cria a pasta que vai virar, na prática, o segundo cérebro da sua operação.
Existem outras inteligências artificiais que trabalham no mesmo formato, dentro do editor e com acesso às suas pastas, como o Codex e outras que aparecem a cada mês. Você é livre para escolher a que preferir, e nada impede que você tenha mais de uma instalada na mesma pasta de trabalho.
O que você precisa saber é que toda a configuração apresentada aqui foi feita com o Claude Code: os prints, os nomes de tela e os prompts seguem esse caminho. A lógica vale para as outras (instalar, dar acesso à pasta, guardar as chaves num arquivo local), mas os passos exatos mudam de ferramenta para ferramenta.
Em alguns computadores Windows a extensão pede para instalar componentes extras (por exemplo o Git) na primeira execução. Pode autorizar: é parte normal da instalação e vem das fontes oficiais. Se aparecer uma mensagem que você não entendeu, copie o texto e cole no chat do Claude perguntando o que é.
Traduzindo o que acabou de acontecer: você disse ao Claude "quero te usar também neste outro programa".
O Claude Code trabalha sempre dentro de uma pasta. Tudo o que estiver nela, ele enxerga: contexto dos clientes, criativos, planilhas, relatórios. Tudo o que estiver fora, ele não enxerga. Por isso essa etapa define se a sua experiência vai ser organizada ou caótica.
Acontece o tempo todo: ao trocar de pasta, o VS Code remonta a tela inteira. Duas saídas:
clique de novo no ícone do Claude na barra lateral, ou aperte
Ctrl/Cmd + Shift + P, digite Claude Code e escolha o comando de abrir o painel.
Se você vai instalar um framework, um pacote de skills ou qualquer coisa baixada da internet, peça uma inspeção antes. Leva um minuto e é a diferença entre instalar uma ferramenta e instalar um problema.
Quero instalar este material no meu computador. Antes de instalar, faça uma auditoria: me diga o que ele contém, se existe algo malicioso, se algum script envia dados para fora, para quais domínios ele se conecta e se em algum momento ele pede ou expõe as minhas senhas ou tokens. Me responda em português e de forma simples. [cole aqui o link ou o caminho do material]
Uma resposta saudável menciona: os arquivos são de texto/documentação, o tráfego de rede vai
só para as APIs oficiais (graph.facebook.com, googleads.googleapis.com)
e as credenciais são lidas de um arquivo local que você cria. Se a resposta apontar qualquer envio para
domínio desconhecido, não instale.
Para arquivos baixados, você também pode passar o link ou o arquivo no VirusTotal antes. É gratuito.
Por padrão o Claude pede autorização a cada ação. É seguro, e é chato. Existe um modo que reduz isso
(as chamadas bypass permissions), configurável nas Configurações do VS Code pesquisando por
permissions.
Com esse modo ligado, o que você pedir ele executa, inclusive apagar arquivo ou publicar campanha. O próprio programa exibe um aviso de risco na hora de ativar. Recomendação para quem está começando: deixe desligado nos primeiros dias, até pegar o jeito de escrever pedidos precisos. Ligue depois, se quiser.
Este é o bloco mais curto do guia: em 10 minutos você tem o aplicativo criado e o token na mão. Você vai sair daqui com duas informações guardadas: o ID do aplicativo e o token de acesso.
Assim que o aplicativo é criado, o ID aparece no painel dele (e também na lista em "Meus aplicativos"). É um número comprido. Copie e cole no seu bloco de notas, você vai precisar dele na Parte 6.
| Permissão | Para que serve no dia a dia |
|---|---|
| ads_management | Criar e editar campanhas, conjuntos e anúncios. É a principal. |
| ads_read | Ler métricas e insights das contas. |
| business_management | Enxergar as BMs e os ativos dentro delas. |
| pages_show_list | Listar as páginas do perfil (para escolher a página do anúncio). |
| pages_read_engagement | Métricas de página. Útil em relatório. |
| leads_retrieval | Só se você usa formulário nativo do Meta. Puxa os leads. |
| read_insights | Opcional. Métricas adicionais de página e Instagram. |
Esqueceu uma permissão ou quer liberar uma BM nova? É só voltar ao Explorador da Graph API, ajustar as marcações e gerar o token de novo. O token antigo continua valendo até expirar.
O token que você acabou de gerar dura cerca de uma hora. Com uma hora não dá para trabalhar. A conversão para o token longo leva 20 segundos.
O token estendido é chamado de "longa duração" e costuma valer cerca de 60 dias. A tela do depurador mostra a data exata de expiração. É essa data que vale, não o que qualquer tutorial disser. Anote-a e crie um lembrete no celular para uma semana antes. No dia, você repete só a Parte 3 e troca a linha do token no arquivo de configuração.
Existe. Não vamos ensinar aqui de propósito: um token permanente vazado é um problema permanente. Enquanto você não recupera o acesso ao perfil para revogá-lo, ele continua valendo. O ciclo de renovação periódica é mais chato e muito mais seguro.
O caminho acima é o mais direto para quem está começando do zero. Mas ele não é o único.
A comodidade de não renovar vem com o outro lado: um token que não expira sozinho continua valendo para sempre se cair em mãos erradas, até que alguém o revogue manualmente. Guarde num gerenciador de senhas, nunca compartilhe e, se houver qualquer suspeita, revogue o usuário do sistema imediatamente nas configurações do Gerenciador de Negócios.
Marcar essa caixinha é o passo que a maioria esquece, e é justamente ele que derruba o token.
A conexão é oficial: tudo aqui passa pelas APIs do Facebook e do Google, os mesmos canais que as ferramentas do mercado usam há anos. Isso não é gambiarra e não é o que derruba conta.
Mas existe um detalhe que ninguém conta: aplicativo recém-criado, usado com muito empenho logo de cara, chama atenção. Mesmo que o seu perfil e as suas contas sejam antigos, um aplicativo novo que dispara centenas de ações em poucas horas pode acabar bloqueado. Vale o mesmo princípio de sempre: assim como dentro do gerenciador de anúncios, o que você faz e o volume com que faz podem levar a bloqueio, independente da ferramenta.
O MCC é a conta de administrador do Google Ads. Pense nele como o equivalente à BM, só que do lado do Google. Sem MCC você não consegue o developer token, e sem developer token nada do Google Ads funciona. Se você já tem um, pule para a Parte 5.
Esses dois campos ficam travados após a criação. Confira antes de clicar em criar.
Criar o MCC não conecta nada sozinho. Você precisa puxar cada conta para dentro dele. É o mesmo movimento de adicionar uma conta de anúncio numa BM.
O convite também aparece como notificação dentro da conta de anúncio (ícone de sininho) e em Administrador › Acesso e segurança › Administradores. Se nada aparecer, confira se você enviou o convite para o ID certo: um dígito trocado envia para outra conta.
O Google é mais burocrático que o Meta: são vários cliques e uma aprovação humana no final. Respire. São quatro informações a coletar, e este guia vai dizer exatamente onde cada uma aparece.
Este é o erro clássico desta parte. Se você tem mais de uma conta Google no navegador, o formulário pode abrir na conta errada e o pedido é recusado sem explicação. Antes de começar: saia das outras contas ou use uma janela anônima logada apenas na conta dona do MCC.
É o "aplicativo" do Google, equivalente ao que você criou no Meta.
.../auth/adwords), clique em Atualizar e depois em Salvar.Porque o aplicativo fica em modo de teste, e só quem está nessa lista consegue autorizá-lo. Se pular este passo, na hora do login final vai aparecer "Acesso bloqueado".
Somos uma agência de marketing digital que gerencia campanhas de Google Ads para os nossos próprios clientes, com contas vinculadas à nossa conta de administrador (MCC). Vamos usar a API exclusivamente para uso interno da agência: criar e gerenciar campanhas de rede de pesquisa e Performance Max, gerenciar palavras-chave e extrair relatórios de desempenho para acompanhamento dos nossos clientes. Não desenvolvemos nem revendemos software. Não fornecemos, vendemos nem compartilhamos os dados obtidos pela API com terceiros. Todo o acesso é restrito à nossa equipe interna e às contas que já administramos.
We are a digital marketing agency managing Google Ads campaigns for our own clients. All accounts are linked to our manager account (MCC). We will use the API strictly for internal agency use: creating and managing Search and Performance Max campaigns, managing keywords, and pulling performance reports for our clients' reviews. We do not build or resell software. We do not provide, sell or share any API data with third parties. Access is restricted to our internal team and to the accounts we already manage.
Use como base, mas escreva a verdade sobre a sua operação. O Google avisa no próprio formulário: informação incorreta é motivo de recusa.
O token que você acabou de gerar é um token de teste: serve para testar, mas não acessa as suas contas reais. Para valer, você precisa pedir o Basic Access.
A resposta chega por e-mail, normalmente entre 24 horas e 7 dias. Enquanto isso, siga com a Parte 6 usando a parte do Meta, ela funciona de forma independente.
É simplesmente o ID do seu MCC, sem os hífens.
Tirar os hífens não é frescura: com eles, a conexão falha.
Todas as chaves que você juntou moram num único arquivo de texto, que fica só no seu computador e nunca é enviado para lugar nenhum. Quem cria esse arquivo é o próprio Claude, você só preenche as linhas.
Quero configurar a conexão com o Meta Ads. Rode o setup, instale o que for necessário, crie o arquivo .env e me diga exatamente quais campos eu preciso preencher e onde encontrar cada um. Não avance enquanto eu não confirmar que preenchi e salvei.
Quero configurar a conexão com o Google Ads. Rode o setup, instale as dependências, e me guie no preenchimento do .env. Depois faça o processo de autorização (refresh token) e um teste de conexão listando as contas do meu MCC.
| Campo | O que colocar |
|---|---|
| META_ADS_TOKEN | O token estendido da etapa 3.3. |
| META_APP_ID | O ID do aplicativo criado na etapa 3.1. |
| META_AD_ACCOUNT_ID | Opcional, mas recomendado: a conta que você mais usa, no formato act_123456789. Vira o padrão quando você não disser de qual conta está falando. |
| GOOGLE_ADS_DEVELOPER_TOKEN | O token da Central de API (etapa 5.5). |
| GOOGLE_ADS_CLIENT_ID | Do Google Cloud (etapa 5.4). |
| GOOGLE_ADS_CLIENT_SECRET | Do Google Cloud (etapa 5.4). |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | O ID do MCC sem hífens (etapa 5.7). |
| GOOGLE_ADS_CUSTOMER_ID | Opcional: a conta Google Ads padrão, também sem hífens. |
| GOOGLE_ADS_REFRESH_TOKEN | Você não preenche à mão. É gerado no login do passo seguinte. |
Ctrl + S (Windows) ou Cmd + S (Mac).
A bolinha branca ao lado do nome do arquivo tem que sumir.Depois do .env salvo, o Claude abre o navegador para você autorizar o acesso.
Quase sempre é uma de duas coisas: você autorizou com a conta Google errada, ou esqueceu de se adicionar como usuário de teste na etapa 5.3. Corrija e peça ao Claude para rodar a autorização de novo.
Com a conexão funcionando, ele consegue listar todas as contas de anúncio às quais você tem acesso e salvar num arquivo de referência (normalmente contas.yaml). A partir daí você para de colar ID: passa a falar por nome.
Liste todas as contas de anúncio às quais eu tenho acesso e salve no arquivo contas.yaml, com nome do cliente, nome da conta e ID. Se não conseguir identificar o cliente pelo nome da conta, me pergunte antes de preencher.
No Meta, o nome da conta costuma já identificar o cliente e o preenchimento sai quase automático. No Google Ads essa informação nem sempre vem, então você vai precisar dizer quem é quem. Pode fazer isso depois, aos poucos: peça para ele salvar só os IDs agora.
Me traga um resumo da conta [nome do cliente] dos últimos 7 dias: investimento, impressões, alcance, frequência, cliques, CTR, CPC, CPM e resultados. Depois liste as campanhas ativas e as pausadas no período.
Se voltou com os números batendo com o gerenciador, está tudo funcionando. Fim da instalação.
Não é instalação, é rotina. Mas evita retrabalho e economiza consumo.
Quando precisar mandar criativos, em vez de descrever onde estão, copie o caminho e cole na conversa: no Mac, botão direito + segurar Option (⌥) › "Copiar como nome do caminho"; no Windows, Shift + botão direito › "Copiar como caminho".
Este é o ponto que muda tudo em relação a um tutorial comum: quando a tela não bate com o passo a passo, você não precisa esperar suporte. Descreva o que está vendo para o próprio Claude, no aplicativo do Claude, no navegador ou dentro do VS Code. Copie um dos prompts abaixo.
Estou tentando [descreva o objetivo, ex.: gerar um token de acesso longo no Explorador da Graph API do Meta]. O tutorial que estou seguindo diz para clicar em "[nome do botão]", mas essa opção não existe na minha tela. O que eu estou vendo agora é: [descreva os menus e botões que aparecem]. Me diga, passo a passo e em português simples, onde essa opção foi parar na versão atual da plataforma. Se mudou de nome, me diga o nome novo.
Apareceu esta mensagem de erro e eu não entendi: [cole a mensagem inteira] Me explique em português simples: o que isso significa, qual é a causa mais provável e o que eu faço para resolver, na ordem. Considere que eu sou iniciante e não sei programar. IMPORTANTE: não me peça para colar token ou senha aqui no chat.
Confira o meu setup e me diga o que ainda falta: verifique se as dependências estão instaladas, se o arquivo .env existe e se todos os campos obrigatórios estão preenchidos (sem me mostrar os valores). Depois faça um teste de conexão com o Meta Ads e com o Google Ads e me diga, em linguagem simples, o que funcionou e o que não.
Peça ajuda à vontade, mas nunca cole token, senha ou chave secreta dentro do chat. Descreva o problema, cole a mensagem de erro, mande print com os dados sensíveis cobertos. O lugar da chave é o arquivo .env, e ninguém precisa vê-la para te ajudar.
Aperte Ctrl/Cmd + Shift + P, digite Claude Code e escolha o comando de abrir o painel.
Se mesmo assim não aparecer, confira se a extensão continua instalada e se você está com uma pasta aberta
(Arquivo › Abrir Pasta).
A lista de comandos é carregada quando a janela abre. Feche e reabra o VS Code, ou use
Ctrl/Cmd + Shift + P para recarregar a janela. Depois ela aparece normalmente.
Duas causas quase sempre: conta Google errada no navegador, ou o seu e-mail não foi adicionado como usuário de teste na tela de permissão OAuth (etapa 5.3). Corrija e rode a autorização de novo.
Provavelmente o token expirou (lembre-se: o token estendido vale por tempo limitado) ou a senha do perfil foi trocada com a opção de encerrar sessões. Refaça a Parte 3, gere um token novo e troque só aquela linha do .env.
Ele ainda está como token de teste. Você precisa do Acesso Básico aprovado (etapa 5.6). A resposta chega por e-mail em 24 horas a 7 dias. Sem essa aprovação, nada do Google Ads funciona de verdade.
No Meta: confira se você marcou ads_management e business_management nas permissões e se liberou a BM certa ao gerar o token. No Google: confira se as contas estão vinculadas ao MCC (Parte 4) e se o Login Customer ID está sem hífens.
Isso é esperado e é justamente por isso que tudo é criado pausado. Confira geolocalização, orçamento, posicionamentos e criativos no gerenciador antes de ativar. Achou um erro, é só apontar: ele corrige. Trate o resultado como rascunho de um assistente, não como entrega final.
Se todas estiverem marcadas, você chega na aula prática pronto para trabalhar.