Conecta Blender con Claude AI a través del Model Context Protocol.
Controla escenas 3D, crea objetos, aplica materiales y ejecuta código Python
directamente desde Claude usando lenguaje natural.
📅 Abril 2026⏱ ~15 min🔧 Nivel: Básico
Última versión verificada: blender-mcp v1.5.6
01 Cómo funciona
BlenderMCP crea un puente de comunicación entre Claude AI y Blender.
El sistema tiene dos componentes principales que se comunican a través de un protocolo JSON sobre sockets TCP.
🤖
Claude Desktop
Envía comandos
⟷
⚙️
Servidor MCP
server.py · uvx
⟷
🧊
Blender
addon.py · Puerto 9876
Cuando le pides algo a Claude relacionado con Blender, el Servidor MCP traduce la petición en comandos JSON
que envía al addon de Blender, el cual los ejecuta usando la API de Python de Blender (bpy).
Los resultados vuelven por el mismo camino.
02 Requisitos previos
Antes de comenzar, asegúrate de tener instalado lo siguiente:
Blender 3.0 o superior — Descárgalo desde blender.org
Claude Desktop — La aplicación de escritorio de Claude (con suscripción activa)
Python 3.10 o superior — Normalmente ya viene con Blender, pero si instalas UV no necesitas instalarlo aparte
Conexión a internet — Necesaria para descargar UV y el paquete blender-mcp
03 Instalar UV
¿Qué es UV?
UV es un gestor de paquetes de Python ultrarrápido. Lo necesitas porque blender-mcp está escrito en Python
y UV se encarga de descargarlo y ejecutarlo automáticamente cada vez que Claude lo necesita. Sin UV, Claude no puede lanzar el servidor MCP.
Instalación en Windows
Abre PowerShell (pulsa la tecla Windows, escribe "PowerShell" y haz clic en "Windows PowerShell"). Luego copia y pega este comando:
Esto descarga e instala UV en la carpeta C:\Users\TuUsuario\.local\bin\.
Instalación en macOS
Terminal
brew install uv
⚠️Importante: No continúes con los siguientes pasos sin haber instalado UV correctamente. El resto del proceso depende de que UV esté funcionando.
04 Configurar el PATH
💡¿Qué es el PATH? Es una lista de carpetas donde Windows busca los programas ejecutables.
Cuando escribes uv en la consola, Windows recorre todas las carpetas del PATH para encontrar ese programa.
Si la carpeta donde se instaló UV no está en esa lista, Windows dirá "no reconozco ese comando".
En la misma ventana de PowerShell, pega estas tres líneas y pulsa Enter:
PowerShell
# Línea 1: Guarda la ruta donde se instaló UV
$localBin = "$env:USERPROFILE\.local\bin"
# Línea 2: Lee tu PATH actual de usuario
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
# Línea 3: Añade la carpeta de UV al final del PATH
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")
Verificar la instalación
Cierra PowerShell, ábrelo de nuevo y escribe:
PowerShell
uv --version
✅Si ves un número de versión como uv 0.6.x, la instalación ha sido correcta. Si ves un error, repite los pasos anteriores y asegúrate de reiniciar PowerShell.
05 Configurar Claude Desktop
Ahora hay que decirle a Claude dónde encontrar el servidor MCP de Blender.
Abre Claude Desktop
Ve a Settings (icono de engranaje ⚙️)
Haz clic en la sección Developer
Haz clic en Edit Config
Se abrirá el archivo claude_desktop_config.json en un editor de texto
ℹ️¿Qué hace esta configuración? Le dice a Claude que cuando necesite el servidor de Blender,
ejecute el comando uvx blender-mcp. UV se encargará automáticamente de descargar el paquete
si es la primera vez, o de usarlo si ya está descargado. No necesitas ejecutar nada manualmente.
Después de guardar, cierra Claude Desktop completamente (no solo minimizar, sino cerrar del todo) y vuelve a abrirlo.
En la ventana de preferencias, ve a la pestaña Add-ons
Haz clic en "Install from Disk..." (o "Install..." en versiones anteriores)
Navega hasta el archivo addon.py que descargaste y selecciónalo
Activa el addon marcando el checkbox junto a "Interface: Blender MCP"
⚠️Importante: Asegúrate de que la versión del addon (addon.py) sea compatible con la versión del servidor MCP.
Si actualizas uno, actualiza el otro. De lo contrario pueden aparecer errores de comandos desconocidos.
07 Conectar y verificar
En Blender
En el viewport 3D, pulsa la tecla N para abrir la barra lateral
Busca la pestaña "BlenderMCP"
Opcionalmente, activa los checkboxes de Poly Haven, Hyper3D, Sketchfab o Hunyuan3D si quieres esas integraciones
Haz clic en "Connect to Claude"
Debería aparecer el mensaje: "Running on port 9876"
En Claude Desktop
Al abrir Claude Desktop, deberías ver un icono de martillo (🔨) en la interfaz de chat.
Al hacer clic verás las herramientas disponibles del MCP de Blender (normalmente 22 herramientas).
Prueba rápida
Escribe en Claude algo como:
Prompt para Claude
"Dime qué objetos hay en mi escena de Blender"
✅
Si Claude responde con información sobre los objetos de tu escena (por defecto un cubo, una cámara y una luz),
¡la conexión funciona correctamente! Ya puedes empezar a crear con lenguaje natural.
08 Resolución de problemas
❌ "uv no se reconoce como comando"
El PATH no se configuró correctamente. Repite el Paso 04,
cierra y abre PowerShell de nuevo, y verifica con uv --version.
❌ Claude no muestra el icono del martillo
Verifica que el archivo claude_desktop_config.json está bien formateado (sin comas extra ni errores de sintaxis).
Cierra Claude Desktop completamente y ábrelo de nuevo.
❌ "Unknown command type" en los logs
La versión del addon en Blender no coincide con la del servidor MCP. Descarga el addon.py más reciente
de GitHub y reemplaza el antiguo en Blender.
❌ Error de conexión / timeout
Asegúrate de que el servidor MCP en Blender está corriendo (debe decir "Running on port 9876")
No ejecutesuvx blender-mcp manualmente en la terminal — Claude lo gestiona automáticamente
Si persiste, reinicia tanto Blender como Claude Desktop
Si el puerto 9876 está ocupado, puedes cambiarlo en el panel BlenderMCP
❌ Las operaciones complejas fallan
Intenta dividir la petición en pasos más pequeños. En lugar de "crea una escena completa con un dragón y un castillo",
prueba paso a paso: primero el castillo, luego el dragón, luego los materiales, etc.
GitGitHubPrincipiantes — Intermedio
Git & GitHub — Comandos esenciales
Guía completa de los comandos de Git para controlar versiones, subir archivos,
hacer commits, push, pull, gestionar ramas y colaborar en proyectos a través de GitHub.
Con ejemplos prácticos en cada paso.
📅 Abril 2026⏱ ~25 min🔧 Nivel: Básico → Intermedio
01 ¿Qué es Git y GitHub?
Git es un sistema de control de versiones. Piensa en él como un "historial de guardados"
para tus proyectos. Cada vez que haces un commit, Git guarda una foto del estado actual de tus archivos.
Puedes volver a cualquier versión anterior en cualquier momento.
GitHub es una plataforma online donde puedes subir tus repositorios Git para tenerlos en la nube,
compartirlos con otros y colaborar en equipo. Git funciona en local; GitHub funciona en remoto.
📁
Directorio de trabajo
Tus archivos locales
→
📋
Staging Area
git add
→
💾
Repositorio Local
git commit
→
☁️
GitHub
git push
💡Analogía simple: Git es como un álbum de fotos de tu proyecto.
git add = elegir las fotos que quieres guardar.
git commit = pegarlas en el álbum con una nota.
git push = subir el álbum a la nube.
02 Instalación y configuración inicial
Instalar Git
Windows: Descarga el instalador desde git-scm.com y ejecútalo con las opciones por defecto.
macOS:
Terminal
brew install git
Linux (Ubuntu/Debian):
Terminal
sudo apt update && sudo apt install git
Verificar la instalación
Terminal / PowerShell
git --version
# Debería mostrar algo como: git version 2.45.0
Configuración obligatoria (primera vez)
Git necesita saber quién eres para firmar los commits. Esto solo se hace una vez:
Terminal / PowerShell
# Tu nombre (aparecerá en cada commit)
git config --global user.name "Tu Nombre"# Tu email (debe coincidir con el de tu cuenta de GitHub)
git config --global user.email "tu@email.com"# Establecer la rama principal como "main" (estándar actual)
git config --global init.defaultBranch "main"# Verificar tu configuración
git config --list
ℹ️--global significa que esta configuración se aplica a todos tus proyectos.
Si quieres configurar un nombre/email diferente solo para un proyecto, usa el mismo comando
sin --global dentro de la carpeta del proyecto.
03 Crear un repositorio
Opción A: Crear un repositorio nuevo desde cero
Si ya tienes una carpeta con tu proyecto y quieres empezar a usar Git:
Terminal / PowerShell
# Navega a la carpeta de tu proyecto
cd C:\Users\TuUsuario\MiProyecto
# Inicializa Git en esta carpeta
git init
# Resultado: Initialized empty Git repository in C:/Users/.../MiProyecto/.git/
Esto crea una carpeta oculta .git/ dentro de tu proyecto. Ahí Git almacena todo el historial.
Opción B: Clonar un repositorio existente de GitHub
Si quieres descargar un proyecto que ya existe en GitHub:
Terminal / PowerShell
# Clonar un repositorio (descarga todo el proyecto + historial)
git clone https://github.com/usuario/nombre-repo.git
# Ejemplo real:
git clone https://github.com/ahujasid/blender-mcp.git
# Clonar en una carpeta con nombre específico
git clone https://github.com/usuario/repo.git mi-carpeta
Pon un nombre al repositorio, elige público o privado
Marca "Add a README file" para que no esté vacío
Haz clic en "Create repository"
Copia la URL y clónalo con git clone URL
✅Recomendación: Para principiantes, la Opción C es la más sencilla.
Creas el repo en GitHub, lo clonas en tu PC, y empiezas a trabajar. Así te ahorras configurar el remoto manualmente.
04 Flujo básico — add, commit, push
Este es el flujo que usarás el 90% del tiempo. Son tres comandos que debes memorizar:
git status — Ver qué ha cambiado
Terminal
git status
# Muestra:# - Archivos modificados (en rojo)# - Archivos listos para commit (en verde)# - Archivos nuevos no rastreados
git add — Seleccionar archivos para el commit
Terminal
# Añadir UN archivo específico
git add index.html
# Añadir VARIOS archivos
git add index.html styles.css script.js
# Añadir TODOS los archivos modificados y nuevos
git add .
# Añadir todos los archivos de una carpeta
git add src/
# Añadir todos los archivos de un tipo
git add *.py
💡¿Qué hace git add? Mueve los archivos al "Staging Area" (área de preparación).
Es como poner las cosas en una caja antes de enviarlas. Puedes elegir qué va en la caja y qué no.
git add . (con punto) mete todo.
git commit — Guardar los cambios con un mensaje
Terminal
# Commit con mensaje descriptivo
git commit -m "Añade página de contacto con formulario"# Commit con título y descripción más larga
git commit -m "Añade sistema de login" -m "Incluye validación de email, hash de contraseñas y tokens JWT"# Atajo: add + commit de archivos YA rastreados (no nuevos)
git commit -am "Corrige bug en el footer"
⚠️Buenos mensajes de commit: Escribe mensajes claros y descriptivos.
❌ Malo: "cambios", "fix", "asdf".
✅ Bueno: "Corrige error de carga en página de productos", "Añade modo oscuro al dashboard".
git push — Subir los commits a GitHub
Terminal
# Subir a la rama principal
git push origin main
# Si es la primera vez que haces push de esta rama
git push -u origin main
# Después de usar -u, basta con:
git push
# Subir a una rama específica
git push origin mi-rama
ℹ️-u (--set-upstream) vincula tu rama local con la rama remota.
Así la próxima vez solo necesitas escribir git push sin especificar destino.
Solo necesitas -u la primera vez para cada rama.
Ejemplo práctico completo
Ejemplo — Flujo diario típico
# 1. Verificar qué archivos cambiaron
git status
# 2. Añadir todo al staging
git add .
# 3. Confirmar los cambios con un mensaje
git commit -m "Actualiza estilos del header y añade logo"# 4. Subir a GitHub
git push
05 Ramas — branch, checkout, merge
Las ramas te permiten trabajar en funcionalidades nuevas sin tocar el código principal.
Es como crear una copia paralela de tu proyecto, trabajar en ella, y cuando esté lista,
unirla de vuelta al original.
Ver y crear ramas
Terminal
# Ver todas las ramas locales (* = rama actual)
git branch
# Ver ramas locales y remotas
git branch -a
# Crear una rama nueva
git branch nueva-funcionalidad
# Crear una rama y cambiarte a ella directamente
git checkout -b nueva-funcionalidad
# Alternativa moderna (Git 2.23+)
git switch -c nueva-funcionalidad
Cambiar entre ramas
Terminal
# Cambiar a una rama existente
git checkout main
git checkout nueva-funcionalidad
# Alternativa moderna
git switch main
Fusionar ramas (merge)
Terminal
# Primero, ve a la rama que recibirá los cambios
git checkout main
# Fusionar la otra rama en main
git merge nueva-funcionalidad
# Si ya no necesitas la rama, elimínala
git branch -d nueva-funcionalidad
# Forzar eliminación (si tiene cambios sin fusionar)
git branch -D nueva-funcionalidad
Ejemplo práctico: Crear una feature
Ejemplo — Flujo con ramas
# 1. Crear rama para la nueva funcionalidad
git checkout -b feature/modo-oscuro
# 2. Trabajar, hacer cambios...
git add .
git commit -m "Implementa toggle de modo oscuro"# 3. Más cambios...
git add .
git commit -m "Añade transiciones suaves al cambio de tema"# 4. Subir la rama a GitHub
git push -u origin feature/modo-oscuro
# 5. Cuando esté lista, volver a main y fusionar
git checkout main
git merge feature/modo-oscuro
# 6. Subir main actualizado
git push
# 7. Limpiar: eliminar la rama
git branch -d feature/modo-oscuro
💡Convención de nombres: Es buena práctica nombrar ramas de forma descriptiva:
feature/nombre para nuevas funcionalidades,
fix/nombre para correcciones,
hotfix/nombre para arreglos urgentes.
06 Trabajo remoto — remote, pull, fetch
git remote — Gestionar conexiones remotas
Terminal
# Ver los remotos configurados
git remote -v
# Añadir un remoto (si usaste git init en vez de clone)
git remote add origin https://github.com/tu-usuario/tu-repo.git
# Cambiar la URL de un remoto
git remote set-url origin https://github.com/tu-usuario/nuevo-repo.git
# Eliminar un remoto
git remote remove origin
git pull — Descargar y fusionar cambios remotos
Terminal
# Descargar cambios de GitHub y fusionarlos automáticamente
git pull
# Equivale a: git fetch + git merge
git pull origin main
# Pull con rebase (más limpio, sin commit de merge)
git pull --rebase origin main
⚠️Regla de oro: Siempre haz git pullantes de empezar a trabajar y
antes de hacer push. Así evitas conflictos con los cambios de otros colaboradores.
git fetch — Solo descargar (sin fusionar)
Terminal
# Descargar info del remoto sin tocar tus archivos
git fetch
# Ver qué cambió antes de fusionar
git log HEAD..origin/main --oneline
# Si te convence, fusionar
git merge origin/main
Conectar un repo local existente con GitHub
Si hiciste git init y ahora quieres subirlo a GitHub:
Ejemplo — Subir proyecto existente
# 1. Crea el repositorio en github.com/new (sin README)# 2. En tu carpeta local:
git init
git add .
git commit -m "Primer commit"# 3. Conectar con GitHub
git remote add origin https://github.com/tu-usuario/tu-repo.git
# 4. Subir por primera vez
git push -u origin main
07 Historial y deshacer cambios
git log — Ver historial de commits
Terminal
# Historial completo
git log
# Historial resumido (una línea por commit)
git log --oneline
# Historial con gráfico de ramas
git log --oneline --graph --all
# Últimos 5 commits
git log -5 --oneline
# Historial de un archivo específico
git log --oneline -- archivo.py
git diff — Ver diferencias
Terminal
# Ver cambios no añadidos al staging
git diff
# Ver cambios ya añadidos al staging
git diff --staged
# Diferencias entre dos commits
git diff abc1234 def5678
# Diferencias entre dos ramas
git diff main..feature/mi-rama
Deshacer cambios
Terminal
# Descartar cambios en un archivo (volver a la última versión)
git checkout -- archivo.txt
# Alternativa moderna
git restore archivo.txt
# Sacar un archivo del staging (después de git add)
git reset HEAD archivo.txt
# Alternativa moderna
git restore --staged archivo.txt
# Deshacer el último commit (manteniendo los cambios)
git reset --soft HEAD~1
# Deshacer el último commit (eliminando los cambios)
git reset --hard HEAD~1
# Crear un nuevo commit que revierte uno anterior (más seguro)
git revert abc1234
⚠️Cuidado con --hard:git reset --hard elimina cambios permanentemente.
Úsalo solo si estás seguro. Si ya hiciste push, usa git revert en su lugar,
que es más seguro porque crea un nuevo commit en vez de borrar historial.
08 .gitignore — Excluir archivos
El archivo .gitignore le dice a Git qué archivos o carpetas debe ignorar.
Se coloca en la raíz del proyecto. Es fundamental para no subir contraseñas, archivos temporales,
o dependencias pesadas.
.gitignore — Ejemplo típico
# Dependencias
node_modules/
__pycache__/
.venv/
venv/
# Archivos de entorno y secretos
.env
.env.local
*.secret
# Archivos del sistema operativo
.DS_Store
Thumbs.db
desktop.ini
# Archivos de IDE/editor
.vscode/
.idea/
*.swp
*.swo
# Archivos compilados
dist/
build/
*.exe
*.dll
*.o
# Logs y temporales
*.log
tmp/
temp/
# Archivos de Blender
*.blend1
*.blend2
ℹ️Consejo: GitHub ofrece plantillas de .gitignore para distintos lenguajes y frameworks en
github.com/github/gitignore.
También puedes generarlos automáticamente en gitignore.io.
09 Tags y releases
Los tags marcan puntos importantes en tu historial, como versiones de software.
Terminal
# Crear un tag ligero
git tag v1.0.0
# Crear un tag anotado (con mensaje, recomendado)
git tag -a v1.0.0 -m "Primera versión estable"# Ver todos los tags
git tag
# Ver detalles de un tag
git show v1.0.0
# Subir un tag a GitHub
git push origin v1.0.0
# Subir TODOS los tags
git push origin --tags
# Eliminar un tag local
git tag -d v1.0.0
# Eliminar un tag remoto
git push origin --delete v1.0.0
💡Versionado semántico: El estándar es vMAJOR.MINOR.PATCH.
Ejemplo: v1.0.0 → v1.0.1 (bugfix) → v1.1.0 (nueva feature) → v2.0.0 (cambio grande).
10 Flujo de trabajo completo
Aquí tienes un ejemplo realista de un día trabajando con Git y GitHub, de principio a fin:
Ejemplo práctico — Día de trabajo completo
# ═══════════════════════════════════════════# MAÑANA — Empezar el día# ═══════════════════════════════════════════# 1. Ir a la carpeta del proyecto
cd mi-proyecto
# 2. Asegurarte de estar en main
git checkout main
# 3. Descargar últimos cambios del equipo
git pull
# 4. Crear una rama para tu tarea del día
git checkout -b feature/sistema-de-busqueda
# ═══════════════════════════════════════════# TRABAJO — Hacer cambios# ═══════════════════════════════════════════# 5. Trabajas en tus archivos... editas, creas, borras# 6. Ver qué modificaste
git status
# 7. Primer commit del día
git add .
git commit -m "Añade barra de búsqueda en el header"# 8. Más trabajo...
git add .
git commit -m "Implementa filtrado de resultados por categoría"# 9. Subir tu rama a GitHub (primera vez con -u)
git push -u origin feature/sistema-de-busqueda
# ═══════════════════════════════════════════# TARDE — Finalizar y fusionar# ═══════════════════════════════════════════# 10. Último commit
git add .
git commit -m "Añade tests para la función de búsqueda"
git push
# 11. Volver a main y fusionar
git checkout main
git pull
git merge feature/sistema-de-busqueda
# 12. Subir main con los cambios fusionados
git push
# 13. Limpiar la rama
git branch -d feature/sistema-de-busqueda
git push origin --delete feature/sistema-de-busqueda
11 Cheatsheet rápida
Referencia rápida de todos los comandos esenciales:
Configuración
git config --global user.name "Nombre"# Tu nombre
git config --global user.email "email"# Tu email
git config --list # Ver configuración
Crear repositorios
git init # Nuevo repo local
git clone <url> # Clonar repo remoto
Flujo básico
git status # Ver estado
git add . # Añadir todo al staging
git add <archivo> # Añadir archivo específico
git commit -m "mensaje"# Guardar cambios
git push # Subir a GitHub
git pull # Bajar de GitHub
git remote -v # Ver remotos
git remote add origin <url> # Añadir remoto
git fetch # Descargar sin fusionar
git push -u origin <rama> # Push primera vez
git tag -a v1.0.0 -m "msg"# Crear tag
git push origin --tags # Subir tags
Claude CodeTerminalPrincipiantes
Instalar Claude Code desde terminal
Instalación paso a paso de Claude Code, la herramienta de línea de comandos que te permite
usar Claude directamente desde tu terminal para desarrollar, depurar y automatizar tareas con IA.
📅 Abril 2026⏱ ~10 min🔧 Nivel: Básico
01 ¿Qué es Claude Code?
Claude Code es la herramienta oficial de Anthropic para usar Claude directamente
desde la línea de comandos. Te permite delegar tareas de programación a Claude: escribir código,
depurar errores, refactorizar, crear tests, leer documentación y ejecutar comandos en tu sistema.
A diferencia de Claude Desktop (interfaz de chat), Claude Code está pensado para desarrolladores
y se integra directamente con tu flujo de trabajo en el terminal, con acceso al sistema de archivos
y capacidad de ejecutar comandos.
💻
Tu terminal
Prompts + comandos
→
🤖
Claude Code
claude
→
📁
Tu proyecto
Lee y edita archivos
💡Diferencia clave: Claude Desktop = conversación casual en una ventana.
Claude Code = Claude trabajando en tu proyecto con acceso real a tus archivos y terminal.
02 Requisitos previos
Antes de instalar Claude Code, asegúrate de tener:
Node.js 18 o superior — Descárgalo desde nodejs.org (versión LTS)
Cuenta de Anthropic — Con acceso a Claude (suscripción Pro o API key)
Terminal — PowerShell en Windows, Terminal en macOS, o cualquier terminal en Linux
Un editor de código — VS Code recomendado, pero funciona con cualquiera
Verificar Node.js
Terminal
node --version
# Debería mostrar v18.x.x o superior
npm --version
# Debería mostrar 9.x.x o superior
⚠️Si no tienes Node.js: Instálalo primero desde nodejs.org antes de continuar.
Claude Code se distribuye como un paquete de npm, así que necesitas Node obligatoriamente.
03 Instalación
Instalación global con npm
Abre tu terminal (PowerShell en Windows, Terminal en macOS/Linux) y ejecuta:
Terminal
npm install -g @anthropic-ai/claude-code
La instalación puede tardar entre 30 segundos y 2 minutos dependiendo de tu conexión. Verás algo como:
Salida esperada
added 142 packages in 45s
35 packages are looking for funding
run 'npm fund' for details
Verificar la instalación
Terminal
claude --version
# Debería mostrar: claude-code 1.x.x
✅
Si ves un número de versión, Claude Code está instalado correctamente. Si recibes un error de
comando no encontrado, revisa la sección de resolución de problemas al final.
04 Configuración inicial y autenticación
Primera ejecución
Navega a cualquier carpeta de proyecto y ejecuta:
Terminal
cd mi-proyecto
claude
La primera vez te pedirá autenticarte. Tienes dos opciones:
Opción A: Autenticación con cuenta Claude (recomendada)
Claude Code abrirá una URL en tu navegador automáticamente
Inicia sesión con tu cuenta de Claude (la misma de claude.ai)
Autoriza el acceso de Claude Code
Vuelve al terminal — la autenticación queda guardada
Opción B: Con API key
Si prefieres usar una API key, primero créala en console.anthropic.com y luego configúrala:
Terminal (macOS/Linux)
export ANTHROPIC_API_KEY="sk-ant-..."# Para que sea permanente, añádelo a ~/.zshrc o ~/.bashrc:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
PowerShell (Windows)
# Temporal (solo esta sesión)
$env:ANTHROPIC_API_KEY="sk-ant-..."# Permanente
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-...", "User")
⚠️Nunca compartas tu API key ni la subas a GitHub. Si la expones por error,
revócala inmediatamente en console.anthropic.com y crea una nueva.
05 Primer uso — Comandos básicos
Iniciar Claude Code
Terminal
# Navega a tu proyecto
cd mi-proyecto
# Inicia Claude Code
claude
Verás un prompt interactivo donde puedes escribir tus peticiones en lenguaje natural.
Ejemplos de peticiones útiles
Ejemplos
# Explorar un proyecto"Explícame qué hace este proyecto revisando los archivos principales"# Crear código"Crea un endpoint en Express que devuelva los usuarios de la base de datos"# Depurar"Este error me aparece cuando ejecuto npm start, ayúdame a solucionarlo"# Refactorizar"Refactoriza el archivo utils.js para que use async/await en lugar de promesas"# Documentar"Genera un README completo basándote en el código de este proyecto"# Tests"Escribe tests unitarios para las funciones del archivo auth.js"
Comandos especiales dentro de Claude Code
Comandos slash
/help # Ver ayuda
/clear # Limpiar el historial de la conversación
/cost # Ver cuánto has gastado
/model # Cambiar de modelo (opus, sonnet, haiku)
/exit # Salir de Claude Code
ℹ️Tip: Claude Code puede leer y editar tus archivos automáticamente. Antes de hacer
cambios importantes, pedirá tu confirmación. También respeta el archivo .gitignore.
06 Integración con Visual Studio Code
Claude Code se integra perfectamente con VS Code a través de su terminal integrado.
Abre VS Code en tu proyecto: code mi-proyecto
Abre la terminal integrada con Ctrl + ` (backtick)
Ejecuta claude directamente en esa terminal
Claude Code detectará automáticamente el workspace abierto
Extensión oficial (opcional)
Existe una extensión oficial de Claude Code para VS Code que añade integración visual:
En VS Code, ve a Extensions (Ctrl+Shift+X)
Busca "Claude Code"
Instala la extensión oficial de Anthropic
Reinicia VS Code
✅
Con la extensión podrás invocar a Claude Code con atajos de teclado, ver las ediciones propuestas
en diff visual y aprobar cambios con un clic.
07 Resolución de problemas
❌ 'claude' no se reconoce como comando
El directorio de npm global no está en el PATH. Verifica dónde se instaló:
Terminal
npm config get prefix
# Normalmente muestra algo como:# Windows: C:\Users\TuUsuario\AppData\Roaming\npm# macOS/Linux: /usr/local o ~/.npm-global
En Windows, añade esa ruta al PATH (Variables de Entorno del sistema). En macOS/Linux:
Terminal (macOS/Linux)
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc
❌ Error de permisos al instalar (Linux/macOS)
Si ves EACCES al instalar, no uses sudo. Configura npm para usar un directorio local:
Ejecuta claude logout para cerrar la sesión actual
Vuelve a ejecutar claude para iniciar sesión de nuevo
Si persiste, verifica que tu suscripción de Claude está activa
Comprueba en console.anthropic.com si usas API key
❌ Claude es lento o da timeout
Normalmente es por problemas de red o el modelo que uses. Prueba:
Terminal
# Cambiar al modelo más rápido
claude --model haiku
# Ver estadísticas de uso
claude --verbose
HostingerDespliegueReact / Vite
Subir el proyecto React a Hostinger
Guía completa para compilar tu aplicación React (Vite) y subirla a Hostinger para tenerla
accesible en internet con tu propio dominio. Incluye configuración del panel, FTP y troubleshooting.
📅 Abril 2026⏱ ~20 min🔧 Nivel: Básico → Intermedio
01 ¿Qué vamos a hacer?
Tu proyecto React/Vite funciona en local con npm run dev, pero eso solo lo ves tú en tu ordenador.
Para que cualquier persona pueda acceder a tu página desde internet, necesitas compilarla
y subirla a un hosting.
Hostinger es un proveedor de hosting popular y asequible. Ofrece planes desde ~3€/mes que
incluyen dominio propio, SSL gratuito y panel de control (hPanel) fácil de usar.
💻
Tu proyecto
npm run build
→
📦
Carpeta dist/
HTML + JS + CSS
→
☁️
Hostinger
File Manager o FTP
→
🌐
Tu dominio
tudominio.com
ℹ️React y Vite generan una aplicación estática (HTML + JavaScript + CSS).
Esto significa que puedes subirla a cualquier hosting tradicional como Hostinger, sin necesidad
de Node.js en el servidor.
02 Requisitos previos
Cuenta en Hostinger — Con un plan activo (Premium, Business o Cloud)
Dominio — Puede ser uno que compres en Hostinger o uno externo
Tu proyecto React/Vite funcionando — Con npm run dev en local
Cliente FTP (opcional) — FileZilla recomendado, aunque también puedes usar el File Manager de Hostinger
⚠️Importante: Los planes Single y Starter de Hostinger tienen limitaciones.
Para un proyecto React sin problemas, se recomienda al menos el plan Premium.
03 Paso 1 — Preparar el build del proyecto
Configurar Vite para producción
Antes de compilar, revisa el archivo vite.config.js en la raíz de tu proyecto.
Si tu sitio va a estar en la raíz del dominio (ejemplo: tudominio.com/), la configuración
por defecto funciona. Si va a estar en una subcarpeta, añade la opción base:
En tu lista de websites, haz clic en Manage junto al dominio donde quieres subir el proyecto
Entrarás al panel de control de ese sitio (hPanel)
Localizar la carpeta pública
En Hostinger, los archivos de tu web deben subirse a una carpeta específica. Dependiendo del plan puede llamarse:
Rutas comunes en Hostinger
public_html/ # Carpeta principal (más común)
domains/tudominio.com/public_html/ # Si tienes varios dominios
⚠️Asegúrate de la carpeta correcta: Todo lo que subas fuera de public_html/
NO será accesible desde internet. Todo lo que subas dentro SÍ será público.
05 Paso 3 — Subir los archivos
Tienes dos métodos principales. El File Manager es más fácil, FTP es más rápido para proyectos grandes.
Opción A: File Manager (recomendada para principiantes)
En hPanel, busca File Manager en el menú lateral
Navega hasta la carpeta public_html/
Importante: Si ya hay archivos (como default.php o index.html de demo), elimínalos primero
Haz clic en Upload Files (botón arriba a la derecha)
Selecciona TODOS los archivos dentro de tu carpeta dist/ — NO la carpeta dist entera, sino su contenido
Espera a que se suban todos (puede tardar varios minutos)
💡Sube el CONTENIDO de dist/, no la carpeta dist/: Selecciona index.html,
la carpeta assets/, y los demás archivos dentro de dist. Si subes dist/ como
carpeta, tu web estaría en tudominio.com/dist/ y no funcionará.
Opción B: FTP con FileZilla (más rápido)
Para obtener tus credenciales FTP:
En hPanel, ve a Files → FTP Accounts
Copia el Host (algo como ftp.tudominio.com)
Copia el Username y usa la contraseña que tengas configurada
Abre FileZilla y añade un nuevo sitio en Site Manager
Conecta y arrastra el contenido de dist/ a la carpeta public_html/
Configuración FTP típica
Host: ftp.tudominio.com
Port: 21
Protocol: FTP (o SFTP en puerto 22 si está disponible)
Username: u123456789
Password: ********
ℹ️SFTP es más seguro que FTP. Si Hostinger te lo ofrece, usa SFTP (puerto 22) siempre que puedas.
06 Paso 4 — Configurar el dominio y SSL
Verificar que el dominio apunta al hosting
Si compraste el dominio en Hostinger, ya está todo configurado automáticamente.
Si lo compraste en otro proveedor (GoDaddy, Namecheap, etc.), debes configurar los DNS:
En hPanel, ve a Domains → tu dominio
Copia los Nameservers (algo como ns1.dns-parking.com y ns2.dns-parking.com)
Ve al panel de tu proveedor de dominio y pega esos nameservers
Espera entre 1 y 24 horas a que se propaguen
Activar SSL (HTTPS)
Hostinger ofrece SSL gratuito con Let's Encrypt:
En hPanel, ve a Security → SSL
Selecciona tu dominio y haz clic en Install SSL
Espera unos minutos — aparecerá "Active" cuando esté listo
Activa también Force HTTPS para que todo el tráfico sea seguro
✅
Con SSL activo, tu web estará disponible como https://tudominio.com con el candado
verde en el navegador. Esto es obligatorio hoy en día para SEO y confianza del usuario.
07 Paso 5 — Probar el sitio
Abre tu navegador y visita tu dominio:
URL
https://tudominio.com
Deberías ver tu página de guías exactamente igual que en local. Prueba:
Navegar entre guías desde la sidebar
Comprobar que los bloques de código muestran correctamente
Verificar el botón de copiar código
Abrir desde un móvil para comprobar que el responsive funciona
✅
Si todo funciona, ¡felicidades! Tu proyecto React está oficialmente en producción.
Puedes compartir el enlace con quien quieras.
08 Actualizar la web en el futuro
Cada vez que hagas cambios en tu proyecto y quieras actualizarlos en el hosting, el proceso es:
Flujo de actualización
# 1. Haz tus cambios en el código# 2. Prueba en local
npm run dev
# 3. Cuando todo esté listo, compila
npm run build
# 4. Sube SOLO los archivos que cambiaron en dist/# (o reemplaza todo el contenido de public_html/)
Método rápido con File Manager
Selecciona TODO el contenido de public_html/ y elimínalo
Sube de nuevo el contenido completo de dist/
Este método es lento para proyectos grandes pero 100% seguro
Método óptimo: Deploy automático con Git
Para un workflow profesional, puedes configurar despliegue automático desde GitHub:
GitHub Actions + FTP Deploy — Deploy automático al hacer push
Netlify o Vercel — Alternativas gratuitas con deploy automático desde Git (recomendado)
Cloudflare Pages — Otra alternativa con CDN global gratuito
ℹ️Consejo profesional: Si tu proyecto es importante y lo vas a actualizar con frecuencia,
considera usar Vercel o Netlify en lugar de Hostinger. Son gratuitos
para proyectos personales, hacen deploy automático desde GitHub, y están optimizados para React/Vite.
09 Resolución de problemas
❌ Pantalla en blanco al abrir el sitio
Normalmente es un problema de rutas. Verifica que en vite.config.js tienes base: './' y vuelve a hacer npm run build.