lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración principiante claude-codedesarrollolocalhostproxy

Portless: nombres estables para tus aplicaciones locales

Abre cada aplicación de desarrollo por su nombre y evita recordar qué puerto corresponde a cada proyecto o sesión.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Preparación

Comprueba Node.js ≥24 y npm, como exige el paquete publicado. Abre la carpeta de una aplicación Next.js con sus dependencias ya instaladas antes de ejecutar el ejemplo.

Paso 1: instala

npm install -g portless

Paso 2: inicia una aplicación

El ejemplo del README supone un proyecto Next.js:

portless myapp next dev

Si tu proyecto tiene otro servidor, consulta los ejemplos oficiales antes de cambiar su comando.

Comprobación

Abre https://myapp.localhost y confirma que muestra tu aplicación. Comprueba que los recursos y las conexiones del servidor de desarrollo funcionan.

Si algo falla

Si hay un problema de certificado, revisa la sección de confianza local. Para HTTP simple, el README documenta --no-tls. Si no se asigna el puerto correcto, comprueba cómo interpreta Portless tu script.

ver en .md ¿Prefieres el recurso entero?

Qué es

Portless es una herramienta de Vercel Labs que coloca un proxy delante de los servidores de desarrollo. Cada aplicación recibe una dirección con nombre bajo .localhost.

Para qué te sirve

  • Cuando trabajas con varias aplicaciones y confundes los puertos abiertos.
  • Cuando un agente necesita volver a la misma URL después de reiniciar el servidor.
  • Cuando quieres una dirección legible para probar un monorepo.

Cómo funciona

El proxy arranca con la aplicación y asigna un puerto al proceso. Para algunos frameworks transmite PORT y para otros inyecta opciones conocidas. La dirección pública local conserva el nombre aunque cambie el puerto interno. La versión consultada activa HTTPS y HTTP/2 por defecto.

Antes de empezar

Necesitas Node.js ≥24, npm y disponer del comando de desarrollo de tu aplicación con sus dependencias instaladas. La primera ejecución genera una autoridad certificadora local y configura confianza. En macOS y Linux puede pedir elevación para usar el puerto 443.

Límites y alternativas

El proyecto aún está antes de la versión 1.0: el formato del estado puede cambiar. Los scripts compuestos no siempre admiten inyección de opciones. Comprueba la documentación si tu framework ignora PORT. Un proxy configurado a mano es otra opción con más mantenimiento.

Recursos