01 La idea: un archivo que hace los tres pasos por ti
Arrancar Claude Code en un proyecto siempre es lo mismo: abrir la terminal, entrar en la carpeta con cd y escribir claude. Un lanzador es un pequeño archivo ejecutable que hace exactamente eso. En Mac es un archivo .command (se abre en Terminal con doble clic) y en Windows un .bat. No necesitas escribirlo tú: se lo pides a Claude Code y él lo genera y lo comprueba.
02 Antes de crear nada: elige el modo de permisos
El lanzador puede arrancar Claude con un modo de permisos concreto. Esta decisión importa más que el icono:
| Modo | Cómo se arranca | Para qué |
|---|---|---|
| Predeterminado | claude | El modo con el que tu versión arranca por defecto; recomendable para empezar |
| Automático | claude --permission-mode auto | Aprueba acciones rutinarias con comprobaciones de seguridad en segundo plano; ideal para tareas largas |
| Aceptar ediciones | claude --permission-mode acceptEdits | Edita archivos sin preguntar, pero consulta antes de ejecutar comandos |
| Sin permisos | claude --dangerously-skip-permissions | Lo hace todo sin preguntar; la documentación oficial lo reserva para contenedores o máquinas virtuales aisladas |
03 Paso 1: pídele a Claude Code que cree el lanzador
Abre Claude Code como siempre (en cualquier carpeta) y pega este prompt. Te hará preguntas, generará el archivo en tu escritorio y verificará que la ruta al programa es correcta.
Quiero un lanzador en mi escritorio que, con doble clic, abra la terminal en la carpeta de un proyecto y arranque Claude Code allí. Hazlo así:
1. Detecta si estoy en macOS o en Windows.
2. Pregúntame la ruta del proyecto; si no la sé, ayúdame a encontrarla y comprueba que existe.
3. Pregúntame el modo: predeterminado, automático (--permission-mode auto) o aceptar ediciones (--permission-mode acceptEdits). No ofrezcas --dangerously-skip-permissions.
4. Pregúntame el nombre del archivo (por defecto, el de la carpeta).
5. En macOS crea un .command que haga cd a la carpeta (saliendo con un mensaje si no existe), muestre «Abriendo Claude en [proyecto]» y ejecute Claude con la ruta absoluta que devuelva command -v claude. Dale permisos con chmod +x.
6. En Windows crea un .bat que haga cd /d a la carpeta y ejecute claude.
7. Comprueba que el binario existe en esa ruta y enséñame el contenido final del archivo antes de guardarlo.Repite el prompt para cada proyecto en el que trabajes a menudo. Como el archivo lo crea tu propio ordenador (no se descarga de internet), lo normal es que se abra sin avisos de seguridad.
04 Cómo son los archivos por dentro
No hace falta que los escribas, pero conviene entenderlos para retocarlos. En Mac, el instalador nativo deja Claude en ~/.local/bin/claude; usar la ruta completa evita fallos si la terminal no ha cargado el PATH.
#!/bin/bash
cd "$HOME/Proyectos/mi-web" || { echo "No encuentro la carpeta"; read -n 1; exit 1; }
clear
echo "Abriendo Claude en mi-web..."
exec "$HOME/.local/bin/claude" --permission-mode auto@echo off
cd /d "C:\Users\tu-usuario\Proyectos\mi-web" || (echo No encuentro la carpeta & pause & exit /b 1)
cls
echo Abriendo Claude en mi-web...
claude --permission-mode auto05 Paso 2: un icono para encontrarlo a la primera
-
1
Mac, a mano
Abre la imagen, cópiala (Cmd+C), selecciona el .command, pulsa Cmd+I para Obtener información, haz clic en el icono pequeño de arriba a la izquierda y pega (Cmd+V).
-
2
Mac, desde la terminal
La herramienta de código abierto fileicon (se instala con brew install fileicon) asigna iconos desde la línea de comandos; Claude puede hacerlo por ti.
-
3
Windows
Los .bat no admiten icono propio. Crea un acceso directo al .bat (clic derecho › Crear acceso directo), abre Propiedades › Cambiar icono y elige un archivo .ico. Usa el acceso directo como botón.
Ponle un icono al lanzador que acabas de crear usando esta imagen: [ruta de la imagen PNG o JPG]. En macOS usa fileicon si está instalado; si no lo está, pregúntame antes de instalarlo con Homebrew. En Windows convierte la imagen a .ico, crea un acceso directo al .bat en el escritorio y asígnale el icono.06 Extra: un solo lanzador con menú de proyectos
Con más de cuatro o cinco proyectos, el escritorio se llena de iconos. La alternativa es un único lanzador que muestre una lista numerada, te deje elegir proyecto y modo, y arranque Claude allí.
Crea en mi escritorio un único lanzador (.command en macOS o .bat en Windows) que al abrirse muestre una lista numerada de mis proyectos, me pida el número y luego el modo (predeterminado o automático), haga cd a esa carpeta y arranque Claude con la ruta absoluta del binario. Guarda la lista de proyectos en un bloque al principio del archivo, con comentarios que expliquen cómo añadir o quitar uno. Pregúntame primero las rutas y un nombre corto para cada proyecto, y valida que todas existen.07 Si no funciona
- ✓En Mac se abre en un editor en vez de en Terminal: falta el permiso de ejecución; ejecuta chmod +x sobre el archivo.
- ✓Aparece «command not found»: la ruta a claude del lanzador no es correcta; pídele a Claude que la vuelva a detectar.
- ✓La ventana se cierra al instante en Windows: añade pause al final del .bat para leer el error.
- ✓Has movido la carpeta del proyecto: edita la ruta del cd o vuelve a generar el lanzador.
Preguntas frecuentes
No. Claude Code escribe el archivo y lo comprueba; tú solo respondes a sus preguntas y lo revisas antes de guardarlo.
Sí. Crea dos archivos con nombres claros, por ejemplo «MiWeb» y «MiWeb (auto)», cada uno con su opción de arranque.
La idea es la misma con un script .sh o un archivo .desktop. Pídeselo a Claude indicando tu entorno de escritorio.
El lanzador solo abre la terminal y ejecuta Claude Code en una carpeta. El riesgo está en el modo de permisos que elijas, por eso esta guía desaconseja el modo sin permisos en un acceso directo.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.