Claude Code para torpes: Mi experiencia

Después de meses entre cajas, JB por fin ha podido volver a instalarse frente a su gran pantalla y ponerse a programar. Estaba tan metido en Claude Code que le pedí que hiciera una demo (crear y publicar un sitio web en menos de 3 minutos) y yo también me puse.

No soy desarrolladora, pero sé programar un poco. Sé lo que es un algoritmo, he escrito bastantes scripts automáticos y uso API (= «puertas de entrada» que permiten que un programa hable con otro programa) como las de Google o Bing.

Mi proyecto principal: traducir libros antiguos

Desde hace años, traduzco voluntariamente libros antiguos. Para eso, usaba la API de Claude (= pagaba a Claude por consumo para que tradujera). Cuesta caro, así que mis scripts no eran muy exigentes y no avanzaba muy rápido. Aun así, llevo 1.800 páginas traducidas, que revisaba y corregía todas yo misma. Cuando entendí lo que realmente podía hacer Claude Code, me puse a trabajar de nuevo.

Claude Code vs ChatGPT: ¿cuál es la diferencia?

Cuando usas ChatGPT o Claude.ai en tu navegador, estás en una interfaz de chat : haces una pregunta, la IA responde, y ya está. No ve nada de lo que hay en tu ordenador. No puede abrir tus archivos, ejecutar un programa, modificar un documento. Responde en un cuadro de texto, y luego tienes que hacerlo todo tú mismo. También tiene una memoria y un contexto limitados sobre lo que has hecho antes.

Claude Code, es completamente diferente. Se ejecuta directamente en tu ordenador, en la terminal (= la ventana negra con texto que usan los desarrolladores). Y ahí, se mete en harina: puede leer y modificar tus archivos (en una carpeta autorizada), ejecutar código, lanzar comandos, crear carpetas, llamar a API, hacer pruebas… Realmente actúa sobre tu máquina, no solo en un cuadro de diálogo.

Es la diferencia entre alguien que te aconseja desde su sofá por teléfono, y alguien que está ahí, sentado a tu lado, que puede abrir tus cajones, leer tus documentos y hacer las cosas por ti.

Por eso se llama agente : no solo responde, actúa.

Los consejos que me ayudaron

Un amigo, Kevin (os recomiendo encarecidamente leer su presentación), me dijo que había que

1. desafiar a la IA
2. y hacerle verificar su trabajo en cada paso.

JB me dijo que le recordara regularmente a la IA que documentara el proceso en un archivo llamado CLAUDE.md, preguntar si la IA tiene preguntas, y pedirle a la IA que siempre me dé su plan detallado antes de ejecutar cualquier cosa (en Claude, eso se llama «modo plan«).

El CLAUDE.md, ¿qué es?
¿Sabes lo que es un compañero nuevo que llega a una empresa? El primer día no sabe nada: cómo trabaja el equipo, las costumbres, las reglas no escritas, los proyectos en curso. Hay que explicarle todo desde cero.
Claude Code es igual. Por defecto, en cada nueva sesión no recuerda nada. Todo lo que habéis hecho juntos, todas las decisiones tomadas, todas las preferencias que le has explicado… desaparecido.
El CLAUDE.md es el archivo que resuelve ese problema. Es un simple archivo de texto que vive en tu proyecto, y que Claude relee automáticamente cada vez que arranca. Es su memoria permanente. Su manual de bienvenida. Su cuaderno de bitácora.

Sin embargo, en ~/.claude/settings.json, hay que desactivar memory porque memory lo contiene todo y cualquier cosa y lastra innecesariamente el contexto.

"autoMemoryEnabled": false

Por qué Claude Code lo cambia todo para mis traducciones

Antes usaba solo la API, con herramientas limitadas. Ahora con Claude Code, puedo darle acceso a un montón de archivos a la vez: un glosario, ejemplos de traducciones, libros .epub sobre el mismo tema. Es mucho más práctico que antes y la traducción es mucho más cualitativa. He leído pasajes traducidos al azar y con Claude Code, no he encontrado errores.

El problema: los tokens

Los tokens son la unidad que mide lo que la IA lee y escribe. Es como si alquilaras tiempo de cerebro. Cuanto más texto le das, más consumes y, por tanto, más caro resulta. Y los agoto muy rápido.

Para las tareas menos complejas, Kevin y JB me aconsejaron usar Deepseek (un modelo chino) con Claude Code (la interfaz que habla con el modelo, se llama harness, ver explicación más abajo). El modelo Deepseek es ligeramente peor que los de Claude, pero es infinitamente más barato (división por 25 aproximadamente). La relación calidad/precio es excepcional. JB y yo compartimos una cuenta de 25/30$ al mes que nos permite consumir miles de millones de tokens, algo que sería inalcanzable con los modelos de Claude.

Y precisamente, no quedarnos sin tokens nos hace completamente irresponsables ! En Deepseek, nunca hacemos limpieza en las conversaciones (/clear, /compact), no optimizamos nada. En Claude, en cambio, como solo tenemos una suscripción de 20$/mes cada uno y se va rápido, prestamos mucha atención: optimizamos con regularidad, auditamos nuestros procesos para ahorrar tokens. La gente como nosotros está contaminando el planeta, ¡mal!

Claude Code es lo que se llama un «harness» (= una interfaz, una carcasa). Imagina un robot con brazos. Los brazos, las pinzas, el hecho de que agarre objetos, los mueva, abra cajones, pulse botones… eso es la harness. Es quien hace las cosas concretas en el mundo real. Pero la cabeza, la que piensa y decide qué hacer con esos brazos, se puede cambiar. Se pone una cabeza muy inteligente para tareas complejas, una cabeza más básica para tareas simples. El cuerpo del robot sigue siendo exactamente el mismo, solo cambias lo que hay sobre los hombros.

Claude Code es igual. La harness son los brazos: lee tus archivos, lanza comandos, modifica documentos, gestiona los pasos uno tras otro. Eso es fijo, no cambia. Pero la cabeza dentro, la que piensa y escribe, ¡se puede cambiar! Con un poco de configuración técnica, se puede poner Claude Opus, Sonnet o Haiku por supuesto, pero también Deepseek, GPT Sol o Gemini. Los brazos siguen siendo los mismos, solo cambias la cabeza. Es muy práctico: se pone una cabeza potente para tareas complejas (Claude Fable 5), una cabeza más barata para tareas simples (Deepseek).

Leer la documentación técnica lo cambia todo

JB siempre dice que el que lee la documentación técnica tiene más ventajas que los demás. Y como me encanta leer documentación técnica, ¡los leo por nosotros dos! Así descubrí funcionalidades que Claude no ofrece por defecto (/skill, sub agents, agent teams) : hay que pedirle que haga una auditoría del proceso, y entonces lo optimiza todo.

¿Qué son los skills y los sub-agents?

Por defecto, cuando trabajas con Claude Code, hace todo él mismo, solo, paso a paso. Está bien, pero no es óptimo.
Los skills (= competencias), son como fichas de trabajo que preparas de antemano. Por ejemplo: «cuando traduzcas, aquí tienes exactamente cómo debes comportarte, aquí está el glosario a respetar, aquí está el estilo esperado». En lugar de explicarle cada vez, saca de su ficha y arranca directamente con buenas bases. Eso evita repetir las mismas instrucciones y mejora la calidad del resultado.

Los subagentes (= subagentes), es aún más potente. En lugar de tener un solo Claude que hace todo, tienes varios que trabajan en paralelo, cada uno en una tarea específica. Un poco como un equipo. En mi caso para las traducciones, es enorme: en lugar de que un solo agente traduzca, luego verifique y luego corrija, tengo un agente «traductor» que traduce y otro «editor» que revisa y desafía el trabajo del primero. El resultado es mucho mejor, y es más rápido.

Los diferentes modelos

Para las traducciones, siempre me ha gustado la calidad de Claude Sonnet 4.6.

Para las verificaciones grandes, descubrí Claude Fable 5 recientemente y estoy súper contenta. Es rápido, de una precisión quirúrgica, y ve más allá de lo que se le pide. Consume muchísimos tokens por sesión (cada sesión me cuesta el equivalente a 25$ si pasáramos por la API), pero al final resuelve las tareas complejas en menos sesiones que los otros modelos (le lancé un libro entero y se dio cuenta de las inconsistencias de traducción y es capaz de citar 3 lugares diferentes del libro para justificar la elección de una palabra en el 4º lugar). Estoy contenta de tenerlo en mi suscripción a Claude Pro hasta el 22 de junio.

Deepseek V4 Pro piensa demasiado rápido y escribe scripts de calidad dudosa. Hay que obligarlo a reflexionar y proponer soluciones antes de codificar, si no, se lanza de cabeza, rompe todo, y el debug se convierte en un dolor de cabeza. Lo uso para tareas básicas (creación de sitios web simples, scripts para hacer epubs).

Mis aprendizajes

Trabajar con IA requiere ponerse en modo gerente y no en modo ejecutivo. En lugar de pensar «cómo lo vamos a hacer», debo cambiar y pensar «qué resultado quiero, sin importar cómo llegue a él». Por ejemplo, para una traducción: me da igual que divida mi texto en 2 o en 4, es su problema. Mi problema es tener la mejor traducción posible, con un estilo homogéneo de principio a fin. Él debe arreglárselas para lograrlo. Las raras veces que le digo qué hacer («haz un script en Python», «envía eso en lote»), es microgestión, y se traduce directamente en ineficiencia. En lugar de encontrar la mejor solución técnica, sigue MI solución técnica, que no es necesariamente la correcta. Es como si contrataras a un experto y le dictaras cada movimiento en lugar de explicarle lo que quieres obtener. Será necesariamente peor que si solo le hubieras dado el objetivo. También podemos pensar en modo proceso y equipos: quiero un traductor, un segundo que verifique la calidad de la traducción, un diseñador web, …

Todavía me pasa que me limito yo sola pensando «uy, esto parece complejo, no se lo voy a pedir». Gran error. Debo recordarme que no hay absolutamente ningún límite. Un ejemplo concreto: quiero ofrecer .epub (= libros digitales) accesibles para todos. Pero para mi lector reMarkable 2 (= una tableta especial para leer y tomar notas), necesito los epub en un formato un poco específico. Si fuera un humano quien hiciera este trabajo, me sentiría culpable de pedirle un esfuerzo adicional solo para el 0,5% de los lectores. Así que me autocensuraría. Pero aquí es una IA. No se cansa, no suspira, no mira el reloj. Pedirle que genere dos versiones en lugar de una no le cuesta nada. Mi inmenso placer de leer un ebook perfectamente adaptado a mi lector no es en absoluto un capricho, es solo un resultado adicional que habría estado mal no pedir. La regla que debo aplicarme: si dudo en pedir algo porque «es demasiado», lo pido de todos modos. Con la IA, se puede pedir la perfección, a diferencia de un humano.

Actualización: me di cuenta de que me limito menos cuando tengo un número casi ilimitado de tokens. Así que si crees que puedes llegar más lejos, toma el paquete ++ de 200$ solo por un mes para no limitarte y aprender al máximo, luego vuelve al paquete de 20$.

Descubrí que se puede tomar el control de los programas que ya están instalados en mi ordenador mediante la línea de comandos. Así, en lugar de hacer el OCR (reconocimiento de caracteres) con la IA (y quemar los tokens), pude lanzar OCRs por línea de comandos para controlar el programa ABBYY. Y actualizar las tarjetas de memoria con mi programa ANKI. Así que no es porque una herramienta no tenga API/MCP que no podamos interactuar con ella. No dudes en decirle que escanee los programas que ya tienes, para ahorrar tokens.

Última cosa, y la recomiendo de verdad a todo el mundo: encuéntrate un buddy con quien hablar de Claude Code. Te vuelves absolutamente loco con esta herramienta, en el buen sentido. Tienes un deseo irresistible de hablar de ello con alguien. Si esa persona ya tiene experiencia, mejor aún: puedes hacerle preguntas sobre las buenas prácticas, mostrarle lo que Claude te ha respondido, preguntarle si es normal. Estoy convencida de que una hora de conversación con alguien que tiene un año de Claude Code a sus espaldas te ahorra fácilmente 3 meses de prueba y aprendizaje en solitario. Y además, también permite compartir la frustración de la falta de tokens. Entre adictos, es muy importante pasar tiempo con otros adictos! jajaja

En serio, también es muy útil para seguir las novedades. Hay tantas cosas que salen cada día que es imposible probarlo todo solo. Si cada uno prueba algo por su lado y lo comenta con los demás, cubrís mucho más terreno juntos.

Y por último, está el FOMO (= Fear Of Missing Out, el miedo a perderse algo, a quedarse atrás). Este FOMO es muy real. Cuando ves a qué velocidad la IA te permite avanzar, solo tienes un miedo: que tu competidor avance más rápido. Y esa angustia solo la pueden entender de verdad los que usan estas herramientas a diario. Así que sí, encuentra a tu buddy.

Si necesitas demostraciones y casos concretos y más complejos, aquí tienes una presentación compartida generosamente por Kevin Richard (nuestro amigo, a quien te recomiendo encarecidamente seguir en YouTube y X). Esta presentación es importante porque va a despertar a mucha gente (¡a mí desde luego me despertó!).