danieldeusing

cat ~/artículos/capi-claude-code-mod.mdx

Capi: un carpincho que me enseña portugués mientras Claude trabaja

Paso buena parte de mi día de trabajo esperando a Claude Code. Así que escribí un mod que llena esa espera con una tarjeta de quiz: un dato verdadero y una expresión en el idioma que estoy aprendiendo. Es open source y también funciona con otros idiomas.

~3 min de lectura #ai #claude-code #languages

Vivo en Brasil desde hace unos cuatro años. Mi portugués alcanza para el día a día. La gramática es otra historia. Tiene huecos, y sigo cayendo en los mismos.

También paso buena parte de mi día de trabajo esperando a Claude. Uso Claude Code desde la beta, a principios de 2025, y por el camino le mandé al equipo bastante feedback e issues en GitHub. Me gusta mucho hacia dónde va. Pero mientras trabaja, yo básicamente me quedo mirando cómo piensa.

Entonces Anthropic agregó mods a Claude Code: pequeños trozos de código que cambian cómo funciona o cómo se ve. Supe enseguida qué iba a hacer el mío.

Les presento a Capi

Capi es un carpincho, un capibara. Vive en la franja encima del prompt y me muestra una tarjeta de quiz. Cada tarjeta me enseña dos cosas a la vez: un dato verdadero sobre el mundo real y una expresión en el idioma que estoy aprendiendo.

Aquí va una del video:

“Saca só: a parte suculenta do caju é o fruto de verdade, e a castanha é só a semente.”

(“Fíjate: la parte jugosa del cajú es el fruto de verdad, y la nuez es solo la semilla.”)

¿Verdadero o falso? Falso. La parte jugosa, la manzana del cajú, es un pseudofruto. El fruto de verdad es la nuez de la india que cuelga debajo (fuente: Embrapa). Y de paso aprendí “saca só”, que es algo como “fíjate” o “mira esto” antes de contar algo sorprendente.

Capi en 38 segundos: la franja encima del prompt, la tarjeta del cajú y lo que hace cada tecla.

Teclas, porque igual tengo las manos en el teclado

  • 1–4 responder
  • 6 📐 notas de gramática sobre esa misma frase
  • 7 🔤 tablas de conjugación de cada verbo de la frase
  • 0 la tarjeta en mi propio idioma
  • 8 escucharla
  • 9 marcar un dato falso. Esa tarjeta no vuelve a usarse, y el dato se revisa de nuevo.

Un clic en – pliega la franja, × la oculta durante la sesión, y /capi muestra mi progreso.

Las notas de gramática son sobre la frase que está en pantalla, no un capítulo de un libro de texto. Justo la ayuda que necesitan mis huecos.

Una tarjeta de Capi con la frase del cajú y, debajo, cinco notas de gramática en alemán: saca só como imperativo coloquial, do caju como de más o, el adjetivo después del sustantivo, é de ser y no de estar, y só en el sentido de solo
Tecla 6: notas de gramática sobre la frase que estoy leyendo, explicadas en mi idioma.
La tarjeta del cajú respondida: correcto, la parte jugosa es un pseudofruto, fuente Embrapa. Debajo, una tabla de conjugación de sacar en presente, pretérito perfeito y futuro, con ser como segundo verbo, y una nota sobre saca só
Tecla 7: una tabla de conjugación para cada verbo de la frase. Aquí sacar, con ser justo al lado.

Capi no se olvida

Capi usa cajas de Leitner. Una tarjeta que acierto vuelve después de 1 día, luego de 3, 7, 30 y 90. Una que fallo vuelve a los 20 minutos, en otro formato. Hay un tope diario de expresiones nuevas (25 por defecto), para que un día largo de trabajo no me entierre. Y mi historial se sincroniza entre mis Macs por iCloud.

Una tarjeta de gramática respondida mal: después de embora siempre va el subjuntivo, así que la respuesta era fosse. El dato: Brasil fue el último país de América en abolir la esclavitud, el 13 de mayo de 1888, fuente Britannica
Fallé: después de “embora” va el subjuntivo. Esta tarjeta vuelve en 20 minutos.

Quién escribe las tarjetas

Claude. Cada tarjeta la escribe Claude (claude-opus-5-5) con mi propio plan. Solo responder trae tarjetas nuevas, así que dejar la franja en pantalla todo el día no cuesta nada.

No solo portugués

Un archivo .env define el idioma que quiero aprender, mi propio idioma, mi nivel, los temas, qué personas y tiempos muestran las tablas de conjugación, si la franja aparece siempre o solo mientras Claude trabaja (CAPI_SHOW), y el tope diario (CAPI_NEW_PER_DAY). Así que funciona igual para alguien en São Paulo que aprende alemán.

Pruébalo

Capi es open source, con licencia MIT: github.com/danieldeusing/capi-cc-mod. Necesitas Claude Code 2.1.287 o más nuevo, con los mods activados.

Se instala desde seedr, mi registro:

npx @danieldeusing/seedr add capi --type plugin --agents claude

O directo desde GitHub:

claude plugin marketplace add danieldeusing/capi-cc-mod
claude plugin install capi@capi

Claude sigue sin apuro. Solo que ahora me llevo un carpincho y una clase de gramática.