Crear un agente que programa en R con solo tres herramientas

A quién le sirve. Personas que programan en R y quieren entender por dentro cómo funciona un agente que lee, edita y prueba código; si no programas, te conviene más usar uno ya hecho, como Claude Code.

Qué hicieron

El autor usa el paquete ellmer de R para conectar Claude con tres funciones sencillas: leer un archivo, escribir un archivo y ejecutar un comando en la terminal. Un texto corto de instrucciones le dice al modelo que lea antes de editar y que pase las pruebas. Después añade herramientas para listar y buscar archivos, una comprobación que mantiene el acceso dentro de la carpeta del proyecto y una herramienta para editar solo un trozo concreto.

Cómo salió

El agente con tres herramientas encuentra una función, lee las pruebas existentes, escribe una prueba nueva y ejecuta todo el conjunto. El propio autor admite que queda muy por debajo de Claude Code y que la herramienta de terminal sigue siendo arriesgada.

Conviene saber

Aplica la comprobación de carpeta a todas las herramientas de archivos, no solo a la búsqueda. La terminal sin límites puede saltársela, así que no la tomes como protección completa.

Qué necesitas

• R instalado en tu ordenador y saber escribir funciones sencillas en R
• El paquete ellmer, la librería de R que conecta tus programas con los modelos de IA
• Una clave de API de Claude (la contraseña que deja a un programa usar el modelo; se paga según el uso)
• Una carpeta de pruebas con un proyecto pequeño de R que tenga alguna función y sus pruebas
• Una copia de seguridad de todo lo que no quieras perder

Cómo hacerlo tú, paso a paso

1. Crea una carpeta de pruebas con un proyecto pequeño de R: unas pocas funciones y sus pruebas. Trabaja siempre ahí y nunca en tu proyecto de verdad.
2. Instala ellmer y guarda tu clave de API como variable de entorno, que es un ajuste de tu ordenador que los programas pueden leer, sin escribirla dentro del código.
3. Escribe tres funciones: leer un archivo, escribir un archivo y ejecutar un comando en la terminal. Cada una debe devolver al modelo un texto que cuente lo que ha pasado.
4. Registra las tres funciones como herramientas de un chat con Claude y añade unas instrucciones cortas: leer el archivo antes de editarlo y pasar las pruebas al terminar.
5. Pídele una tarea pequeña, por ejemplo encontrar una función, leer sus pruebas, escribir una nueva y ejecutarlas todas. Fíjate en qué herramientas usa y en qué orden.
6. Añade herramientas para listar y buscar archivos, y otra para editar solo un trozo concreto de un archivo en vez de reescribirlo entero.
7. Pon una comprobación que impida tocar nada fuera de la carpeta del proyecto y aplícala a todas las herramientas de archivos. Añade también una confirmación antes de cada comando de terminal.

Ayúdame a construir un agente de programación pequeño en [lenguaje, por ejemplo R] con tres herramientas: leer un archivo, escribir un archivo y ejecutar un comando. Conéctalas a [proveedor de IA] en un bucle sencillo y pruébalo con una tarea pequeña en [carpeta de pruebas]. Después propón y añade herramientas que lo hagan más seguro y eficiente, como pedir confirmación antes de ejecutar comandos. Habrás terminado cuando complete la tarea de prueba de principio a fin.

Consejos

• La terminal es la parte delicada: un comando mal pensado puede borrar archivos. Lee cada comando antes de aprobarlo.
• Empieza con una tarea pequeña y de poco riesgo. Cuando funcione, súbele la dificultad poco a poco.
• Mira de vez en cuando el gasto de tu cuenta de API, porque cada vuelta del agente consume.

Preguntas frecuentes

Fuentes

• tidydesign en Substack ↗
• La conversación en Bluesky, 19 de junio de 2026 ↗

En el directorio desde el 3 de octubre de 2026.