1. Blog
2. Desarrollo web

Comandos secretos de Claude Code que debes conocer

Claude Code tiene una capa de comandos y configuraciones que la mayoría de los usuarios nunca explora. Conocerlos puede reducir a la mitad el tiempo que pasas repitiendo instrucciones, corrigiendo contexto o gestionando tareas complejas.

Qué es Claude Code y por qué importa ir más allá de lo básico

Claude Code es el agente de programación de Anthropic que se ejecuta directamente desde la terminal. A diferencia de los chatbots convencionales, puede leer archivos, editar código, ejecutar comandos del sistema y navegar por el árbol de directorios de un proyecto real.

La mayoría de los desarrolladores lo usa de forma conversacional: escriben una instrucción en lenguaje natural y esperan una respuesta. Eso funciona, pero deja sin aprovechar un conjunto de herramientas que cambia por completo la experiencia de uso.

Los comandos que se describen en este artículo no son trucos. Son funcionalidades documentadas —algunas más visibles que otras— que permiten controlar el comportamiento del agente, gestionar el contexto de trabajo, automatizar tareas repetitivas y mantener la coherencia en proyectos de larga duración.

Si ya leíste una introducción general sobre qué puedes crear con Claude Code, este artículo es el siguiente paso lógico.

Comandos slash: el panel de control que pocos usan

Dentro de una sesión activa de Claude Code, los comandos que empiezan con / permiten controlar el agente sin salir de la conversación. No son parte del mensaje: son instrucciones directas al sistema.

Los más importantes

/help
Muestra el listado completo de comandos disponibles en la versión que tienes instalada. Es el punto de partida si trabajas con una versión reciente y no sabes qué hay disponible.

/clear
Borra el historial de la sesión actual. Útil cuando el contexto acumulado empieza a generar respuestas inconsistentes. Al ejecutarlo, el agente empieza desde cero sin memoria de lo que se escribió antes.

/compact
Comprime el contexto de la conversación manteniendo un resumen de lo esencial. Es distinto a /clear: no borra, sino que condensa. Se recomienda usarlo en sesiones largas donde el límite de tokens empieza a afectar la calidad de las respuestas.

/memory
Muestra qué tiene guardado el agente en su memoria persistente (si está habilitada). Permite revisar y editar las notas que Claude Code ha acumulado sobre el proyecto o las preferencias del usuario.

/doctor
Ejecuta un diagnóstico del entorno: verifica que las dependencias estén instaladas correctamente, que la autenticación esté activa y que los permisos del sistema sean los adecuados. En la práctica, es lo primero que conviene ejecutar cuando algo falla sin razón aparente.

/init
Genera o actualiza el archivo CLAUDE.md del proyecto actual. Analiza el repositorio y propone una estructura de contexto inicial. Se explica en detalle más adelante.

/review
Solicita una revisión explícita del código modificado en la sesión, con enfoque en calidad, errores potenciales y mejoras. Es distinto a pedir una revisión en lenguaje natural porque activa una evaluación más estructurada.

/cost
Muestra el costo estimado en tokens de la sesión actual. Imprescindible si se trabaja con la API de Anthropic y se quiere controlar el gasto.

Flags y opciones de línea de comandos

Antes de que empiece una sesión, Claude Code acepta flags que modifican su comportamiento desde el inicio. Se pasan al ejecutar el comando claude en la terminal.

Los más útiles

--print / -p
Ejecuta Claude Code en modo no interactivo. Recibe un prompt como argumento y devuelve la respuesta directamente en la salida estándar. Es ideal para integrarlo en scripts o pipelines de CI/CD.

claude -p "Revisa el archivo app.py y lista los errores de sintaxis"

--output-format
Controla el formato de la salida cuando se usa en modo no interactivo. Acepta text, json y stream-json. El formato JSON es especialmente útil cuando se procesa la salida con otras herramientas.

claude -p "Lista las funciones definidas en utils.js" --output-format json

--model
Permite especificar qué modelo de Claude usar. Si tienes acceso a varios (por ejemplo, claude-opus-4 y claude-sonnet-4), puedes elegir según la complejidad de la tarea.

claude --model claude-opus-4-5

--add-dir
Agrega un directorio adicional al contexto de trabajo, fuera del directorio actual. Sirve para trabajar con proyectos que tienen dependencias en rutas distintas.

claude --add-dir /proyectos/libreria-compartida

--permission-mode
Define el nivel de autonomía del agente. Los valores más relevantes son default (pide confirmación antes de acciones destructivas) y bypassPermissions (ejecuta sin pedir confirmación, útil en entornos controlados y automatizados).

--dangerously-skip-permissions
Desactiva todas las confirmaciones de permisos. Solo recomendable en entornos completamente aislados, como contenedores Docker o máquinas virtuales dedicadas. Nunca en producción.

Comandos y sus características

El archivo CLAUDE.md: cómo hacer que Claude Code te recuerde todo

El CLAUDE.md es un archivo de texto que se coloca en la raíz del proyecto. Claude Code lo lee automáticamente al inicio de cada sesión y lo usa como contexto persistente.

En la práctica, es como un briefing permanente: ahí se pueden especificar las convenciones del proyecto, las restricciones técnicas, el stack utilizado, los comandos de build y test, o cualquier instrucción que se deba respetar en todas las interacciones.

Un ejemplo mínimo pero efectivo:

# Contexto del proyecto

## Stack
- Backend: Node.js 20 + Express
- Base de datos: PostgreSQL 15
- Frontend: React 18 + Vite

## Convenciones
- Usar async/await, nunca callbacks
- Todos los endpoints deben validar con Zod
- Los errores se manejan con un middleware centralizado

## Comandos útiles
- `npm run dev` — servidor de desarrollo
- `npm run test` — suite de tests con Vitest
- `npm run build` — build de producción

Con este archivo presente, no es necesario repetir el contexto en cada sesión. El agente opera desde el primer mensaje con conocimiento del proyecto.

Para profundizar en cómo estructurarlo bien, hay una guía específica sobre qué poner en CLAUDE.md que cubre casos más avanzados.

Comandos para gestionar contexto y sesiones largas

Uno de los problemas más frecuentes al trabajar con Claude Code en proyectos reales es la degradación del contexto. A medida que la sesión crece, el modelo tiene más información que procesar y las respuestas pueden volverse menos precisas o inconsistentes.

Hay tres estrategias concretas para manejarlo:

1. Usar /compact antes de cambiar de tarea
Cuando se termina una tarea y se va a empezar otra dentro de la misma sesión, /compact condensa lo anterior y libera espacio para el nuevo bloque de trabajo.

2. Dividir el trabajo en sesiones temáticas
En lugar de hacer todo en una sola sesión, es más eficiente abrir sesiones separadas por área: una para el backend, otra para el frontend, otra para los tests. Cada una parte de un contexto limpio y se apoya en el CLAUDE.md para mantener coherencia.

3. Anclar instrucciones con # en el mensaje
Claude Code respeta ciertos marcadores en el texto. Usar # Importante: al inicio de una instrucción aumenta la probabilidad de que esa restricción se respete durante toda la sesión, incluso en contextos largos.

Comandos de sesión en modo headless

Si se usa Claude Code en modo automatizado (con -p), se puede encadenar varios comandos en un script de shell para ejecutar flujos completos sin intervención manual:

#!/bin/bash
claude -p "Analiza el archivo migrations/schema.sql y lista las tablas" --output-format json > tablas.json
claude -p "Genera tests unitarios para el archivo src/auth.js siguiendo las convenciones del proyecto"

Este tipo de uso es especialmente útil en pipelines de revisión de código o generación automatizada de documentación.

Errores comunes al usar Claude Code

Confundir /clear con /compact

En la práctica, muchos usuarios usan /clear cuando el contexto se vuelve lento, pero eso elimina todo el historial. Si hay instrucciones o decisiones importantes tomadas durante la sesión, se pierden. /compact es la opción más segura en la mayoría de los casos.

No usar CLAUDE.md en proyectos con múltiples colaboradores

Si varias personas trabajan con Claude Code sobre el mismo repositorio y cada una configura el agente de forma diferente, los resultados son inconsistentes. El CLAUDE.md debe estar en el repositorio y versionado con el código, igual que cualquier archivo de configuración.

Usar --dangerously-skip-permissions fuera de un entorno aislado

Este flag desactiva todas las confirmaciones. Si se ejecuta en un directorio de producción o en una máquina con datos reales, el agente puede modificar o eliminar archivos sin ningún aviso. Solo se debe usar dentro de contenedores o máquinas virtuales sin acceso a recursos críticos.

Ignorar el flag --verbose al depurar

Cuando Claude Code hace algo inesperado, el instinto es reescribir el prompt. Pero muchas veces el problema está en cómo el agente interpreta el contexto. --verbose muestra el razonamiento interno y permite identificar dónde se produce la desviación.

No revisar el costo con /cost en sesiones largas

Si se trabaja con la API de Anthropic directamente, las sesiones largas con muchos archivos de contexto pueden consumir muchos tokens. Revisar /cost periódicamente evita sorpresas en la factura.

Por qué el entorno donde ejecutas Claude Code importa tanto como los comandos

Conocer los comandos es solo una parte. El otro factor determinante es el entorno donde corre el agente.

Claude Code funciona mejor cuando tiene acceso estable al sistema de archivos, conexión a internet sin restricciones y recursos suficientes (RAM y CPU) para manejar proyectos de cierto tamaño. En una máquina local con otros procesos corriendo en paralelo, el rendimiento puede verse afectado.

Por eso muchos desarrolladores optan por ejecutarlo en un servidor VPS dedicado. Un entorno limpio, con los recursos configurados específicamente para el agente, elimina las variables que pueden degradar el rendimiento o interrumpir una sesión larga.

Para este tipo de uso, el hosting VPS de Neolo es una opción concreta: permite configurar el entorno exactamente como se necesita, con acceso root completo, sin los límites de un hosting compartido. Neolo opera con servidores en múltiples regiones y lleva más de 20 años en el mercado, lo que se traduce en infraestructura estable para cargas de trabajo continuas.

Si el tema del entorno te resulta nuevo, el artículo sobre por qué Claude Code necesita un hosting VPS explica la lógica técnica detrás de esta decisión.

Cursor vs Claude Code

Lo que dicen los clientes de Neolo

★★★★★ Matias
«Es la única empresa que supo resolver todos los problemas que tenía con el hosting. Soporte constante y super profesional.»

★★★★★ Aec Cordoba
«La respuesta de soporte técnico fue excelente y nos permitió solucionar el problema de manera rápida.»

★★★★★ Alejandro Belmonte
«Cliente desde 2006. Siempre me brindaron muy buen servicio, con atención y respuesta rápida.»

Preguntas frecuentes

¿Cuál es la diferencia entre /clear y /compact en Claude Code?

/clear elimina todo el historial de la sesión actual, dejando el contexto completamente vacío. /compact condensa el historial en un resumen más corto, conservando la información esencial pero reduciendo el uso de tokens. En sesiones de trabajo activas, /compact es la opción más segura.

¿El archivo CLAUDE.md se aplica a todos los proyectos o solo al actual?

El CLAUDE.md es específico del directorio donde se encuentra. Claude Code lo lee automáticamente si existe en la raíz del proyecto. También se puede tener un archivo global en el directorio home (~/.claude/CLAUDE.md) para instrucciones que apliquen a todos los proyectos.

¿Puedo usar Claude Code de forma automatizada sin intervención manual?

Sí. El flag -p (o --print) activa el modo no interactivo, donde el agente recibe un prompt y devuelve la respuesta sin esperar input del usuario. Combinado con --output-format json, se puede integrar en scripts de shell, pipelines de CI/CD o herramientas de automatización.

¿Qué hace exactamente el flag --verbose?

Muestra el proceso de razonamiento interno del agente: qué herramientas está considerando usar, cómo interpreta el contexto y por qué toma ciertas decisiones. Es muy útil para depurar comportamientos inesperados o entender por qué el agente no sigue una instrucción de la forma esperada.

¿Es seguro usar --dangerously-skip-permissions?

Solo en entornos completamente controlados, como contenedores Docker o máquinas virtuales sin datos de producción. Este flag desactiva todas las confirmaciones antes de acciones que modifican el sistema de archivos. En cualquier otro contexto, representa un riesgo real de pérdida de datos.

¿Los comandos slash funcionan igual en todas las versiones de Claude Code?

No necesariamente. Anthropic actualiza Claude Code con frecuencia y algunos comandos se agregan, modifican o eliminan entre versiones. Se recomienda ejecutar /help después de cada actualización para verificar qué comandos están disponibles en la versión instalada.

¿Cómo se relacionan los prompts bien escritos con los comandos de Claude Code?

Los comandos controlan el comportamiento del agente, pero la calidad de los resultados también depende de cómo se formulan las instrucciones. Un buen punto de partida para combinar ambas cosas es revisar los mejores prompts para Claude Code.

Conclusión

Claude Code tiene una profundidad que va mucho más allá de escribir instrucciones en lenguaje natural. Los comandos slash permiten controlar el contexto y la memoria del agente. Los flags de línea de comandos abren la puerta a la automatización y la integración en flujos de trabajo más complejos. Y el archivo CLAUDE.md convierte cada proyecto en un entorno con memoria persistente.

Dominar estas herramientas no requiere ser un experto en IA. Requiere entender para qué sirve cada comando y cuándo aplicarlo. Con eso, el tiempo que se pierde repitiendo contexto, corrigiendo comportamientos inesperados o gestionando sesiones largas se reduce de forma considerable.

Si además quieres ejecutar Claude Code en un entorno estable y con recursos dedicados, el hosting VPS de Neolo ofrece una infraestructura confiable, con soporte técnico que responde el 80% de las consultas en menos de una hora y garantía de reembolso de 30 días si el servicio no cumple las expectativas.