10 comandos básicos de Claude Code que todo estudiante de mecatrónica debe conocer

Claude Code se está volviendo una herramienta atractiva para quien programa desde terminal, pero muchos estudiantes de mecatrónica llegan con una idea equivocada: creen que basta con abrirla y pedir “haz mi proyecto”. Ahí empieza la frustración.

La utilidad real de Claude Code no está en delegarle todo, sino en reducir fricción: entender una base de código, moverse entre carpetas, resumir contexto, revisar cambios y evitar errores tontos antes de compilar, hacer commit o cargar firmware. En proyectos donde conviven Arduino, ESP32, Python, ROS y documentación, eso pesa más que el hype.

Estos son los 10 comandos básicos que sí vale la pena aprender primero.

Lo esencial

• Claude Code sirve mejor como copiloto de terminal, no como sustituto de criterio técnico.
• Los primeros comandos importantes no son los “más espectaculares”, sino los que te ayudan a ordenar contexto, controlar accesos y revisar cambios.
• Para mecatrónica, el beneficio real aparece cuando el proyecto mezcla software, pruebas y documentación, no solo cuando escribes una función aislada.

Los 10 comandos básicos que sí te conviene dominar

Comando	Para qué sirve	Ejemplo útil
/help	Ver comandos disponibles y salir de dudas rápido.	Cuando olvidas la sintaxis exacta y no quieres romper el flujo.
/init	Crear un CLAUDE.md con reglas del proyecto.	Definir estructura del repo, hardware objetivo y convenciones.
/add-dir <path>	Agregar otra carpeta de trabajo a la sesión.	Sumar una carpeta de pruebas o documentación fuera del repo principal.
/clear	Arrancar una conversación limpia.	Cuando pasaste de depurar un script a revisar nodos de ROS y ya mezclaste todo.
/resume	Retomar una sesión anterior.	Seguir un proyecto del semestre sin empezar desde cero.
/compact	Resumir la conversación para liberar contexto sin reiniciar.	Conservar decisiones clave de arquitectura y pendientes.
/diff	Revisar cambios hechos por Claude antes de aceptarlos.	Ver qué tocó antes de compilar o cargar firmware a un ESP32.
/permissions	Controlar qué herramientas y acciones están permitidas.	Evitar accesos excesivos en una laptop compartida o en laboratorio.
/doctor	Diagnosticar problemas de instalación y configuración.	Resolver fallos raros de terminal, login o integración.
/usage	Ver consumo y actividad de la sesión.	Medir si tu flujo está creciendo de más en costo o contexto.

1) /help: tu punto de partida real

Parece obvio, pero justo por eso muchos lo ignoran. /help debería ser tu primer reflejo cuando no recuerdas un comando o quieres confirmar qué opciones tienes disponibles en tu entorno.

La ventaja no es solo “ver una lista”. La ventaja es dejar de improvisar. Si estás empezando con Claude Code, intentar adivinar comandos es una manera muy eficiente de perder tiempo.

2) /init: documenta el proyecto antes de pedir milagros

Este comando inicializa un archivo CLAUDE.md, que funciona como una guía viva para el asistente dentro del proyecto. Para un estudiante de mecatrónica, esto vale oro.

Ahí puedes dejar reglas como estas:

• qué microcontrolador estás usando;
• qué lenguaje domina el repo;
• qué carpetas contienen pruebas, simulación o firmware;
• qué archivos no debe tocar sin pedir permiso;
• qué estilo de comentarios y documentación quieres.

Sin ese contexto, Claude Code puede ayudarte. Con ese contexto, empieza a ser realmente útil.

3) /add-dir <path>: ideal para proyectos partidos en varias carpetas

Muchos proyectos universitarios no viven en un solo repositorio limpio. A veces tienes el firmware en una carpeta, los scripts de adquisición en otra y la documentación en otro lado. /add-dir sirve justo para eso: sumar una ruta adicional a la sesión actual.

Es un comando especialmente útil cuando estás trabajando con un proyecto mixto, por ejemplo:

• código de Python para análisis;
• archivos de PlatformIO o Arduino;
• logs de pruebas;
• manuales o apuntes técnicos.

En mecatrónica, esa mezcla no es la excepción. Es el pan de cada día.

4) /clear: no arrastres una conversación que ya se desvió

Uno de los errores más comunes con herramientas de coding AI es querer resolver todo en una sola sesión eterna. Empiezas con un parser serial, luego te pasas a una calibración, después preguntas por Git y al final ya nadie entiende el contexto, ni tú ni la herramienta.

/clear te deja arrancar una conversación vacía sin perder la anterior. Es mejor hacer eso que seguir acumulando ruido.

5) /resume: útil cuando el proyecto dura semanas, no una tarde

En teoría, todos los proyectos académicos deberían estar bien organizados. En la práctica, muchos viven por etapas: investigación, prototipo, integración, documentación y entrega. /resume te permite volver a una sesión previa por nombre o identificador.

Eso es mucho más útil de lo que parece cuando retomas un avance de hace varios días y no quieres volver a explicarle a Claude Code qué estaba pasando con tu nodo de ROS, tu script de visión o tu carpeta de pruebas.

6) /compact: conserva lo importante sin seguir quemando contexto

Este es uno de los comandos más infravalorados. /compact resume la conversación para liberar contexto, pero sin tirar todo a la basura como harías con /clear.

Es especialmente útil cuando ya definiste decisiones importantes y solo quieres seguir con lo esencial. Por ejemplo:

• mantén las decisiones sobre arquitectura del proyecto;
• conserva pendientes y archivos afectados;
• elimina exploraciones viejas que ya no importan.

Para un proyecto de mecatrónica con varias capas, esta diferencia importa bastante.

7) /diff: no aceptes cambios a ciegas

Este quizá debería venir tatuado en cualquier guía seria de coding AI: nunca des por bueno un cambio solo porque “se ve razonable”. /diff te permite revisar qué modificó Claude antes de que tú lo tomes como correcto.

En mecatrónica, esto importa todavía más porque el costo de un cambio malo no siempre es solo un bug bonito en pantalla. A veces significa:

• tiempo perdido de laboratorio;
• una compilación rota minutos antes de la demo;
• comportamientos extraños en hardware que no eran obvios leyendo rápido.

Antes de hacer commit, compilar o cargar algo al dispositivo, pasa por /diff.

8) /permissions: útil para no soltarle la correa demasiado pronto

Claude Code puede leer archivos, ejecutar herramientas y operar dentro del proyecto. Eso es útil, pero también exige criterio. /permissions te ayuda a decidir qué puede hacer automáticamente y qué debe preguntarte antes.

Para estudiantes, esta parte suele ignorarse. Y sin embargo es clave, sobre todo en dos escenarios comunes:

• usas una computadora compartida;
• estás trabajando en un repo con scripts delicados o automatizaciones que no quieres disparar sin revisar.

La regla sensata no es “bloquearlo todo”, sino abrir permisos de forma gradual.

9) /doctor: cuando algo falla y no sabes si el problema eres tú o la instalación

Hay momentos en los que Claude Code no responde como debería y el problema no está en tu prompt, sino en la configuración, el login, el entorno o la integración del sistema. Ahí entra /doctor.

Para quien estudia mecatrónica y suele moverse entre Windows, WSL, Git Bash, Linux de laboratorio o máquinas prestadas, este comando es más importante de lo que parece. Te ahorra muchas vueltas tontas antes de culpar al modelo o a tu proyecto.

10) /usage: mira el consumo antes de que el flujo se te vuelva caro o torpe

No todo estudiante necesita obsesionarse con tokens, pero sí conviene vigilar cuándo una sesión se volvió demasiado larga, pesada o cara para lo que te aporta. /usage ayuda a medir eso.

También tiene un valor pedagógico: te obliga a notar qué tipo de interacción te conviene más. A veces una buena instrucción corta y un /diff bien revisado valen más que una sesión gigantesca que mezcla cinco problemas distintos.

---

Un flujo simple para usar estos comandos en un proyecto real

Imagina un proyecto típico: un sistema con ESP32, lectura de sensores, una pequeña interfaz en Python y algo de documentación para la entrega. Un flujo razonable con Claude Code se vería así:

1. Abres el proyecto y ejecutas /init para dejar reglas claras.
2. Usas /add-dir si tienes otra carpeta con pruebas, notebooks o documentación.
3. Trabajas por bloques, no con una sola conversación eterna.
4. Si el contexto crece demasiado, ejecutas /compact para quedarte con lo importante.
5. Antes de aceptar cambios, revisas con /diff.
6. Si algo se rompe raro, pasas por /doctor.
7. Si vas a retomarlo otro día, cierras y luego vuelves con /resume.

Ese flujo suena menos emocionante que “la IA programó mi robot”, pero es mucho más útil en el mundo real.

Claude Code no reemplaza entender electrónica, control, ROS o programación embebida. Lo que sí puede hacer es quitarte fricción operativa para que gastes más tiempo en ingeniería y menos tiempo en pelearte con el contexto.

Errores comunes que vale la pena evitar

• Usarlo sin /init y esperar que entienda tu proyecto por telepatía.
• Mezclar demasiados temas en una sola conversación en lugar de usar /clear o /compact.
• Aceptar cambios sin revisar /diff.
• Dar permisos demasiado amplios muy pronto.
• Confundir ayuda de código con validación física: que el script se vea bien no significa que el sistema ya funcione en hardware.

Este último punto es especialmente importante en mecatrónica. Un asistente puede ayudarte a escribir o reorganizar código, pero no sustituye una prueba de banco, una revisión de señales, una medición real ni una validación de seguridad.

Para quién sí vale la pena y para quién todavía no

Sí vale la pena si ya trabajas con terminal, Git y proyectos donde se mezclan varias carpetas, lenguajes o etapas técnicas. Ahí Claude Code puede actuar como una capa de productividad bastante útil.

Todavía no es la mejor puerta de entrada si apenas estás aprendiendo a programar y todavía no distingues bien entre un error de sintaxis, un problema de arquitectura o un fallo de hardware. En ese caso, quizá primero te conviene reforzar bases.

Si vienes del lado más clásico del sitio, este post conversa bien con ¿Cómo puedo programar un Arduino con Python? y con Los 10 mejores software gratuitos para ingeniería mecatrónica. Y si quieres una lectura más amplia sobre cómo cambia la forma de programar con IA, vale la pena revisar Sé intencional: Cómo la IA transforma tu código.

También tiene sentido enlazar este enfoque con proyectos híbridos como Estación Meteorológica Inalámbrica con Sensores Distribuidos (ESP32), donde el valor no está en “generar código por generar”, sino en coordinar mejor firmware, pruebas y documentación.

Conclusión

La mejor manera de empezar con Claude Code no es perseguir el comando más avanzado, sino dominar los que te ayudan a trabajar con orden. Para un estudiante de mecatrónica, eso significa algo muy concreto: entender el proyecto, controlar el contexto, revisar cambios y no perder tiempo en sesiones caóticas.

Si solo te quedas con una idea, que sea esta: Claude Code rinde más cuando tú también trabajas con disciplina. Y esos 10 comandos son un buen punto de partida para hacerlo sin humo.