Abrir Claude Code con un Click: Botón de Escritorio para Cualquier Proyecto

La fricción mata el hábito. Cuando abrir una herramienta requiere cuatro pasos repetidos —abrir terminal, cd al proyecto, escribir claude, esperar— el costo psicológico se acumula. Hacerlo veinte veces al día en distintos proyectos genera una fatiga real que no tiene nada que ver con el trabajo en sí.

La solución es crear un archivo ejecutable en el escritorio que haga todo eso en un doble click.

El Problema Exacto

El flujo habitual de Claude Code:

1. Abrir terminal
2. cd /ruta/a/mi/proyecto
3. claude
4. Esperar que inicialice

Cuatro pasos que no aportan nada al trabajo real. El objetivo es colapsarlos en uno.

Requisitos

• Claude Code instalado y funcionando
• Saber dónde está la carpeta del proyecto
• Mac o Windows
• Dos minutos

El Prompt para Generarlo

En lugar de crear el archivo a mano, se puede usar al propio Claude para generarlo. El prompt completo:

Quiero crear un "botón" en mi escritorio que, al darle doble click, abra la terminal directamente en la carpeta de un proyecto y arranque Claude Code ahí mismo. Hazlo paso a paso y pregúntame lo que haga falta. Necesito que: detectes si estoy en Mac o Windows, me pidas la ruta a mi carpeta de proyecto, me preguntes si quiero modo normal o sin permisos, me preguntes cómo quiero llamar al botón, generes el archivo correcto (.command para Mac, .bat para Windows), verifiques que el binario de Claude existe antes de ejecutar, y me des instrucciones de uso incluyendo advertencias de seguridad.

Claude va a hacer las preguntas necesarias y entregar el archivo listo para usar.

Los Dos Modos de Operación

Al crear el botón, hay que elegir cómo Claude va a operar cuando se abra:

Modo Normal

Claude pide permiso antes de ejecutar operaciones sobre archivos o comandos del sistema. Cada acción requiere confirmación del usuario. Más lento, más seguro.

Modo Sin Permisos (--dangerously-skip-permissions)

Claude opera de forma autónoma sin pedir confirmación. Puede crear, editar, eliminar archivos y ejecutar comandos sin que el usuario apruebe cada paso.

Advertencia crítica: este modo solo debe usarse en proyectos de confianza. Concede acceso irrestricto al sistema de archivos y a la ejecución de comandos. En proyectos con código sensible o en entornos compartidos, usar modo normal.

Los Archivos que Se Generan

macOS — archivo .command

#!/bin/bash
cd "/ruta/a/tu/proyecto" || { echo "No se encontró la carpeta."; read -n 1 -s; exit 1; }
clear
echo "Abriendo Claude en tu proyecto..."
exec /Users/tu-usuario/.local/bin/claude --dangerously-skip-permissions

Reemplazar /ruta/a/tu/proyecto con la ruta real del proyecto y tu-usuario con el nombre de usuario del sistema.

Para encontrar la ruta exacta del binario de Claude:

which claude

Después de guardar el archivo, darle permisos de ejecución:

chmod +x nombre-del-archivo.command

Windows — archivo .bat

@echo off
cd /d "C:\ruta\a\tu\proyecto"
cls
echo Abriendo Claude en tu proyecto...
claude --dangerously-skip-permissions

Reemplazar C:\ruta\a\tu\proyecto con la ruta real. En Windows, Claude suele estar en el PATH del sistema por defecto, por lo que no hace falta especificar la ruta completa del binario.

Primer Uso: Pasar el Bloqueo de Seguridad

El sistema operativo va a bloquear el archivo la primera vez porque viene de un "desarrollador no identificado".

macOS: aparece un diálogo que dice que el archivo no se puede abrir. Hacer click derecho sobre el archivo → "Abrir" → confirmar en el diálogo. Solo ocurre una vez; después funciona con doble click.

Windows: SmartScreen muestra una pantalla azul de protección. Seleccionar "Más información" → "Ejecutar de todas formas". También ocurre solo la primera vez.

Personalizar el Ícono

Un archivo sin ícono reconocible en el escritorio pierde parte de su utilidad. Para darle identidad visual:

macOS (manual):

1. Copiar la imagen que se quiere usar como ícono (Cmd+C)
2. Seleccionar el archivo .command
3. Abrir "Obtener información" (Cmd+I)
4. Hacer click en el ícono pequeño en la esquina superior izquierda del panel
5. Pegar (Cmd+V)

macOS (automático con Homebrew):

brew install fileicon
fileicon set nombre-archivo.command ruta-imagen.png

Windows: Crear un acceso directo (.lnk) del archivo .bat, hacer click derecho → Propiedades → cambiar ícono. Si se tiene una imagen PNG, convertirla a .ico antes.

Variante Avanzada: Un Botón para Múltiples Proyectos

En lugar de un botón por proyecto, se puede crear uno solo que muestre un menú al abrirse. El flujo es:

1. El archivo muestra una lista numerada de proyectos
2. El usuario ingresa el número del proyecto
3. Se pregunta el modo de operación
4. Claude abre en la carpeta seleccionada

Esta variante es especialmente útil cuando se trabaja con más de tres proyectos activos. El archivo se genera con el mismo prompt anterior, especificando que se quiere la variante multi-proyecto y listando las carpetas.

Comandos de Referencia Rápida

Comando	Función	Sistema
which claude	Encuentra la ruta exacta del binario	macOS/Linux
chmod +x archivo.command	Da permisos de ejecución	macOS
cd /d "ruta"	Cambia de directorio (versión Windows)	Windows
--dangerously-skip-permissions	Activa modo autónomo sin confirmaciones	Ambos

Qué Pasa Cuando Funciona

Al doble clickear el botón: se abre una ventana de terminal, aparece el mensaje configurado ("Abriendo Claude en tu proyecto..."), y Claude inicializa directamente en la carpeta del proyecto, listo para trabajar. Sin navegación, sin comandos manuales.

El costo de configurar esto es dos minutos. El beneficio es recuperar esos cuatro pasos repetidos cada vez que se abre Claude, multiplicado por la cantidad de veces al día que se hace.