Herramientas de Claude Code: cuándo usar Grep, Glob, Read, Write y Edit

Hola otra vez, y bienvenidos y bienvenidas a la cápsula cinco del Módulo dos. Recuerda que esta es mi voz, pero el audio fue generado con inteligencia artificial, bajo la supervisión del equipo de EvoAcademy.

Hoy vemos el task statement dos punto cinco: elegir y usar bien las herramientas incluidas de Claude Code, la herramienta de Anthropic que trabaja con código. Son Read, Write, Edit, Grep, Glob y Bash, que ejecuta comandos de la terminal.

Grep y Glob se confunden. Si sabes un texto, entonces usas Grep: busca contenido dentro de los archivos, como el nombre de una función, un error o un import. Una función es un bloque de código con nombre, y un import es la línea con que un archivo trae código de otro. Por su parte, si sabes el nombre del archivo, entonces usas Glob: busca rutas por nombre o extensión, por ejemplo las pruebas automáticas, que terminan en punto test punto tsx.

Read y Write trabajan con el archivo completo: Read lo lee entero, y Write lo escribe entero. Edit hace un cambio puntual: busca un texto exacto y lo reemplaza. Ese texto es un ancla y debe aparecer una sola vez. Si el ancla aparece varias veces, entonces Edit falla, y el respaldo que propone la guía es leer el archivo con Read y escribirlo corregido con Write.

Para entender un código nuevo, la guía pide ir de a poco. Si no lo conoces, entonces no leas todos los archivos al inicio, porque se llena el contexto, la memoria de trabajo del agente, con material inútil. Por su parte, empiezas con Grep para hallar los puntos de entrada, donde parte lo que interesa, y luego usas Read para seguir los imports y trazar el flujo.

Un módulo wrapper, o envoltorio, re-exporta funciones de otro archivo, a veces con otro nombre, un alias. Si buscas solo el nombre original, entonces dejas fuera a quienes usan el alias. Por eso primero se listan los nombres que exporta el wrapper, y después se busca cada uno con Grep.

Una pregunta. Un banco quiere que su agente encuentre los archivos de pruebas y los lugares donde aparece el error saldo insuficiente. ¿Qué herramienta usa para cada uno?

Glob para los archivos de pruebas, porque se reconocen por su nombre, y Grep para el error, porque está dentro del texto.

Dos preguntas de práctica. Pregunta uno. Una agroexportadora de fruta guarda la configuración de sus cámaras de frío en un archivo. El agente debe subir a cinco grados el límite de la cámara dos, pero la línea límite temperatura igual a cuatro aparece idéntica tres veces, una por cámara, y Edit falla porque el texto no es único. ¿Qué conviene hacer? Opción A: usar Glob para encontrar la línea dentro del archivo y luego cambiarla. Opción B: usar Write con solo la línea nueva, sin leer antes el archivo. Opción C: repetir el mismo Edit, con exactamente el mismo texto, hasta que funcione. Opción D: leer el archivo completo con Read y escribirlo corregido con Write.

La correcta es D. Con Read el agente ve las tres líneas, y con Write guarda el archivo cambiando solo la cámara dos. La A no sirve, porque Glob busca nombres de archivos y no texto dentro de ellos. La B reemplaza todo el archivo por una sola línea y borra el resto de la configuración. La C repite un intento que va a fallar por la misma razón.

Pregunta dos, de respuesta múltiple. Elige dos. Una tienda de moda tiene la función cobrar tarjeta. Un archivo wrapper la re-exporta con dos nombres: cobrar tarjeta y, como alias, pagar con tarjeta. El agente debe encontrar todos los lugares que la llaman. Opción A: modificar el wrapper para que exporte un solo nombre y ver qué deja de funcionar. Opción B: buscar con Grep solo el nombre original, porque los alias son la misma función. Opción C: buscar con Grep, en todo el código, cada nombre con el que se exporta la función. Opción D: leer con Read todos los archivos del proyecto antes de buscar. Opción E: leer el archivo wrapper para ver todos los nombres con los que exporta la función. ¿Cuáles dos?

Las correctas son C y E. Primero se listan los nombres exportados, y luego se busca cada uno, así no se pierde nadie que use un alias. La A cambia el código para descubrir lo que una búsqueda muestra sin tocarlo. La B encuentra solo a quienes usan el nombre original. La D llena el contexto con archivos que no hacen falta.

Si te sirvió, sigue el podcast, dale cinco estrellas y activa las notificaciones. En la próxima cápsula cerramos el Módulo dos con los seis patrones de diseño de herramientas. Nos escuchamos en la próxima cápsula de EvoAcademy.