Diff: el panel diff de Claude Code con los cambios sin confirmar de tu sesión
Un panel /diff para Claude Code: cambios sin confirmar, archivo por archivo con sus hunks, siempre al día.
Permisos
- Lee archivosPuede leer archivos y listar directorios en tu equipo ($.fs.read / list / stat / exists).
- Ejecuta comandosPuede ejecutar programas de shell en tu equipo ($.process.run / spawn). Revisa el código fuente para ver exactamente cuáles.
- Intercepta llamadas a herramientasVe cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
- Lee tus promptsPuede ver lo que escribes y la transcripción de la conversación (prompt.* / session.append / session.messages).
- Modifica la interfazDibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
- Añade comandos/herramientasRegistra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
- Guarda datosConserva datos entre sesiones en el almacén privado del plugin ($.store.*).
- probado con
- v2.1.310
- última prueba
- requiere
- Claude Code ≥ 2.1.287
- superficies
- panel
- código fuente
- Anthropic (anthropics)
Instalar dentro de Claude Code:
git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diff¿Qué hace este mod?
Diff es un mod que Anthropic publica en el repositorio claude-code y que listamos aquí como mod de la comunidad. Es un panel diff de Claude Code: /diff abre los cambios sin confirmar de la sesión junto a la transcripción, con una fila por archivo modificado y los hunks de cada archivo debajo; otro /diff lo cierra. Cada cambio deja Diff panel shown o Diff panel hidden en la transcripción.
El panel se actualiza después de que Claude edita un archivo o ejecuta un comando de shell, y mientras está abierto vigila el HEAD del repositorio, de modo que un commit o checkout hecho en otro sitio también aparece. Puede comparar el árbol de trabajo con el HEAD del inicio de la sesión (por defecto), con el HEAD sin más, o con el merge-base de la rama por defecto, y un selector puede mostrar en su lugar las ediciones de un turno anterior. Los archivos que ya habían cambiado antes de la sesión, además de lockfiles, archivos generados y tests, se listan aparte y plegados.
Si el terminal es lo bastante ancho, la primera edición correcta de una sesión abre el panel por sí sola. Sin el diseño de pantalla completa, /diff abre en cambio un diálogo en línea: una lista de archivos con cinco filas alrededor de la seleccionada, Enter muestra solo los hunks de ese archivo y Escape vuelve atrás. El botón [ ask ] de un archivo lo arma, de modo que sus hunks viajan una vez con el siguiente prompt como contexto.
Demo
La grabación inicia Claude Code con el mod cargado en el pequeño proyecto de demostración, que tiene un cambio sin confirmar. Escribe /diff y el autocompletado muestra «Toggle the diff panel showing uncommitted changes». Tras Enter, sobre el prompt se abre un diálogo con borde titulado Uncommitted changes (git diff HEAD), con 1 file changed +2 debajo. Lista src/index.js con un botón [ ask ] y, debajo, el hunk con números de línea y las dos líneas añadidas resaltadas en verde. El pie dice ↑/↓ to scroll · Esc to back. El clip permanece unos segundos en el diálogo. Muestra la forma en línea porque el terminal de la demo no usa el diseño acoplado.
Instalación
Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el repositorio propio del autor. Tras el siguiente inicio de sesión, escribe /diff dentro de un repositorio git con un archivo modificado.
$ install diff
Requiere Claude Code ≥ 2.1.287
Se instala desde el marketplace del autor: anthropics/claude-code
1.Pruébalo sin instalarlo
git clone https://github.com/anthropics/claude-code claude --plugin-dir ./claude-code/mods/diffCarga el mod solo para una sesión. No se añade nada a tu configuración.
Cómo funciona
El módulo hooks/register.ts registra /diff en session.start, dibuja el componente Pane y escucha tool.call de Edit, Write, NotebookEdit, Bash y PowerShell para saber cuándo refrescar. Cada proceso hijo de git recibe el directorio git y el árbol de trabajo fijados del repositorio, y todo diff empieza con los mismos argumentos fijos, de hooks/git/argv/diff-leading-args.ts:
export const DIFF_LEADING_ARGS = [
'--no-optional-locks',
'-c',
'diff.relative=false',
'-c',
'core.quotePath=false',
'diff',
'--no-ext-diff',
'--no-textconv',
'--ignore-submodules=dirty',
'--submodule=short',
] as constGit se ejecuta solo en los momentos en que lo ejecutaría el panel integrado: no al iniciar la sesión, una vez para encontrar el repositorio cuando /diff o la primera edición lo necesitan, y después en las lecturas tras una edición o un comando de shell. La salida tiene un tope, y a partir de 500 archivos solo se muestran totales. Si en la sesión ya hay otro comando /diff registrado, el mod se aparta.
Personalízalo
El mod no tiene opciones en /config. La base de comparación se elige en el panel y ctrl+x b pasa a la siguiente; la elección se guarda por repositorio en el propio almacén del plugin. La lista se desplaza con ctrl+up/ctrl+down y opt+up/opt+down. Si no quieres que el panel se abra en la primera edición, ciérralo una vez y el mod lo recuerda. Definir CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING también detiene la apertura automática.
Permisos y seguridad
Leímos el manifiesto, hooks/hooks.json y hooks/register.ts, y buscamos en los cerca de 800 archivos restantes de hooks/ accesos a red, procesos, escritura de archivos y entorno. No leímos línea por línea el directorio de 3,4 MB, que son sobre todo pequeños módulos de TypeScript y tests. No hay package.json, script de instalación, binario ni código minificado o codificado.
- Cambia la interfaz: el panel o el diálogo, y los toasts.
- Añade un comando:
/diff. - Procesos:
$.process.runsolo para subcomandos de git de lectura (rev-parse,status,diff,ls-files,merge-base,show-ref,symbolic-ref), con la configuración regional fijada en C. - Red: ninguna encontrada. Archivos: lee archivos y marcas de tiempo del repositorio con
$.fs; solo escribe en$.store. - Entorno: lee
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING. - Telemetría: llama a
$.telemetry.logy$.telemetry.mark, que se descartan donde falta la telemetría integrada de Claude Code; no encontramos que el mod envíe nada por sí mismo. - Influencia sobre el modelo: el hook
prompt.submitañade los hunks de un archivo armado al contexto del prompt, solo después de que pulses el botón ask de ese archivo. - Licencia:
LICENSE.mddice «all rights reserved», sin ID SPDX; por eso esta página enlaza y no refleja el código.
claude plugin validate no informó de errores ni advertencias, pero dejó avisos de que el README no tiene línea de instalación y falta un icono, y notas de que siete hooks no tienen .catch. Las pruebas del autor pasaron: 234 correctas, 0 fallidas en 30 archivos, con Claude Code 2.1.310.
- Lee archivos
- Puede leer archivos y listar directorios en tu equipo ($.fs.read / list / stat / exists).
- Ejecuta comandos
- Puede ejecutar programas de shell en tu equipo ($.process.run / spawn). Revisa el código fuente para ver exactamente cuáles.
- Intercepta llamadas a herramientas
- Ve cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
- Lee tus prompts
- Puede ver lo que escribes y la transcripción de la conversación (prompt.* / session.append / session.messages).
- Modifica la interfaz
- Dibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
- Añade comandos/herramientas
- Registra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
- Guarda datos
- Conserva datos entre sesiones en el almacén privado del plugin ($.store.*).
Compatibilidad y solución de problemas
Comprobado con Claude Code 2.1.310 en macOS (validate, pruebas y grabación). Si /diff no muestra nada:
- Estás dentro de un repositorio git; fuera de uno,
/difflo dice y no hace nada más. - Hay un archivo realmente modificado; si no, ves
No changes this session. - Hay otro
/diffregistrado: entonces el mod queda inactivo. - Para la apertura automática, el terminal mide al menos 144 columnas con el diseño de pantalla completa.
- Por debajo de 110 columnas con ese diseño aparece una línea que pide un terminal más ancho.
Preguntas frecuentes
- ¿Diff envía mi código a algún sitio?
- No encontramos código de red. Ejecuta en tu máquina solo comandos de git de lectura (rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref) y dibuja el resultado. Al modelo solo llegan los hunks de un archivo, y únicamente después de que pulses su botón ask.
- ¿Modifica mi repositorio?
- No. Todos los comandos de git que encontramos son de lectura y se ejecutan con --no-optional-locks, --no-ext-diff y --no-textconv. El plugin solo escribe en su propio almacén, donde recuerda si el panel estaba abierto y qué base de comparación elegiste.
- ¿Por qué /diff a veces se abre solo?
- Tras la primera edición correcta de una sesión, si el checkpointing de archivos está activo y el terminal es lo bastante ancho (144 columnas, o 110 si antes lo dejaste abierto). Si lo cerraste, te deja en paz. En terminales más estrechos y en el diseño en línea solo se abre con /diff.
- ¿Qué hace el botón ask?
- Arma un archivo. Con tu siguiente prompt, el plugin añade los hunks de ese archivo como contexto una vez y lo desarma. Si los hunks no caben en el espacio de contexto, se descartan y la línea de estado lo indica.
- ¿Puedo redistribuirlo o hacer un fork?
- Por lo que encontramos, no. El LICENSE.md del repositorio dice «All rights reserved» y remite a los Commercial Terms of Service de Anthropic, así que enlazamos el repositorio y no reflejamos el código.
# Mods relacionados
DestacadoRama git sobre el prompt
Tu rama git, los archivos cambiados y el estado ahead/behind en una franja de una línea sobre el prompt de Claude Code.
- sobre el prompt
- Ejecuta comandos
- Intercepta llamadas a herramientas
- Modifica la interfaz
probado con v2.1.310
cc-pr-tracker
Una línea por PR de GitHub sobre el prompt de Claude Code: merge, revisión, checks requeridos y avisos al cambiar.
- sobre el prompt
- aviso
- Lee archivos
- Ejecuta comandos
- Intercepta llamadas a herramientas
- Lee tus prompts
- Modifica la interfaz
- Añade comandos/herramientas
- Guarda datos
probado con v2.1.296
DestacadoBlast Radius
Retiene rm -r, force push y migraciones de base de datos en Claude Code y muestra qué cambiarían antes de ejecutarse.
- panel
- sobre el prompt
- Ejecuta comandos
- Intercepta llamadas a herramientas
- Modifica la interfaz
probado con v2.1.291