Artículos
Presentación de Deckhand: convierte Claude Code en tu panel de control de IA de terceros
Deckhand es un plugin de código abierto para Claude Code que añade una barra de herramientas sobre el prompt: delega tareas en modo solo lectura a Codex, Cursor agent y agy para obtener una segunda opinión, lanza subagentes en paralelo con Sub5 y ofrece métricas de uso y cambio de modelo. En este artículo se detallan la instalación, el uso de cada función, los flujos de datos y sus limitaciones conocidas.
· 7 min de lectura
Deckhand es un plugin para Claude Code que añade una barra de herramientas justo encima del cuadro de entrada de texto. Claude sigue siendo el agente principal; la barra de herramientas permite derivar tareas a Codex, Cursor agent o agy en modo de solo lectura. Cuando devuelven una respuesta, Claude la revisa antes de decidir si la incorpora o no.
La barra de herramientas también incluye métricas de uso, cambio de modelo y Sub5, que divide las tareas entre múltiples subagentes en paralelo. Es compatible tanto con el terminal como con la app de escritorio. La versión actual es la 1.1.1, bajo licencia MIT.
Declaración de transparencia: Deckhand ha sido desarrollado por el autor de este sitio web.
Resumen de características#
| Bloque |
Función |
cL cS cA cR gF |
Delega tareas en modo solo lectura a otra CLI de IA y Claude revisa la respuesta |
Sub5 |
Divide la tarea actual en hasta 5 subtareas y las ejecuta en paralelo con subagentes en sus propios git worktree |
O F S H |
Cambia a Opus, Fable, Sonnet o Haiku |
| Métricas de uso |
Ventana de 5 horas, límites semanales por modelo, límite semanal combinado de todos los modelos y ventana de contexto |
Recap |
Explica el contexto actual en un panel lateral |
⚙ |
Abre el panel de configuración |
Instalación y requisitos#
Ejecuta lo siguiente dentro de Claude Code:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Si la barra de herramientas no aparece de inmediato, inicia una nueva sesión.
Requisitos:
- macOS o Linux. La compatibilidad con Windows aún está pendiente de pruebas.
- Claude Code con soporte para módulos de hooks de plugins; probado en la versión 2.1.288.
- Python 3.9 o superior.
- Opcional: las funciones de monitorización requieren
gh; los botones de delegación necesitan las CLI de codex, Cursor agent o agy. Si una CLI no está instalada, su botón correspondiente permanecerá oculto.
Delegación: segundas opiniones en solo lectura#
Al pulsar un botón de delegación, Deckhand transfiere la tarea a la CLI correspondiente. Dicha herramienta solo tiene permisos de lectura y no puede modificar archivos; redacta una respuesta y se la entrega a Claude para que la evalúe.
Destinos de delegación predeterminados:
| Botón |
CLI |
Modelo |
Effort |
cL |
Codex |
GPT-6 Luna |
max |
cS |
Codex |
GPT-6.1 Sol |
medium |
cA |
Codex |
GPT-6 Astra |
medium |
cR |
Cursor agent |
Grok 4.7 |
high |
gF |
agy |
Gemini 3.8 Flash |
high |
Las etiquetas, CLI, IDs de modelo, niveles de effort y nombres se pueden personalizar en los ajustes.
El modo de solo lectura se impone mediante los flags o modos nativos de cada CLI:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: modo headless, donde las llamadas a herramientas se rechazan automáticamente
Antes de enviar la solicitud, Deckhand analiza la descripción de la tarea; si detecta tokens, claves de API o contraseñas, bloquea el envío. Las descripciones y las respuestas se almacenan en un directorio temporal privado y se eliminan transcurridos 3 días.
Mientras una delegación está en curso, aparece una fila adicional sobre la barra de uso que muestra la etiqueta, la CLI, el modelo y el tiempo transcurrido. El comando /delegates lista las delegaciones de los últimos 3 días; cada respuesta se puede abrir, copiar o insertar en el prompt, mostrando además el recuento de tokens reportado por la CLI.
La delegación envía la descripción de la tarea al proveedor de servicios asociado a esa CLI.
Sub5: subagentes en paralelo#
Sub5 desglosa la tarea en curso en un máximo de 5 elementos independientes entre sí. Cada uno es procesado por un subagente dentro de su propio git worktree. Una vez completados todos, el agente principal revisa el resultado, integra los cambios y limpia tanto los worktrees como las ramas.
Las operaciones de git se gestionan a través del script bin/sub5.py, sin recurrir a force ni realizar push. El modelo, el nivel de effort y el límite máximo de tareas para los subagentes se pueden configurar en los ajustes.
Si una ejecución se interrumpe (se cancela el turno, falla un worker o se cierra la sesión), pueden quedar worktrees y ramas huérfanas. El comando /sub5-clean localiza estos restos y, previa confirmación, elimina únicamente los worktrees sin cambios pendientes de commit y las ramas ya fusionadas, conservando los utilizados durante la última hora.
Si las tareas dependen unas de otras, no es aconsejable recurrir a Sub5: el procesamiento en paralelo solo generará más conflictos durante la integración.
Cambio de modelo#
O, F, S y H corresponden respectivamente a Opus, Fable, Sonnet y Haiku.
- Terminal: cambia de inmediato el modelo de la sesión activa, manteniendo el nivel de effort configurado.
- App de escritorio: Claude Code no admite que los plugins envíen comandos que comiencen por
/, ni la app permite que una sesión cambie su propio modelo directamente. Por ello, el botón autocompleta el cuadro de entrada con el ID completo del modelo, como /model claude-opus-5-5. El cambio se aplica al pulsar Enter y, a continuación, Deckhand restablece el effort a su nivel original.
Métricas de uso#
5h: intervalo de 5 horas.fb, sn, op: intervalos semanales de cada modelo disponible en la cuenta.7d: intervalo semanal agregado de todos los modelos combinados.ctx: porcentaje de uso de la ventana de contexto.
Los valores coinciden con los paneles de uso de la app de Claude y se redondean hacia abajo (truncamiento). Si algún intervalo rebasa el umbral de aviso, Deckhand emitirá una notificación única. Los umbrales se pueden ajustar en la configuración.
Recap#
Recap muestra en el panel lateral una explicación en lenguaje claro de todo el contexto actual, sin añadir mensajes a la conversación.
Herramientas de monitorización y protección#
| Herramienta |
Finalidad |
/watch-deploy, watch_deploy |
Monitoriza en segundo plano PRs, ejecuciones de CI o URLs, deteniéndose automáticamente tras N resultados idénticos consecutivos |
| Protección contra sondeos |
Intercepta bucles de sondeo basados en sleep y esperas bloqueantes del tipo gh run watch |
| Protección de autoría |
Suprime los trailers Co-Authored-By y los pies de página de Claude Code en comandos de commit y PR |
/handoff, /handoff-in, /codex |
Transfiere el flujo de trabajo entre Claude y Codex |
translate |
Deriva tareas de localización al destino de delegación configurado (desactivado por defecto) |
search |
Deriva búsquedas web con fuentes al destino de delegación configurado para que Claude verifique los datos (desactivado por defecto) |
Configuración#
Haz clic en el icono ⚙ del extremo derecho de la barra de herramientas o ejecuta /deckhand para abrir el panel de configuración. Se estructura en 5 pestañas: General, Delegación, Traducción y Búsqueda, Sub5 y Avanzado. La configuración se almacena localmente y se puede exportar en formato JSON para importarla en otros equipos.
La interfaz está disponible en English, 繁體中文, 简体中文, 日本語 y 한국어, adoptando por defecto el valor de language establecido en Claude Code.
Flujo de datos#
Solo tres tipos de información salen del equipo local:
- Descripciones de tareas delegadas: se transmiten al proveedor de servicios de la CLI seleccionada al pulsar el botón correspondiente.
- Lecturas de consumo: se solicitan al endpoint de uso de Anthropic a través de Claude Code, empleando las credenciales de la sesión activa.
- Herramientas invocadas explícitamente:
translate y search se envían al destino de delegación asignado; las funciones de monitorización consultan GitHub mediante gh o acceden a las URLs indicadas.
Limitaciones conocidas#
- Compatibilidad con Windows pendiente de validación.
- Los botones de modelo en la app de escritorio no conmutan en un solo clic; requieren pulsar Enter en el cuadro de texto.
- Las delegaciones no disponen de botón de cancelación: Deckhand se limita a monitorizar la llamada a Bash que ejecuta la tarea y no puede abortarla.
- Las descripciones de las tareas delegadas se envían a proveedores de servicios externos.
El código fuente y la documentación completa están disponibles en GitHub. Deckhand es un plugin desarrollado de forma independiente y no constituye un producto oficial de Anthropic.