Skip to main content
Un enlace profundo es una URL claude-cli:// que abre Claude Code en una nueva ventana de terminal. La URL puede llevar un directorio de trabajo y un mensaje para rellenar previamente. Esto le permite compartir un punto de partida de un clic para una tarea: cualquiera que tenga Claude Code instalado y haga clic en el enlace verá una sesión abierta con el mensaje ya escrito. El mensaje se rellena pero no se envía hasta que presione Intro. Debido a que un enlace profundo es una URL, puede colocarlo en cualquier lugar donde pueda ir un enlace:
  • Un paso de runbook de incidentes que abre el repositorio del servicio afectado con un mensaje de diagnóstico
  • Una alerta de monitoreo o panel que vincula a un mensaje de investigación para una métrica específica
  • Una página README o wiki que abre el proyecto con un mensaje de incorporación
  • Una notificación de fallo de CI que rellena previamente el nombre del trabajo fallido
Esta página cubre cómo construir un enlace, incrustar uno en un runbook o activarlo desde el shell, y administrar o deshabilitar el registro del controlador en cada plataforma. El prefijo claude-cli:// es un esquema de URL personalizado que Claude Code registra con su sistema operativo, similar a cómo los enlaces mailto: abren su cliente de correo electrónico. Cuando hace clic en un enlace profundo:
  1. El navegador o la aplicación entrega la URL a su sistema operativo.
  2. El sistema operativo reconoce el prefijo claude-cli:// e inicia Claude Code en su máquina.
  3. Se abre una nueva ventana de terminal con Claude Code ejecutándose en el directorio que especificó el enlace, y el texto del mensaje del enlace ya está en el cuadro de entrada.
  4. Lee el mensaje, lo edita si lo desea y presiona Intro para enviarlo.
El enlace en sí puede estar alojado en cualquier lugar, pero la sesión siempre se abre localmente en la computadora donde hizo clic. Consulte Registro y plataformas compatibles para ver qué emulador de terminal se abre en cada sistema operativo. La plataforma que muestra el enlace debe permitir esquemas de URL personalizados. Para saber qué hace GitHub con ellos y la solución alternativa, consulte El enlace se representa como texto sin formato en lugar de ser clickeable.

​
Qué muestra una sesión iniciada

Un enlace profundo nunca ejecuta nada por sí solo. El enlace solo elige un directorio y rellena el cuadro de mensaje. Si hace clic en un enlace de una página en la que no confía, el mensaje sigue siendo inerte: nada llega al modelo hasta que lea lo que se rellenó y presione Intro. Cuando se abre la sesión, una línea de advertencia debajo del cuadro de entrada lee Prompt from an external link y permanece visible hasta que envíe o borre el mensaje. Para mensajes de más de 1.000 caracteres, la advertencia incluye el recuento de caracteres y le indica que desplace y revise el texto completo antes de presionar Intro, ya que los mensajes largos pueden empujar las instrucciones fuera de la pantalla. Las reglas de permisos, CLAUDE.md y los mensajes de confianza para el directorio seleccionado se aplican de la misma manera que para cualquier otra sesión. Cada enlace profundo comienza con claude-cli://open, que es la única ruta que acepta el controlador, seguida de parámetros de consulta opcionales. La forma mínima abre Claude Code en su directorio de inicio con un mensaje vacío:
Para probar un enlace sin colocarlo en una página, péguelo en la barra de direcciones de su navegador o ábralo desde el shell. Agregue parámetros para controlar dónde comienza la sesión y qué contiene el cuadro de mensaje: cwd y repo son dos formas de establecer el directorio de trabajo. Si pasa ambos, cwd tiene prioridad e repo se ignora, incluso si la ruta cwd no existe. El siguiente enlace apunta a un repositorio llamado acme/payments con un mensaje de diagnóstico de dos líneas. Reemplace acme/payments con el slug owner/name de su repositorio cuando construya el suyo:
Al hacer clic en él, se abre una nueva ventana de terminal, se inicia Claude Code en su clon local de acme/payments y se rellena el cuadro de mensaje con el texto decodificado:
Puede editar el mensaje antes de presionar Intro para enviarlo. Consulte Elegir entre cwd y repo para saber cómo se selecciona la ruta local cuando tiene múltiples clones o worktrees.

​
Elegir entre cwd y repo

Use cwd cuando todos los que hagan clic en el enlace tengan el proyecto en la misma ruta absoluta, como un devcontainer estandarizado o una imagen de VM. Use repo cuando el enlace se comparte y cada persona clona en una ubicación diferente. Claude Code resuelve el slug a una ruta local de la siguiente manera:
  • repo abre el clon o worktree del repositorio vinculado donde ejecutó claude más recientemente. Cada vez que ejecuta claude en un repositorio de Git, Claude Code registra la ruta de ese directorio contra el slug owner/name de GitHub del repositorio. Claude Code rastrea clones y worktrees por separado.
  • El enlace no cambia qué rama está desprotegida. La sesión se abre en el estado actual de ese directorio.
El encabezado de bienvenida muestra qué ruta eligió para que pueda confirmar que se abrió el clon correcto.

​
Ejemplos

Las secciones a continuación muestran dos formas comunes de usar un enlace profundo: como un enlace Markdown en un documento y como un comando en un script o alias de shell. Un enlace profundo en un runbook le da a quien está triando una forma de un clic para comenzar a investigar en el repositorio correcto con un mensaje preparado. La plataforma que representa el runbook debe permitir esquemas de URL personalizados. El Markdown representado por GitHub no permite claude-cli://, por lo que un enlace profundo en un README, problema o wiki de GitHub muestra solo su etiqueta sin enlace clickeable. Consulte la nota de solución de problemas para obtener una solución alternativa. El mensaje es parte de la URL y debe estar codificado en URL. Para producir el valor codificado, pase el texto del mensaje a través de encodeURIComponent en una consola del navegador o cualquier codificador de URL. El ejemplo a continuación agrega un punto de entrada de investigación a un runbook de incidentes para un servicio llamado web-gateway:
Para usar esto en su propio runbook, reemplace acme/web-gateway con el slug del repositorio de su servicio. Esto permite que los ingenieros con Claude Code instalado y un clon local de ese repositorio hagan clic en el paso 2 e inicien la investigación con el mensaje listo para enviar. También puede abrir un enlace profundo desde un script de shell, alias o automatización en lugar de hacer clic en él. Llame al comando de apertura de URL de su sistema operativo con el enlace como argumento. Estos comandos se basan en el controlador que Claude Code registra cuando envía su primer mensaje de una sesión interactiva en la máquina.
El comando open integrado pasa la URL al controlador claude-cli:// registrado:
Si tiene éxito, se abre una nueva ventana de terminal con Claude Code ejecutándose y el mensaje rellenado previamente.

​
Registro y plataformas compatibles

Claude Code registra el controlador claude-cli:// con su sistema operativo en macOS, Linux y Windows cuando envía su primer mensaje de una sesión interactiva. Iniciar claude y salir sin enviar un mensaje no registra el controlador. No ejecuta un comando de instalación separado. El registro escribe solo en ubicaciones a nivel de usuario: El controlador inicia Claude Code en un emulador de terminal detectado. En macOS, Claude Code recuerda la terminal de su sesión interactiva más reciente y la reutiliza, compatible con iTerm2, Ghostty, kitty, Alacritty, WezTerm y Terminal.app. En Linux, respeta la variable de entorno $TERMINAL, luego x-terminal-emulator, luego una lista de emuladores comunes. En Windows, prefiere Windows Terminal, luego PowerShell, luego cmd.exe. Para evitar el registro por completo, establezca disableDeepLinkRegistration en "disable" en settings.json. Para aplicar esto en toda una organización para que los usuarios no puedan volver a habilitarlo, establézcalo en configuración administrada en su lugar.

​
Abrir una pestaña de VS Code en lugar de una terminal

La extensión de VS Code registra su propio controlador en vscode://anthropic.claude-code/open, que abre una pestaña del editor de Claude Code en lugar de una ventana de terminal. Consulte Iniciar una pestaña de VS Code desde otras herramientas para los parámetros de esa URL.

​
Solución de problemas

El controlador probablemente aún no está registrado. El registro ocurre cuando envía su primer mensaje de una sesión interactiva, no cuando la sesión comienza. Inicie una sesión claude interactiva en esa máquina, envíe cualquier mensaje, salga e intente el enlace nuevamente. Si está en Linux sin un entorno de escritorio, xdg-open puede no tener nada a lo que enviar.

​
xdg-open no se encuentra en Linux

El comando xdg-open es parte del paquete xdg-utils, que las imágenes de servidor mínimas, contenedores y distribuciones de WSL a menudo omiten. Instale xdg-utils con el gestor de paquetes de su distribución, por ejemplo sudo apt install xdg-utils, luego ejecute el comando nuevamente. Si el comando se ejecuta pero no se abre nada, xdg-open puede no tener un entorno de escritorio al que enviar; consulte Hacer clic en el enlace no hace nada.

​
El enlace se representa como texto sin formato en lugar de ser clickeable

Algunos representadores de Markdown solo permiten enlaces http y https y eliminan otros esquemas de URL. GitHub hace esto en READMEs, problemas, solicitudes de extracción y wikis: [label](claude-cli://...) se representa como solo label, sin enlace y la URL eliminada. En estas plataformas, coloque el enlace profundo en un bloque de código para que los lectores puedan ver la URL y pegarla en la barra de direcciones de su navegador.

​
La sesión se abre en mi directorio de inicio en lugar del repositorio

El parámetro repo solo se resuelve a clones que Claude Code ya ha visto. Ejecute claude dentro del clon una vez para que Claude Code registre su ruta, o cambie el enlace para usar cwd con una ruta absoluta. En macOS, inicie claude en su terminal preferida una vez y el siguiente enlace profundo la usará. En Linux, establezca la variable de entorno $TERMINAL en el nombre del comando de su emulador preferido. En Windows, el orden es fijo: instale Windows Terminal si desea que los enlaces se abran allí en lugar de en una ventana de PowerShell o cmd.exe.

​
Más información

Estas páginas cubren formas relacionadas de iniciar o extender sesiones de Claude Code:
  • Skills: almacene un mensaje de runbook largo como un /skill en el repositorio para que el parámetro q del enlace profundo solo tenga que nombrarlo
  • Modo no interactivo: ejecute Claude desde un script y capture la salida sin abrir una terminal