Cómo conectar Claude Code a Meta Ads paso a paso

Conectar Claude Code a Meta Ads tiene más pasos que lo que muestran la mayoría de tutoriales. Y funciona exactamente como los CLI meta ads. Y los pasos que se saltean son exactamente los que generan bloqueos. Esta guía cubre el proceso completo, instalación, configuración en Meta y el archivo que protege tu cuenta.

¿Qué necesitas antes de conectar Claude Code a Meta Ads?

Antes de empezar, confirma que tienes estos cuatro elementos:

1. Cuenta de Claude con plan pago: el plan Pro ($20/mes) incluye Claude Code. Puedes verificar planes en claude.ai.
   
   
2. Visual Studio Code: la aplicación gratuita de Microsoft donde vamos a instalar Claude Code. Es el método recomendado para personas que no programan.
   
   
3. Cuenta de Meta Business Manager: necesitas acceso de administrador a la cuenta publicitaria que quieres analizar.
   
   
4. 15 minutos: la instalación es sencilla pero hay varios pasos. Con el video abierto al lado, es fácil.

¿Cómo instalar Claude Code en tu computador?

Claude Code se puede usar de tres formas: desde la terminal (línea de comandos), desde la versión web de Claude, o desde VS Code (Visual Studio Code). Después de probar las tres, llegué a la conclusión de que para personas que no somos programadores, VS Code es la mejor opción. Tiene interfaz visual, historial de conversaciones y es mucho más fácil de navegar. Y aquí te enseño cómo hacerlo paso a paso. 

Para instalarlo, necesitas un plan pago de Claude (Plan Pro desde $20/mes). El plan gratuito no incluye Claude Code. Descarga la aplicación en claude.com/download si aún no tienes cuenta. Si quieres profundizar más en automatizaciones, también existen automatizaciones para claude en el MCP de meta ads.

6 pasos para conectar Claude Code a Meta Ads

Esta conexión se hace vía API y permite que Claude pueda analizar lo que está pasando dentro de tus campañas de Meta Ads en tiempo real. Así como chatgpt meta ads, pero hacerlo bien importa. Y es por esto que en el video muestro el paso a paso para conectar Claude Code a Meta Ads. Gran parte de los bloqueos recientes vienen de configuraciones incorrectas o permisos demasiado amplios. 

Paso 1: Instala Claude Code en VS Code

VS Code es la forma más accesible de usar Claude Code si no eres programador. Claude escribe y ejecuta el código por ti. Tú solo das las instrucciones en lenguaje natural.

1. Abre code.visualstudio.com y descarga VS Code para tu sistema (Mac, Windows o Linux). Arrastra el archivo a tu carpeta de Aplicaciones.
   
   
2. Abre VS Code. En el panel izquierdo, haz clic en el ícono de extensiones (ícono de los cuatro cuadrados). Busca “Claude Code” y selecciona la primera opción. Clic en Instalar. 
   
   
3. Una vez instalado, aparece un asterisco naranja o el logo de Claude en el panel. Haz clic ahí. Si es tu primera vez, Claude te pide iniciar sesión con tu cuenta.
   
   
4. Instala Python cuando VS Code lo solicite. Claude necesita Python para ejecutar muchas acciones automáticamente. Sin Python, queda “atado de manos”, como dice el mensaje.
   
   
5. Crea una carpeta llamada “claude-code” en tu carpeta de Documentos. Todo lo que Claude genere se guardará ahí. Si vas a usarlo con varios clientes, crea una carpeta por cliente.

¿Por qué VS Code y no la terminal? Claude Code funciona también desde la terminal o desde la web. Pero VS Code tiene interfaz visual, historial de conversaciones y es más fácil de navegar para quienes no programan. El fondo es el mismo, solo cambia cómo interactúas.

Paso 2: Instala el Plugin de las 3 Qs y el Archivo CLAUDE.MD

Antes de conectarte a Meta, necesitas dos cosas en tu carpeta: el plugin con la metodología de análisis y el archivo con las reglas antibloqueo.

1. Abre Claude Code en VS Code. En el chat, escribe /manage-plugins.
   
   
2. Selecciona Marketplaces y busca felipevergara/3qs. Haz clic en Agregar.
   
   
3. Ve a Plugins, baja hasta el final y busca “3Qs Instalar”. Clic en Instalar solo para ti. Cuando aparezca “3C” en el panel, quedará instalado.
   
   
4. Descarga el archivo CLAUDE.MD desde la descripción del video. Este archivo contiene las reglas de seguridad que le dicen a Claude cómo comportarse con la API de Meta: intervalos mínimos entre llamadas, método fetch para no saturar el límite, restricciones de presupuesto. El equipo tardó bastante en armarlo y lo dejamos gratis para que cualquiera lo use.
   
   
5. Arrastra el archivo CLAUDE.MD dentro de tu carpeta “claude-code” en VS Code. Claude lo lee automáticamente en cada sesión.

Si no puedes instalar el plugin que muestro (felipeverce/3Qs), esta es la solución: 1. Instala este complemento en tu computador: https://git-scm.com/install/windows 2. Reinicia el sistema después de la instalación. 3. Vuelve a ejecutar el proceso en Claude Code. Con eso debería funcionar sin problema.

 

Paso 3: Crea tu aplicación en Meta for Developers

Ahora toca crear la conexión oficial con Meta. Para conectarte a la API de Meta, necesitas crear una aplicación. Esto suena técnico, pero tarda 3 minutos. 

1. Ve a Meta for Developers (búscalo en Google). Inicia sesión con tu cuenta de Facebook.
   
   
2. Ve a Mis apps > Crear app. En nombre, escribe “Claude Code” o cualquier nombre que reconozcas. 
   
   
3. En Casos de uso, selecciona Anuncios y monetización. Marca únicamente: “Medir datos de rendimiento de los anuncios con la API de marketing”. No marques “Crear y administrar anuncios”; ese permiso es el que genera la mayoría de bloqueos y baneos que circulan en internet. 

⚠  NO selecciones todos los casos de uso. Dar demasiados permisos es una señal de alerta para Meta.Solo lectura. Solo rendimiento. Eso es todo lo que necesitas.

4. En portafolio comercial, no uses tu Business Manager principal (el que usas para crear campañas). Crea uno nuevo llamado “Respaldo” o similar. Meta espera que las conexiones vía API vengan de un portafolio separado. Más detalles en el paso siguiente.
   
   
5. Haz clic en Crear app. Ingresa tu contraseña cuando lo pida.

Paso 4: Configura el Business Manager Secundario

Este paso es el que más personas saltean. Y es el que más bloqueos genera. La lógica es simple: Meta tiene un portafolio para manejar campañas y otro para conectarse a la API. Mezclarlos levanta alertas.

1. Ve al Administrador de anuncios > menú hamburguesa (las tres barras) > Configuración del negocio.
   
   
2. En tu Business Manager secundario (el de respaldo que creaste), ve a Información del negocio y copia el Identificador del portafolio.
   
   
3. Vuelve a tu Business Manager principal. Ve a Socios > Agregar > Otorgar a un socio acceso a tus activos. Pega el identificador del portafolio secundario.
   
   
4. Busca tu cuenta publicitaria en la lista. Asígnale el permiso “Ver rendimiento” únicamente. Nada de administrar, nada de editar. Solo ver.
   
   
5. Haz clic en Asignar activos. El Business Manager secundario ahora tiene acceso de solo lectura a tu cuenta de anuncios.

Paso 5: Crea el Usuario del Sistema

El usuario del sistema es la “identidad” con la que Claude Code se conecta a Meta. Si usas tu perfil personal de Facebook para esto y algo sale mal, Meta puede bloquear ese perfil. El usuario del sistema está aislado.

1. Dentro del Business Manager secundario, ve a Usuarios del sistema > Agregar.
   
   
2. En nombre escribe “cloud-code” o similar. En rol selecciona “Empleado”, no Admin. Esto es importante: con rol Empleado, Claude tiene el acceso mínimo necesario. Con Admin, tienes un riesgo innecesario.
   
   
3. Haz clic en los tres puntos junto al usuario creado > Asignar activos. Agrega la aplicación que creaste (Claude Code) y la cuenta publicitaria.
   
   En ambas, elige los permisos mínimos: Administrar app para la aplicación y Ver rendimiento para la cuenta. Esto también aplica cuando trabajas con herramientas de ia meta ads o automatizaciones externas.

Paso 6: Genera el Token de Acceso Seguro

Hay dos formas de generar el token. Una es rápida pero arriesgada. La otra tarda 2 minutos más y protege tu cuenta.

⚠  No uses el Explorador de la Graph API para generar el token.Ese método usa tu perfil personal de Facebook como base.Si Meta detecta actividad sospechosa, puede bloquear tu perfil personal, incluso si lo tienes hace 15 años con 20 cuentas de anuncios.

1. Dentro del Business Manager secundario, ve a Usuarios del sistema. Haz clic en los tres puntos del usuario que creaste > Generar token.
   
   
2. Selecciona la aplicación que creaste (Claude Code). Clic en Siguiente.
   
   
3. En caducidad del token: “Nunca”. Un token que expira cada 60 días significa que cada 2 meses tienes que repetir este proceso.
   
   
4. En permisos, selecciona únicamente dos: ads_read (para que Claude pueda leer tus campañas) y business_management (para saber a qué cuentas tiene acceso). Nada más.
   
   
5. Haz clic en Generar token. Verifica tu identidad con el código que llega a tu correo.
   
   
6. Copia el token. Ve a Claude Code en VS Code. Pégalo cuando Claude lo pida. Si configuraste todo bien, Claude responde: “Acceso del tipo más seguro, sin expiración, solo permisos de lectura.”

Cómo saber si la conexión es segura: Claude confirma: acceso de solo lectura, token sin expiración.También pregunta: “¿Hay otro agente o bot revisando esta cuenta ahora mismo?”Responde siempre “no”. Dos agentes conectados al mismo tiempo = alerta para Meta.

¿Qué hacer luego de conectar Claude Code a Meta Ads?

Con la instalación lista, el plugin de las 3 Qs instalado y el token configurado, Claude Code ya puede ver en tiempo real lo que está ocurriendo en tus campañas. El siguiente paso es aprender a analizarlas correctamente.

Para eso está el artículo cómo usar Claude Code en Meta Ads sin riesgos de bloqueo, donde explico la metodología de las 3 Qs, cómo pedirle el análisis correcto y los trucos para no quemar créditos. Si llegaste aquí buscando aprender a usar Claude Code con Meta Ads de forma integral, ese artículo es el siguiente paso natural.

Y si quieres profundizar en todo esto con casos reales de agencia y soporte directo, en mi curso hay un módulo específico de Claude Code donde enseño cómo configurarlo con las metodologías que usamos en la agencia para analizar cuentas reales.

Preguntas frecuentes

¿Puedo usar mi Business Manager principal para conectarme a la API?

Técnicamente sí, pero no es lo que recomiendo. Meta espera que la conexiones vía API usen un portafolio separado al de gestión de campañas. Mezclarlos es una señal de alerta. El Business Manager secundario tarda 5 minutos en crearse y te protege.

¿Por qué el rol del usuario del sistema debe ser “Empleado” y no “Admin”?

El rol de Admin le daría a Claude más permisos de los necesarios. Con rol Empleado y los permisos específicos de ads_read y business_management, Claude puede ver todo lo que necesita para analizar campañas sin poder hacer cambios. Menos permisos = menos riesgo.

¿El archivo CLAUDE.MD se actualiza?

Sí. Lo actualizamos en mi agencia cuando Meta cambia sus políticas. El link en la descripción del video siempre apunta a la versión más reciente: bit.ly/42NWRch. Reemplaza el archivo en tu carpeta cuando haya una nueva versión.

¿Funciona este método con múltiples cuentas de clientes?

Sí. Crea una carpeta separada por cliente en VS Code, coloca el CLAUDE.MD en cada una y repite el proceso de usuario del sistema para cada cuenta que quieras analizar. Así cada cliente queda completamente aislado del otro.