Cómo uso Claude Code de forma profesional: mis consejos

Así uso Claude Code en el día a día de mi trabajo profesional como desarrollador de software. Desde la configuración y CLAUDE.md hasta los comandos de barra, la gestión del contexto y consejos reales que mejoran la calidad de los resultados en cada proyecto. Sin exageraciones, solo lo que funciona.

Cómo uso Claude Code de forma profesional: mis consejos
Cristian Da Conceicao
Fundador de Picasso IA

Llevo meses usando Claude Code como parte de mi flujo de trabajo profesional diario, y la diferencia en productividad es real. No de forma vaga o genérica. Sino de una manera concreta: "saqué esa funcionalidad en dos horas en lugar de dos días". Pero me llevó tiempo descubrir cómo sacarle el máximo partido. Estos son los hábitos, las configuraciones y los flujos de trabajo que he consolidado después de mucho ensayo y error.

Manos de desarrollador escribiendo en un teclado mecánico con código de terminal reflejado en las teclas

Por qué por fin lo entendí

Antes de Claude Code, copiaba y pegaba código en una interfaz de chat, perdía el contexto constantemente y pasaba la mitad del tiempo reformateando la respuesta de la IA para que encajara en mi base de código real. Claude Code se ejecuta directamente en la terminal, lee tus archivos y trabaja dentro del directorio de tu proyecto. Eso lo cambia todo.

Claude Code ve tu código real

Esta es la diferencia más importante. Claude Code no trabaja con fragmentos abstractos. Lee tus archivos reales, ve tus importaciones reales y entiende la estructura real de tu proyecto. Cuando le pido que añada una funcionalidad, sabe qué ya existe. No inventa importaciones que no existen ni escribe funciones que duplican algo que ya tienes tres archivos más allá.

El flujo de trabajo en terminal encaja

Yo trabajo en la terminal. Tener un asistente de IA que funciona donde ya trabajo, sin cambiar de contexto y sin copiar y pegar, tiene sentido. La fricción es casi nula una vez que está configurado. Abro el directorio de mi proyecto, inicio una sesión de Claude Code y soy productivo de inmediato.

Desarrollador en un escritorio de pie con una terminal dividida y un panel de asistente de IA visible en el monitor

La configuración que realmente importa

La mayoría de los desarrolladores se saltan la fase de configuración y luego se preguntan por qué sus resultados son desiguales. No hagas eso. Los cinco minutos que dediques a la configuración te ahorran horas cada semana.

CLAUDE.md es imprescindible

Cada proyecto en el que trabajo tiene un archivo CLAUDE.md en la raíz. Es el archivo de configuración que Claude Code lee automáticamente cuando inicias una sesión en ese directorio. Pongo todo aquí:

  • Qué hace el proyecto (un párrafo claro, sin lenguaje de marketing)
  • La pila tecnológica: lenguaje, frameworks, biblioteca de pruebas, base de datos
  • Comandos de compilación y ejecución: cómo iniciar el servidor de desarrollo, ejecutar pruebas y compilar para producción
  • Convenciones de nombres: nombres de archivos, de funciones y estilo de nombres de clases CSS
  • Restricciones estrictas: "nunca uses any en TypeScript", "todas las llamadas a la API pasan por la capa de servicio", "nada de manipulación directa del DOM en los componentes de React"
  • Qué no generar: patrones o abstracciones que has decidido explícitamente no usar en esta base de código

Sin este archivo, Claude Code tiene que deducir las reglas en cada sesión. Con él, tienes un colaborador que ya conoce las normas de la base de código antes del primer mensaje.

Listas de permitidos y permisos

Claude Code pide permiso antes de ejecutar comandos de shell. Configuro la lista de permitidos en .claude/settings.json para no tener interrupciones en cada operación con la que me siento cómodo. Para servidores de desarrollo local, ejecutores de pruebas y comandos de compilación, los permito de antemano. Para operaciones destructivas, como migraciones de base de datos, force push o cualquier patrón rm -rf, mantengo deliberadamente activas las solicitudes de confirmación.

Acotar las herramientas por proyecto

No le doy a Claude Code acceso a todas las herramientas en todos los proyectos. En un proyecto de frontend no necesita acceso a la base de datos. En un servicio de backend no necesita automatización de navegador. Cuanto más acotado sea el alcance de las herramientas, más precisa y menos arriesgada será cada interacción. Piénsalo como un acceso con el mínimo privilegio necesario para tu asistente de programación con IA.

Vista aérea de un espacio de trabajo de desarrollador con cuaderno, equipo portátil, taza de café y copias de código impresas

Los comandos de barra que realmente uso

Estos no son evidentes en la documentación, pero son algunas de las funciones más útiles en un flujo de trabajo diario real.

/clear cuando el contexto se vuelve obsoleto

La gestión de la ventana de contexto es un problema real. Tras una sesión larga, has acumulado mucho historial de conversación. Parte es relevante. La mayoría es ruido de tareas anteriores. Cuando cambio a una parte completamente distinta de la base de código, ejecuto /clear para borrar el historial de la sesión. Un contexto limpio produce respuestas más precisas y centradas.

/compact para sesiones largas

Cuando estoy inmerso en una sesión de programación pero no quiero perder por completo el hilo, uso /compact. Resume la conversación actual en una forma comprimida, conservando el contexto importante y liberando presupuesto de tokens. Lo uso cuando estoy a mitad de una funcionalidad y necesito seguir sin empezar de cero.

/model para distintas tareas

No todas las tareas necesitan el mismo modelo. Para ediciones rápidas, explicaciones y refactorizaciones sencillas, un modelo más rápido funciona bien y responde con prontitud. Para decisiones de arquitectura complejas o refactorizaciones de varios archivos con dependencias sutiles, cambio a Claude Opus 4.7 para un razonamiento más profundo. Claude 4 Sonnet se sitúa en el punto medio: preciso, fiable y muy adecuado para la mayoría de las tareas de programación profesional. Ajustar el modelo a la complejidad de la tarea reduce costos y mantiene la calidad de los resultados donde tiene que estar.

Desarrollador estudiando un monitor ultrapanorámico que muestra un diff de refactorización de código complejo con líneas verdes y rojas

Cómo doy contexto (sin desperdiciarlo)

La mayor diferencia entre los desarrolladores que obtienen resultados excelentes de Claude Code y los que obtienen resultados mediocres está en cómo formulan sus peticiones. No se trata de escribir mucho. Se trata de darle al modelo lo que necesita para tomar la decisión correcta a la primera.

Describe la intención, no solo la tarea

Prompt débil: "Corrige el error en auth.ts."

Prompt sólido: "La función validateUser de auth.ts lanza una excepción de puntero nulo cuando el objeto de usuario no tiene un campo de correo electrónico. El campo de correo es opcional en el esquema, pero la función no gestiona ese caso. Corrígelo sin cambiar la firma de la función ni el tipo de retorno."

La segunda versión le da a Claude Code el qué, el porqué y la restricción. Obtienes la solución correcta de una vez, en lugar de tres ciclos de revisión.

Dale el error completo

Al depurar, pego la traza de la pila completa. No un resumen. No una paráfrasis. La salida real del error, con rutas de archivos, números de línea y el mensaje exactamente como apareció. El análisis de la causa raíz es mucho mejor cuando Claude Code trabaja a partir del error real y no de una descripción de él.

Establece qué ya existe

Antes de pedir una funcionalidad nueva, describo el código existente en contexto: "Esta es la implementación actual de UserService. Quiero añadir un método deactivateUser que siga el mismo patrón que deleteUser, pero que establezca status en inactive en lugar de eliminar el registro." Esto elimina la ambigüedad sobre el estilo y los patrones existentes antes de que Claude Code escriba una sola línea.

Primer plano de la mano de un desarrollador junto al panel táctil de un equipo portátil con la salida de una terminal de depuración en pantalla

Mi flujo de trabajo para refactorizar

La refactorización es donde Claude Code me ahorra más tiempo. Pero necesitas el proceso adecuado para no introducir errores mientras avanzas rápido.

Revisa siempre el diff

Antes de aprobar cualquier edición de varios archivos, leo el diff con atención. Sin hojear. Leyendo de verdad cada línea modificada y preguntándome: ¿este cambio hace lo que pretendía? ¿Toca algo que no esperaba? Claude Code es bueno en las refactorizaciones, pero a veces hace cambios adyacentes basándose en suposiciones sobre lo que probablemente quieres. El diff es tu último punto de control antes de que los cambios se apliquen.

Un cambio a la vez

No pido refactorizaciones grandes de una sola vez. Las divido en pasos atómicos: "Renombra todas las instancias de UserRecord por UserDocument en toda la base de código". Reviso y apruebo. "Ahora actualiza la interfaz de TypeScript en types/user.ts para que coincida con el nuevo nombre". Reviso y apruebo. Los cambios secuenciales más pequeños son más fáciles de verificar y más seguros de aplicar.

Úsalo para refactorizaciones mecánicas

Las refactorizaciones para las que más uso Claude Code son las tediosas y repetitivas. Migrar de un cliente HTTP a otro. Añadir un manejo de errores coherente en 40 funciones similares. Actualizar todas las llamadas a la API para usar un nuevo patrón de autenticación. Son tareas en las que una persona se cansa y termina introduciendo incoherencias sutiles. Claude Code mantiene la misma coherencia en cada caso.

Dos desarrolladores de software colaborando en un escritorio compartido con código en el monitor y un fondo de pared de ladrillo visto

Escribir pruebas con Claude Code

He cambiado la forma en que escribo pruebas desde que uso Claude Code. Ahora escribo primero el código de producción y le pido a Claude Code que genere las pruebas después, usando la implementación real como contexto.

El patrón de prompt que funciona

Después de escribir una función, digo: "Escribe pruebas unitarias para esta función. Cubre el caso feliz, las entradas nulas y vacías, y cualquier caso límite que identifiques a partir de la implementación. Usa el mismo estilo de aserciones y la misma estructura de archivos de prueba que las pruebas existentes en este directorio".

Esa última instrucción importa mucho. Señalarle los archivos de prueba existentes mantiene el estilo coherente y evita que invente otra biblioteca de aserciones o un patrón de organización de pruebas distinto.

Revisa la cobertura con espíritu crítico

Claude Code a veces genera pruebas que parecen exhaustivas pero que no cubren los casos límite reales de tu implementación concreta. Siempre me pregunto: ¿ha probado las rutas de ramificación exactas de mi función? ¿Ha probado los efectos secundarios, no solo el valor de retorno? Una prueba que comprueba el comportamiento incorrecto es peor que no tener ninguna, porque da una falsa confianza durante la integración continua.

Pide pruebas que fallarían

Una técnica que uso con regularidad: pedirle a Claude Code que escriba un caso de prueba que fallaría con la implementación actual y luego que corrija la implementación para que pase. Esto le obliga a pensar qué está haciendo mal el código en realidad, en lugar de generar aserciones plausibles alrededor del comportamiento existente.

Perfil lateral de un desarrollador con expresión satisfecha, con el resplandor del monitor mostrando marcas de verificación verdes de pruebas superadas

Dónde flaquea Claude Code

Ser honesto con las limitaciones te convierte en un mejor usuario de la herramienta y te evita publicar errores que podrías haber detectado.

Cadenas largas de dependencias

Cuando un cambio requiere seguir una cadena de dependencias a través de seis o siete archivos, Claude Code puede perder el hilo. Si tu corrección en routes/users.ts depende de entender middleware/auth.ts, services/userService.ts, models/user.ts y utils/validation.ts para que salga bien, quizá tengas que cargar explícitamente esos archivos en el contexto antes de pedir el cambio. No des por hecho que los encontrará y cargará todos por su cuenta.

Seguro de sí mismo, pero equivocado

Claude Code a veces te da una respuesta incorrecta con una confianza aparente alta. No matiza ni dice "no estoy seguro de esto". Escribe código que compila pero tiene un error lógico sutil. Por eso ejecutas tu suite de pruebas después de cada cambio generado por IA. El modelo es un colaborador capaz, no una fuente de verdad absoluta.

Deriva del contexto en sesiones largas

En una sesión muy larga en la que has cambiado de dirección varias veces, Claude Code puede empezar a basarse en contexto obsoleto de principios de la conversación. Si has cambiado de enfoque de forma significativa a mitad de sesión, usa /clear y vuelve a establecer el estado actual del código. Empezar de nuevo siempre es mejor que dejar que un contexto desfasado influya en las decisiones nuevas.

Desarrollador reclinado en una silla ergonómica con expresión relajada y satisfecha en un acogedor despacho en casa

Otros modelos de IA que vale la pena tener en tu caja de herramientas

Claude Code se basa en la familia de modelos Claude de Anthropic, pero el desarrollo profesional asistido por IA no se limita a eso. Los distintos modelos tienen fortalezas diferentes y conviene saber qué hace bien cada uno.

Claude 4.5 Sonnet ofrece una calidad de generación de código mejorada para tareas más largas y complejas. Claude Opus 4.6 aporta un razonamiento más profundo para decisiones de arquitectura en las que necesitas algo más que una compleción de texto rápida. Claude 3.7 Sonnet funciona bien para documentación, explicaciones y resúmenes escritos.

Entre las alternativas de código abierto, Deepseek R1 es realmente impresionante en tareas de programación y merece la pena ejecutarlo junto a Claude para compararlos. GPT-4o sigue siendo sólido en razonamiento general y puede servir como una segunda opinión útil en decisiones complejas. Cuando la velocidad importa y la tarea es más ligera, Claude 4.5 Haiku es rápido y eficiente en costos sin sacrificar demasiada precisión.

Los hábitos que marcaron la verdadera diferencia

Tras meses de uso diario, estos son los hábitos concretos que más resultados dieron:

HábitoPor qué funciona
Escribe CLAUDE.md antes que nadaElimina tener que volver a establecer el contexto en cada sesión nueva
Lee el diff completo antes de aprobarDetecta errores sutiles antes de que se acumulen
Usa /clear entre tareas no relacionadasMantiene el contexto preciso y evita la deriva obsoleta
Pega las trazas de pila de error completasMejora notablemente la precisión del análisis de la causa raíz
Pide cambios pequeños y secuencialesMás fáciles de revisar y más seguros de aplicar
Nombra las restricciones explícitamente en los promptsEvita cambios de estilo no deseados o refactorizaciones adicionales
Ajusta el modelo a la complejidad de la tareaEquilibra la calidad de la salida y el costo por petición

Consejo: La forma más rápida de mejorar la calidad de los resultados de Claude Code es hacer más específico tu primer mensaje. Cada palabra vaga en tu prompt te cuesta un ciclo de revisión.

Qué suma todo esto en realidad

No escribo menos código. Escribo código mejor, más rápido y con menos errores llegando a la revisión. Claude Code no sustituye pensar en la arquitectura, el diseño o las contrapartidas. Elimina la fricción de las partes que no requieren pensamiento creativo: código repetitivo, actualizaciones repetitivas, generación de pruebas, correcciones de formato y errores evidentes.

Los desarrolladores que más partido sacan a las herramientas de programación con IA no lo delegan todo. Mantienen el control mientras dejan que la herramienta se encargue del trabajo pesado. Ese equilibrio es ahora la verdadera habilidad.

Si quieres ejecutar los modelos que impulsan herramientas como Claude Code directamente en tu navegador, en Picasso IA tienes Claude Opus 4.7, Claude 4 Sonnet, Claude 3.5 Sonnet y decenas de otros modelos en un solo lugar. Sin claves de API ni configuración local. Puedes probar prompts, comparar resultados entre modelos y ganar intuición sobre lo que esperar de cada uno antes de llevarlo a tu flujo de trabajo profesional.

Desarrollador trabajando en un escritorio al atardecer con el skyline de la ciudad por la ventana y el resplandor del monitor iluminando su rostro

Compartir este artículo

Elige tu idioma