Claude Code: lo que me hubiera gustado saber desde el principio

Llevo unas semanas explorando Claude Code y como me ha pasado de todo, me he dado cuenta de que lo que más cuesta no es usarlo, sino organizar bien el trabajo.

Claude Code actúa como un agente de programación: lee el código, edita archivos y ejecuta comandos. Pero como en cada sesión arranca con la memoria en blanco, si el proyecto en el que estás no incluye la documentación que espera encontrar, en los archivos que espera encontrar y con los nombres que espera encontrar, es como tener un compañero brillante al que le tienes que presentar el proyecto cada mañana.

Empecé a base de intuición: una carpeta /docs por aquí, un archivo de esquema SQL por allá. Funcionaba, pero no del todo. Hasta que entendí cómo espera Claude Code encontrar la documentación del proyecto y cómo darle contexto entre sesiones.

He recopilado lo que he aprendido en estas dos guías que comparto por si os pueden ser útiles:

Primeros pasos con Claude Code — Para empezar desde cero: viendo que claude.ai no es lo mismo que Claude Platform (que no me resultó obvio al principio), cómo instalarlo, autenticar y hacer la primera sesión.

Buenas prácticas con Claude Code — Cómo estructurar las carpetas del proyecto, qué poner en el CLAUDE.md, cómo crear comandos personalizados y subagentes, y los errores que conviene evitar.

Las he escrito con la ayuda de Claude (sí, meta-recursivo), así que ha sido como hacer con él un curso acelerado para trabajar con él :-D.

Sigo aprendiendo, así que para los que vayáis por delante y veáis cosas mejorables o tengáis vuestras propias prácticas, se agradecen las sugerencias.