Artículos
Presentación de Deckhand: convierte Claude Code en tu panel de control para IA de terceros
Deckhand es un plugin de código abierto para Claude Code que añade una barra de herramientas arriba del campo de entrada: delega tareas en modo de solo lectura a Codex, Cursor agent y agy para obtener una segunda opinión, despacha subagentes en paralelo con Sub5 y proporciona métricas de consumo y cambio de modelos. Este artículo detalla la instalación, el uso de cada función, el flujo de datos y las limitaciones conocidas.
· 7 min de lectura
Deckhand es un plugin para Claude Code que añade una barra de herramientas arriba del campo de entrada. Claude se mantiene como el agente principal; la barra de herramientas permite delegar tareas a Codex, Cursor agent o agy en modo de solo lectura. Una vez que se devuelve la respuesta, Claude la revisa antes de decidir si adoptarla.
La barra de herramientas también ofrece métricas de uso, cambio de modelos y Sub5 para dividir tareas entre múltiples subagentes en paralelo. Funciona tanto en la terminal como en la app de escritorio. La versión actual es 1.1.1, con licencia MIT.
Declaración: Deckhand fue desarrollado por el autor de este sitio.
Resumen de funciones#
| Sección |
Función |
cL cS cA cR gF |
Delega tareas en modo de solo lectura a otro CLI de IA para que Claude revise la respuesta |
Sub5 |
Divide la tarea actual en hasta 5 elementos y los asigna a subagentes en paralelo dentro de sus propios git worktree |
O F S H |
Cambia a Opus, Fable, Sonnet o Haiku |
| Métricas de uso |
Ventana de 5 horas, ventana semanal por modelo, ventana semanal total combinada 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 en Claude Code:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Si la barra de herramientas no aparece, inicia una nueva sesión.
Requisitos:
- macOS o Linux. El soporte para Windows sigue pendiente de pruebas.
- Claude Code compatible con módulos hook de plugins; probado en 2.1.288.
- Python 3.9 o superior.
- Opcional: la función de monitoreo requiere
gh; los botones de delegación requieren los CLI de codex, Cursor agent o agy. Si un CLI no está instalado, su botón correspondiente se oculta.
Delegación: una segunda opinión de solo lectura#
Al presionar un botón de delegación, Deckhand pasa la tarea al CLI correspondiente. Este solo puede leer y no modificar nada; una vez generada la respuesta, se devuelve a Claude para su revisión.
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 |
La etiqueta, el CLI, el ID del modelo, el effort y el nombre se pueden modificar en la configuración.
El modo de solo lectura se aplica 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 revisa la descripción de la tarea; si contiene tokens, llaves o contraseñas, rechaza el envío. Las descripciones de las tareas y las respuestas se almacenan en una carpeta temporal privada y se eliminan después de 3 días.
Mientras se ejecuta una delegación, aparece una fila adicional arriba de la barra de uso que muestra la etiqueta, el CLI, el modelo y el tiempo transcurrido. /delegates lista las delegaciones de los últimos 3 días; cada respuesta se puede abrir, copiar o insertar de nuevo en el campo de entrada, y también muestra el conteo de tokens reportado por el CLI.
La delegación envía la descripción de la tarea a los proveedores de servicios detrás de cada CLI.
Sub5: subagentes en paralelo#
Sub5 divide la tarea actual en un máximo de 5 elementos independientes entre sí; cada elemento lo procesa un subagente dentro de su propio git worktree. Al terminar todos, el agente principal revisa los resultados, integra los cambios y limpia los worktrees y ramas.
Las operaciones de git las ejecuta el script bin/sub5.py, sin usar force ni hacer push. El modelo de los subagentes, el effort y la cantidad máxima de elementos se pueden ajustar en la configuración.
Si se interrumpe un run (se detiene el turno, falla un worker o se cierra la sesión), pueden quedar worktrees y ramas residuales. /sub5-clean lista estos elementos huérfanos y, tras confirmar, solo elimina los worktrees que no tengan cambios sin confirmar y las ramas que ya estén fusionadas; conserva los que se hayan usado en la última hora.
Sub5 no es adecuado cuando existen dependencias entre los elementos, ya que procesarlos en paralelo solo aumentará los conflictos de integración.
Cambio de modelo#
O, F, S y H corresponden respectivamente a Opus, Fable, Sonnet y Haiku.
- Terminal: cambia directamente el modelo de la sesión actual, conservando el nivel de effort configurado.
- App de escritorio: Claude Code no permite que los plugins envíen prompts que comiencen con
/, y la app tampoco deja que la sesión cambie su propio modelo. Por ello, el botón inserta el ID completo del modelo en el campo de entrada, como /model claude-opus-5-5. El cambio se aplica al presionar Enter, y luego Deckhand restablece el effort a su nivel original.
Métricas de uso#
5h: ventana de 5 horas.fb, sn, op: ventana semanal de cada modelo disponible en la cuenta.7d: ventana semanal total sumando todos los modelos.ctx: porcentaje de uso de la ventana de contexto.
Los números coinciden con la tarjeta de uso de la app de Claude, redondeados hacia abajo. Si alguna ventana supera el umbral de advertencia, Deckhand envía una notificación única; los umbrales se pueden ajustar en la configuración.
Recap#
Recap explica en lenguaje claro todo el contexto actual en un panel lateral, sin añadir contenido a la conversación.
Herramientas de monitoreo y protección#
| Herramienta |
Propósito |
/watch-deploy, watch_deploy |
Monitorea en segundo plano un PR, una ejecución de CI o una URL, y se detiene automáticamente tras N resultados idénticos consecutivos |
| Protección contra sondeo |
Bloquea bucles de sondeo con sleep y esperas bloqueantes como gh run watch |
| Protección de autoría |
Elimina el trailer Co-Authored-By y los pies de página de Claude Code en comandos de commit y PR |
/handoff, /handoff-in, /codex |
Transfiere el trabajo entre Claude y Codex |
translate |
Delega la traducción de localización al destino configurado; desactivado por defecto |
search |
Delega la búsqueda web con fuentes al destino configurado para que Claude la verifique; desactivado por defecto |
Configuración#
Haz clic en el ⚙ en el extremo derecho de la barra de herramientas o ejecuta /deckhand para abrir el panel de configuración. El panel está dividido en 5 pestañas: General, Delegados, Traducción y búsqueda, Sub5 y Avanzado. La configuración se almacena localmente y se puede exportar como JSON para importarla en otras computadoras.
La interfaz soporta English, 繁體中文, 简体中文, 日本語 y 한국어, y por defecto sigue la configuración de language de Claude Code.
Flujo de datos#
Los únicos datos que salen de tu computadora corresponden a estas tres categorías:
- Descripciones de tareas delegadas: se envían al proveedor de servicios del CLI seleccionado al presionar el botón de delegación.
- Lecturas de uso: llamadas al endpoint de uso de Anthropic a través de Claude Code, utilizando las credenciales de la sesión actual.
- Herramientas invocadas explícitamente:
translate y search envían datos a los destinos de delegación seleccionados; las funciones de monitoreo consultan GitHub mediante gh o leen las URLs indicadas.
Limitaciones conocidas#
- El soporte para Windows sigue pendiente de pruebas.
- Los botones de modelo en la app de escritorio no cambian con un solo clic; requieren presionar Enter en el campo de entrada.
- Las delegaciones no tienen botón de detención: Deckhand solo monitorea la llamada de Bash que ejecuta la delegación y no puede cancelarla.
- 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 es un producto de Anthropic.