Claude Code y WordPress: guía paso a paso para desarrolladores

Un plugin de IA para WordPress hace lo que su lista de funciones permite: crear una entrada, subir una imagen, editar un texto.
Claude Code no tiene esa lista.
Se conecta al servidor por SSH y trabaja con los mismos archivos y la misma base de datos que usarías tú a mano: puede editar PHP, crear un plugin desde cero, usar WP-CLI, y te muestra cada cambio con Git antes de que lo apruebes.

Esta guía explica, paso a paso y desde cero, cómo conectar Claude Code a un WordPress por SSH.
Está pensada para quien nunca usó una IA para programar.
Antes de entrar en los comandos, conviene entender qué se gana con esto, por qué elegimos Claude Code en particular, y qué hay que cuidar para no tener miedo de que la IA rompa algo.

Antes de empezar: los términos que vas a ver

Si esto no es tu trabajo de todos los días, conviene tener estos términos a mano antes de seguir:

• Terminal: un programa de solo texto donde escribes comandos en vez de hacer clic.
  No tiene botones ni menús: una ventana con un cursor parpadeando, esperando que escribas algo y presiones Enter.
• SSH (Secure Shell): el protocolo que usa la terminal para conectarse, de forma cifrada, al servidor donde vive tu WordPress.
  Una vez conectado por SSH, puedes ver y modificar los archivos del servidor como si fueran los de tu propia computadora.
• Remote-SSH: una extensión de VS Code que usa esa misma conexión SSH para abrir una carpeta del servidor como si fuera un proyecto local, con su propia terminal integrada ya conectada.
  Es la que conecta VS Code con tu WordPress en esta guía.
• PowerShell y CMD (Símbolo del sistema): las dos terminales que trae Windows de fábrica.
  Se parecen, pero usan comandos distintos — esta guía indica cuál usar en cada caso.
  Git Bash es una tercera opción, que se instala junto con Git para Windows y usa los mismos comandos que macOS o Linux.

• WP-CLI: la herramienta oficial de WordPress para administrar un sitio desde la terminal en vez de desde el panel de wp-admin: listar plugins, actualizar el núcleo, crear usuarios, todo con comandos que empiezan con wp.

+-------------------+----------+--------+---------+
| name              | status   | update | version |
+-------------------+----------+--------+---------+
| akismet           | active   | none   | 5.3     |
| classic-editor    | inactive | none   | 1.6     |
+-------------------+----------+--------+---------+

• MCP (Model Context Protocol): un estándar abierto para que una IA se conecte a herramientas externas de forma ordenada, por ejemplo para leer archivos de Google Drive o actualizar un ticket de Jira.
  Los plugins como Novamira o WPVibe, que menciono más abajo, usan este protocolo para conectar una IA a WordPress.
• REST API: la forma en que WordPress expone sus datos (entradas, páginas, medios) para que otros programas los lean o modifiquen sin entrar al panel.
  Es lo que usa WPVibe por detrás.
• VS Code (Visual Studio Code): el editor de código que usamos en esta guía junto con Claude Code.
  Es gratuito y lo desarrolla Microsoft.
  Se descarga desde code.visualstudio.com/download.
• Archivo .md (Markdown): un archivo de texto plano con un formato simple para darle estilo sin un procesador de texto: títulos con #, listas con -, negrita con **así**.
  Se abre con cualquier editor y se entiende tal cual, sin convertirlo a nada.
  Es el formato que usa CLAUDE.md, más abajo: fácil de escribir a mano y fácil de leer, tanto para ti como para Claude Code.

Cómo abrir una terminal

• macOS: presiona Cmd + Espacio para abrir Spotlight, escribe "Terminal" y presiona Enter.
• Windows: presiona Win + X y elige Windows PowerShell (o Terminal).
  Para distinguir PowerShell de CMD, mira cómo empieza cada línea: PowerShell muestra PS C:\Users\TuNombre>; CMD muestra lo mismo pero sin el PS adelante.
• Linux: presiona Ctrl + Alt + T, o busca "Terminal" en el menú de aplicaciones.

En los tres casos se abre una ventana con un cursor esperando texto: ahí se pegan los comandos de esta guía.
Para pegar algo que copiaste: Cmd + V en macOS, Ctrl + Shift + V en Linux, y Ctrl + V o clic derecho en PowerShell.
Después de pegar, presiona Enter para ejecutarlo.

Por qué Claude Code en lugar de un plugin de IA

Hoy existen plugins que conectan una IA a WordPress sin pasar por SSH, como Novamira o WPVibe.
Vale la pena entender qué hacen antes de elegir un camino.

Los dos trabajan por MCP o REST API: exponen un conjunto fijo de funciones (crear una página, subir un medio, leer un archivo de tema) y la IA solo puede usar esas funciones, ni una más.
Novamira está pensado para crear páginas y layouts, con soporte específico para builders como Elementor o Divi en su versión de pago.
WPVibe, que es de Awesome Motive (la empresa detrás de WPForms y MonsterInsights, entre otros), expone contenido, medios y archivos de tema a través de un servicio alojado que reenvía los pedidos a la REST API de WordPress.

Claude Code por SSH no tiene ese techo.
No depende de una lista de funciones que alguien más decidió exponer: lee y escribe cualquier archivo, corre WP-CLI, usa Git, y puede escribir un plugin completo desde cero si hace falta.

Cualquier cosa que haga un plugin de este tipo, Claude Code también la puede hacer por SSH, pero no al revés.

Esto es criterio propio, no una comparación de rendimiento entre productos: elegí Claude Code porque no quiero depender de lo que un plugin de terceros decida dejarme hacer.
Entre las consecuencias prácticas de esa decisión:

• Prescindir de editores visuales como Elementor o Divi.
  Claude Code puede construir una página completa con los bloques nativos de WordPress, sin el peso de un builder de terceros cargando su propio CSS y JavaScript en cada visita.
• El sitio sigue siendo un WordPress normal después.
  Una vez que Claude Code termina un trabajo, lo que queda es código y contenido estándar de WordPress.
  El sitio no depende de que Claude siga conectado ni de ningún plugin corriendo en segundo plano para seguir funcionando o para que el propio dueño del sitio lo siga editando.
• Si administras varios sitios desde la misma cuenta de hosting, una sola conexión SSH puede alcanzar a todos ellos (lo explico más abajo).
  Es cómodo, y es también el motivo por el que la seguridad importa tanto en esta guía.

Dicho esto, lo que más preocupa a quien no probó esto antes es justamente la seguridad: el miedo a que la IA modifique algo sin que se lo pidas.
Es una preocupación válida, y el resto de esta guía está armado alrededor de evitarlo.

Qué es Claude, y por qué esta guía usa Claude Code

"Claude" no es una sola cosa: es el nombre del asistente, y hay varias formas de usarlo.
Antes de instalar nada, conviene distinguirlas.

Las tres terminan usando el mismo asistente, pero solo Claude Code puede leer tu proyecto completo, editar archivos y ejecutar comandos.
Esta guía usa la terminal más la extensión de VS Code: el trabajo se hace en la terminal, y VS Code muestra cada cambio como un diff dentro del mismo editor en el que ya trabajas, antes de que lo aceptes.
Es la combinación que da más control sobre lo que Claude Code hace, sin perder la comodidad del editor que ya conoces.

El plan: dónde corre cada cosa

Antes de los comandos, un resumen de por dónde va esta guía, porque es la parte que más confusión genera: vas a instalar VS Code y generar una clave SSH en tu computadora.
Una sola vez vas a abrir el navegador, para pegar esa clave en el panel web de tu hosting.
Todo lo demás —Claude Code, WP-CLI, el proyecto de WordPress— vive y corre en el servidor de tu hosting, no en tu computadora.
Para no perderte, cada bloque de comandos de acá en adelante dice en qué terminal va, y si hace falta el navegador, también se aclara.

El puente entre la terminal de tu computadora y el servidor es una extensión de VS Code llamada Remote-SSH: conecta VS Code a tu servidor, y la terminal que abres dentro de VS Code queda directamente conectada ahí.
Así, cuando más abajo instales Claude Code "en la terminal", es siempre esa terminal conectada al servidor — nunca la de tu computadora.

Instalar VS Code

En tu computadora, si todavía no lo tienes instalado:

1. Entra a code.visualstudio.com/download.
2. Descarga el instalador de tu sistema operativo (Windows, macOS o Linux).
3. Abre el instalador descargado y sigue los pasos, sin necesidad de cambiar ninguna opción por defecto.

Preparar el acceso SSH

Esto también se hace en tu computadora, en la terminal del sistema operativo que abriste antes (no hace falta VS Code todavía).

Una clave SSH está formada por dos archivos: la clave privada, que se queda en tu máquina, y la clave pública, que se copia al servidor.

1. En la terminal de tu computadora (en Windows, usa Git Bash si instalaste Git para Windows), copia este comando, pégalo y presiona Enter:

ssh-keygen -t ed25519 -C "wordpress-dev"

2. Va a preguntar dónde guardar la clave.
   Presiona Enter para aceptar la ruta por defecto.
   Se crean dos archivos en tu computadora (esto es lo que vas a ver, no hace falta escribirlo):

~/.ssh/id_ed25519       # Clave privada: nunca se comparte
~/.ssh/id_ed25519.pub   # Clave pública: esta sí se copia al servidor

3. Para ver y copiar la clave pública, copia este comando, pégalo en la misma terminal y presiona Enter:

cat ~/.ssh/id_ed25519.pub

Va a mostrar un texto largo que empieza con ssh-ed25519.
Selecciónalo completo y cópialo.

4. Entra al panel de tu hosting (en el navegador, no en la terminal) y agrega esa clave.
   El paso exacto depende de cada hosting; en paneles como hPanel (Hostinger) suele ser: entrar a la sección de acceso SSH del sitio o del VPS, activar SSH si hace falta, y pegar el contenido de la clave pública en la opción para añadir una clave.
   El panel te da los datos de conexión: usuario, servidor y puerto.

5. Para probar la conexión, en la terminal de tu computadora copia este comando, reemplazando usuario, servidor y PUERTO por tus datos, pégalo y presiona Enter:

ssh usuario@servidor -p PUERTO

6. La primera vez va a pedir confirmar la identidad del servidor.
   Si los datos son correctos, escribe yes y presiona Enter.
   Vas a quedar con el cursor "dentro" del servidor — para salir de ahí y volver a tu computadora, escribe exit.

La forma más clara de saber que estás conectado es mirar el texto antes del cursor: cambia de tu computadora al servidor.

Si tu cuenta de hosting tiene más de un sitio, vas a ver más de una carpeta de dominio al entrar por SSH: una sola conexión alcanza a todos los sitios de esa cuenta, porque el usuario SSH es de la cuenta, no de un sitio en particular.
En un VPS propio pasa lo mismo con todo el servidor.
Si administras varios sitios así, más abajo vas a decirle a Claude Code en qué carpeta exacta tiene que trabajar, para que no toque por error los otros sitios de la misma cuenta.
Si cada sitio tiene su propia cuenta de hosting o está en un hosting gestionado con SSH aislado por sitio, este punto no aplica: cada uno necesita su propia conexión.

Conectar VS Code al servidor con Remote-SSH

Con la clave ya agregada a tu hosting, conecta VS Code directo al servidor.
A partir de acá, la terminal que uses va a estar dentro de VS Code, no en una ventana aparte.

1. En VS Code, abre la vista de Extensiones (Ctrl+Shift+X en Windows/Linux, Cmd+Shift+X en macOS).
2. Busca "Remote - SSH" (de Microsoft) y haz clic en Instalar.
3. Abre la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P), escribe Remote-SSH: Connect to Host... y selecciónalo.
4. Escribe usuario@servidor (los mismos datos del paso anterior) y presiona Enter.
   La primera vez, VS Code instala un componente propio en el servidor — puede tardar uno o dos minutos; no cierres la ventana.
5. Se abre una ventana nueva de VS Code, ya conectada.
   Con Archivo → Abrir carpeta, navega hasta la carpeta de tu WordPress (algo como ~/domains/tusitio.com/public_html) y ábrela.

Desde este punto, todas las terminales que abras con Terminal → Nueva terminal corren en el servidor, no en tu computadora.
Es lo mismo que si hubieras hecho ssh usuario@servidor a mano, pero integrado en el editor.

Instalar Claude Code en el servidor

Hace falta una cuenta Pro, Max, Team, Enterprise o Console de Anthropic.
El plan gratuito de claude.ai no incluye Claude Code.

1. Abre una terminal dentro de VS Code (Terminal → Nueva terminal) — ya conectada al servidor, como se explicó arriba.
2. Copia este comando, pégalo en esa terminal y presiona Enter:

curl -fsSL https://claude.ai/install.sh | bash

El hosting de WordPress casi siempre corre Linux, así que este es el único comando de instalación que necesitas, sin importar si tu computadora tiene Windows, macOS o Linux: lo que importa acá es el sistema operativo del servidor, no el tuyo.

3. Espera a que termine.
   No muestra avance mientras descarga: no cierres la terminal aunque parezca que no pasa nada.
   Al final aparece un mensaje de instalación exitosa.
4. Para verificar, en la misma terminal copia, pega y presiona Enter:

claude --version

Si devuelve un número de versión, quedó instalado.
La instalación se actualiza sola en segundo plano, no hace falta repetir estos pasos.

Instalar la extensión de Claude Code

Con Claude Code ya instalado en el servidor, suma la extensión en esta misma ventana de VS Code (la que está conectada por Remote-SSH):

1. Abre la vista de Extensiones (Ctrl+Shift+X / Cmd+Shift+X).
2. Busca "Claude Code" y haz clic en Instalar.
3. Abre la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P), escribe "Claude Code" y elige Open in New Tab.

La extensión te muestra los cambios como un diff dentro del editor, deja mencionar archivos con @ y guarda el historial de la conversación junto al proyecto.
Usa la misma instalación de Claude Code del servidor que acabas de poner: no es una herramienta aparte.

Importante: Claude Code puede leer y modificar archivos, ejecutar comandos y trabajar con el código del proyecto, directo en el servidor.
No se recomienda empezar directo sobre producción.
Lo más seguro es un entorno de staging, Git y una copia de seguridad reciente.

Confirmar la carpeta y hacer una copia de seguridad

En la terminal de VS Code (conectada al servidor), confirma dónde estás antes de seguir:

pwd
ls -la

Una instalación de WordPress contiene, entre otros, esto (es una referencia, no hace falta escribirlo):

wp-admin
wp-content
wp-includes
wp-config.php

Si Abrir carpeta te dejó en el lugar correcto, pwd va a mostrar la misma ruta que abriste en VS Code, algo como ~/domains/tusitio.com/public_html.

Es importante que Claude Code trabaje desde la carpeta correcta.
Si la terminal queda en otra ubicación, puede terminar analizando archivos que no son del proyecto.

Antes de que Claude Code toque un solo archivo, haz una copia de seguridad de wp-content, wp-config.php, .htaccess y de la base de datos.
La base de datos guarda páginas, entradas, usuarios y configuración de los plugins: sin ella, una copia de archivos no sirve de mucho.

El entorno recomendado es Producción → Staging → Git → Claude Code.
Si no hay staging disponible, como mínimo: haz la copia de seguridad, usa Git y crea una rama distinta para cada cambio.

Autenticar Claude Code y preparar el proyecto

En la misma terminal de VS Code, conectada al servidor y parada en la carpeta de WordPress, inicia Claude Code:

claude

Va a pedir iniciar sesión en el navegador la primera vez — se abre en el navegador de tu computadora, aunque Claude Code esté corriendo en el servidor.
No guardes credenciales dentro de wp-config.php, ni claves de API en repositorios, plugins, temas o archivos de JavaScript del navegador.

Si el proyecto no tiene Git, conviene sumarlo para versionar el tema o plugin personalizado:

wp-content/themes/mi-tema
wp-content/plugins/mi-plugin

Un .gitignore básico:

wp-config.php
.env
*.log

wp-content/uploads/
wp-content/cache/
wp-content/upgrade/

node_modules/
vendor/

Crear un CLAUDE.md del proyecto

Claude Code lee un archivo CLAUDE.md en la raíz del proyecto al empezar cada sesión.
Ahí van la arquitectura y las reglas que no quieres repetir en cada pedido.
Puedes crearlo con el explorador de archivos de VS Code (clic derecho → Nuevo archivo) o desde la terminal del servidor, con este comando:

nano CLAUDE.md

# Proyecto WordPress

## Arquitectura
- Tema personalizado: wp-content/themes/mi-tema
- Plugin personalizado: wp-content/plugins/mi-plugin
- PHP 8.2

## Reglas importantes
- No modificar WordPress Core ni plugins de terceros.
- No modificar wp-config.php.
- No ejecutar cambios en producción sin mostrar antes el plan.
- No borrar archivos sin explicar el motivo.
- Escapar correctamente el HTML; usar nonces y validar permisos.
- No guardar claves de API en el repositorio.

## Comandos permitidos
- npm run build
- npm run lint
- composer test
- php -l archivo.php

Medidas de seguridad: los modos de permisos de Claude Code

Todo lo anterior —clave SSH propia, copia de seguridad, staging— es preparación del entorno.
Además, Claude Code tiene su propio sistema de permisos, que decide qué puede hacer sin preguntarte primero.
No es algo exclusivo de trabajar por SSH: es el mismo sistema en cualquier proyecto, corra donde corra.

Así se ve un permiso pedido en modo Manual, antes de ejecutar un comando:

Cómo ver y cambiar el modo

El modo activo siempre está a la vista: en la terminal, al pie de la pantalla; en VS Code, como un indicador al pie del cuadro donde escribes.
También se lo puedes preguntar a Claude directamente:

¿En qué modo de permisos estoy trabajando ahora? Explícame qué puedes hacer sin
pedirme confirmación en este modo.

Para cambiarlo:

• En la terminal: presiona Shift+Tab para pasar al siguiente modo.
• En VS Code: haz clic en el indicador de modo, al pie del cuadro de mensaje, y elige uno de la lista.

El cambio de modo lo haces tú, con el teclado o el mouse — no es algo que Claude pueda hacer por sí mismo si se lo pides por chat, justamente para que no pueda ampliar sus propios permisos.
Si no te acuerdas cómo hacerlo, sí le puedes pedir que te lo explique:

No me acuerdo cómo paso al modo de solo lectura (Plan). Explícamelo paso a paso,
según si estoy en la terminal o en VS Code.

Para esta guía, empieza en modo Plan

En la primera sesión de un WordPress que no conoces, arranca Claude Code directamente en modo de solo lectura:

claude --permission-mode plan

Así, aunque le pidas algo ambiguo, Claude Code no va a poder editar ningún archivo hasta que apruebes un plan.
Es más seguro que solo pedirle amablemente que no toque nada, que es lo que hace el paso siguiente.

Empezar con una petición de solo lectura

Aunque ya hayas arrancado en modo Plan, la primera instrucción no debería pedir ningún cambio:

Analiza este tema de WordPress. No modifiques ningún archivo. Explícame la
estructura, los archivos principales y cómo se renderiza la página de inicio.

Después puedes pedir una revisión, todavía sin tocar nada:

Revisa si hay errores evidentes de PHP, problemas de seguridad o código
incompatible con PHP 8.2. No modifiques archivos y muestra los hallazgos
por prioridad.

Esto sirve para comprobar que Claude entendió bien el proyecto antes de dejarlo cambiar algo.

Pedir cambios pequeños y específicos

Una buena petición indica qué cambiar, en qué archivo, qué restricciones respetar, cómo probarlo, y si debe modificar archivos o solo proponer una solución:

En el plugin mi-plugin, añade un shortcode [servicios] que muestre una
lista de servicios.

- No modifiques WordPress Core.
- Registra el shortcode desde el archivo principal del plugin.
- Escapa correctamente la salida HTML.
- Primero explícame qué archivos vas a modificar.
- Después implementa el cambio y ejecuta una comprobación de sintaxis PHP.

Revisar y probar los cambios

Después de cualquier modificación, en la terminal de VS Code conectada al servidor:

git diff
git status

git diff muestra línea por línea qué cambió: lo que se quitó en rojo, lo que se agregó en verde.
Por ejemplo:

--- a/functions.php
+++ b/functions.php
@@ -12,7 +12,7 @@
-echo get_the_title();
+echo esc_html( get_the_title() );

Comprueba qué archivos cambiaron, si aparece algo no relacionado con el pedido, si se tocó WordPress Core, y si hay claves o datos privados de más.

Pruebas básicas, según lo que tenga el proyecto:

php -l ruta/al/archivo.php
composer test
npm run lint && npm run build
wp plugin list

Publicar los cambios

Una rama por cambio:

git checkout -b mejora-formulario-contacto
git add .
git commit -m "Mejora el formulario de contacto"

La publicación en producción se hace después de probar en staging, con el flujo de deploy que ya uses.
Para quien recién empieza, conviene dejar reglas explícitas en el CLAUDE.md: no hacer deploy, no ejecutar comandos destructivos, no borrar archivos, no modificar la base de datos ni wp-config.php, y no trabajar sobre producción sin mostrar antes el plan.

Errores que conviene evitar

• Ejecutar Claude Code sin saber bien en qué servidor y en qué carpeta se está trabajando.
• Trabajar directo sobre producción, sin staging ni copia de seguridad.
• Compartir la clave privada SSH o guardar claves de API en el repositorio.
• Pedir un cambio grande y poco específico, en vez de varios cambios chicos.
• Aceptar comandos sin leerlos, o no revisar git diff antes de aprobar.
• Confundir archivos PHP con datos de la base de datos: editar wp-content no cambia por sí solo las páginas y entradas guardadas en la base de datos.

Checklist antes de empezar

• Tengo acceso SSH y probé la conexión.
• Sé en qué carpeta exacta está (o deben estar) mis sitios, sobre todo si comparto cuenta de hosting con otros.
• Tengo una copia de seguridad reciente, de archivos y de base de datos.
• Estoy trabajando en staging o en una rama de Git, no directo en producción.
• Claude Code y la extensión de VS Code están instalados y verificados.
• Creé el CLAUDE.md del proyecto con las reglas que no quiero repetir.
• Voy a revisar cada git diff antes de aprobar un cambio.
• No voy a compartir mi clave privada ni guardar credenciales en el repositorio.

Qué aporta TutorWP a este tema, y qué no

Esta guía es sobre programar: conectar Claude Code a un WordPress y usarlo para desarrollar.
El trabajo del día a día en varios sitios de clientes —qué sitio tiene actualizaciones pendientes, si las copias de seguridad están al día, el informe mensual para el cliente— es otro problema, y no es el que resuelve Claude Code.
Ahí es donde entra una herramienta de gestión centralizada: reúne en una sola lista las actualizaciones pendientes de todos tus sitios, muestra el estado de las copias de cada uno y arma el informe mensual en lenguaje claro para el cliente.
TutorWP es una opción en esta categoría, entre otras.