Claude Code: meter ficheros (@) y comandos (!) en la conversación

Dos atajos que se usan escribiendo dentro del cuadro de escribir de Claude Code.

• @ mete ficheros en el mensaje. Escribes la arroba y el nombre y Claude lee ese fichero como parte de tu petición: «explícame la lógica de @src/utils/auth.js». Si le pasas una carpeta, te enseña su lista de contenido.
• ! ejecuta un comando en tu terminal. Si empiezas el mensaje con !, lo que venga detrás se ejecuta de verdad y el resultado entra en la conversación: «!npm test», «!git status».

Para darle el contexto exacto sin copiar y pegar.

• En vez de describir un fichero «de memoria» (y arriesgarte a que rellene los huecos inventando), le enseñas el de verdad con @.
• En vez de contarle «la prueba falla», le pasas la salida real de la prueba con ! y trabaja sobre el error auténtico.

Es la diferencia entre contarle lo que crees que pasa y enseñarle lo que pasa.

• Abre Claude Code en la carpeta de tu proyecto.

• Mete un fichero con @. Escribe tu mensaje y, donde quieras citarlo, pon la arroba y el nombre:

explícame la lógica de @src/utils/auth.js

Puedes citar varios ficheros en el mismo mensaje. Si escribes @ y una carpeta, te muestra lo que hay dentro para que elijas.

• Ejecuta un comando con !. Empieza el mensaje con la exclamación y el comando tal cual lo escribirías en la terminal:

!npm test

!git status

• Mira el resultado y aprovecha la respuesta. La salida del comando se queda en la conversación y Claude la comenta como si se la hubieras pegado.

Claude Code es de pago: no entra en el plan gratuito de Claude. Hace falta el plan Pro (20 $ al mes —unos 22 €—) o una clave de API.

Lo comprobado el 5 de octubre de 2026:

• Citar un fichero con @ también carga las instrucciones de sus carpetas. Los ficheros CLAUDE.md (las normas del proyecto) se leen con él, así que consume algo más de contexto. Cita los que de verdad hagan falta.
• El comando del ! se ejecuta con tus permisos, tal cual. Es tu terminal: si el comando borra algo, lo borra. No lo uses a la ligera con comandos que no entiendes.

1. Escribo @ y no me sugiere ningún fichero. El nombre tiene que existir desde la carpeta donde abriste Claude Code. Si estás en otra, escribe la ruta completa, o vuelve a abrir Claude Code desde la carpeta correcta.

2. Escribo ! y no pasa nada. Comprueba que la exclamación está al principio (sin nada delante) y que el comando existe en tu terminal. Un nombre mal escrito da «orden no encontrada»:

!ls

3. He lanzado con ! un comando que no quería. Es tu terminal: con ! se ejecuta de verdad, no es una simulación. Revisa el comando antes de pulsar Intro y, para lo que dé miedo, escríbelo tú directamente en la terminal.