¿Por qué conocer los comandos nativos?
La mayoría de los desarrolladores que empezaron a utilizar Claude Code hicieron lo mismo: abrir la terminal, escribirclaudey empezar a hablar en lenguaje natural. Funciona. Pero ¿qué pasa con cómo usarlo?Código VSsin conocer ningún atajo de teclado: puedes trabajar, pero estás utilizando el 30% del potencial.
El Código Claude tiene un conjunto decomandos nativos(accesible con/) que controlan el comportamiento, optimizan el rendimiento, reducen costos y automatizan los flujos de trabajo. Conociendolos y la diferencia entre usar Claude Code como chatbot y usarlo comoherramienta de desarrollo profesional.
En esta guía, cubriremos los 10 comandos más útiles, con explicaciones de lo que hacen, cuándo usarlos y ejemplos prácticos con resultados reales. Al final, aprenderá a crear sus propios comandos personalizados.
Muestra la lista completa de comandos disponibles, incluidos los comandos de barra diagonal personalizados del proyecto.
Cuando usar:Siempre que olvide un comando o quiera ver qué comandos de barra diagonal personalizados están disponibles en el proyecto actual.
claude > /help Available commands: /help Show this help message /clear Clear conversation history /compact Compact conversation context /cost Show token usage and cost /doctor Check Claude Code health /init Initialize project with CLAUDE.md /config Open configuration /review Review code changes /pr-comments Show PR comments /login Authenticate with Anthropic /logout Sign out /quit Exit Claude Code Project commands: /deploy Custom: deploy to production /test-all Custom: run full test suite
Tenga en cuenta que en el resultado anterior, los dos últimos comandos (/deploy e /test-all) ellos soncomandos de barra personalizados- creado específicamente para ese proyecto. Hablaremos más sobre esto en el comando 10.
Crear (o actualizar) el archivoCLAUDE.mden la raíz del proyecto. Este archivo funciona como un "manual de instrucciones" que Claude Code lee automáticamente al iniciar una sesión en el directorio.
Cuando usar:La primera vez que utilizas Claude Code en un proyecto. También cuando desee actualizar las instrucciones del proyecto (por ejemplo, cambiar los estándares del código, agregar reglas).
claude > /init I'll analyze your project structure and create a CLAUDE.md file. Analyzing... - Detected: TypeScript + React project - Package manager: pnpm - Test framework: Vitest - Linting: ESLint + Prettier Created CLAUDE.md with: - Project overview and architecture - Code style guidelines - Test conventions - Build and deploy commands
O CLAUDE.mdy una de las funciones más potentes de Claude Code. Le permite definir reglas persistentes: "usar siempre comillas simples", "las pruebas deben estar en __tests__/", "nunca usar ninguna en TypeScript". Claude sigue estas instrucciones en todas las interacciones dentro de ese proyecto.
Puedes editar CLAUDE.md manualmente en cualquier momento. Piensa en ello como el.editorconfigde Claude Code, pero mucho más potente porque acepta instrucciones en lenguaje natural.
Diagnostica problemas de configuración y entorno. Comprueba la autenticación, la versión, la conexión API y los permisos.
Cuando usar:Cuando algo no funciona como se esperaba. Error de autenticación, respuestas lentas, comportamiento inesperado.
claude > /doctor Claude Code Diagnostics ======================= Version: 1.0.12 (latest) Authentication: OK (API key valid) Model access: claude-sonnet-4 (default) claude-opus-4 (available) Connection: OK (latency: 142ms) Node.js: v22.4.0 OS: macOS 15.3 Shell: /bin/zsh Project: /Users/dev/my-app CLAUDE.md: Found (1.2KB) Permissions: Read/Write/Execute OK All checks passed.
O /doctory el primer comando que se ejecuta cuando algo sale mal. Identifica rápidamente si el problema está relacionado con la autenticación, la red, la versión o la configuración, lo que ahorra tiempo de depuración manual.
Muestra el consumo de tokens y el costo estimado de la sesión actual. Imprescindible para quienes utilizan la API y quieren controlar los gastos.
Cuando usar:Periódicamente durante largas sesiones. Especialmente antes de solicitar tareas que involucren muchos archivos (refactorizar un proyecto completo, por ejemplo).
claude > /cost Session Cost Summary ==================== Messages: 14 Input tokens: 48,230 Output tokens: 12,845 Cache read: 125,400 Cache write: 48,230 Estimated cost: $0.42 Model: claude-sonnet-4
Dos consejos importantes sobre el costo:
- Fichas de cachéSon significativamente más baratos que los tokens normales. Claude Code utiliza el almacenamiento en caché de manera agresiva; es por eso que la segunda pregunta sobre el mismo código es más barata que la primera.
- Utilice Sonnet para tareas rutinariasy cambia a Opus sólo cuando necesites un razonamiento más profundo. La diferencia de costos es sustancial.
Comprime el historial de conversaciones, resumiendo mensajes anteriores para liberar espacio en la ventana contextual. Mantenga lo esencial y descarte los detalles redundantes.
Cuando usar:Cuando la conversación es larga y notas que Claude se "olvida" de instrucciones anteriores, o cuando quieres reducir costes en sesiones largas.
claude > /compact Compacting conversation... Before: 156,240 tokens After: 34,520 tokens (78% reduction) Summary preserved: - Project context and CLAUDE.md rules - Key decisions made in this session - Current task state and progress - File modifications tracking
O /compacty uno de los comandos más subestimados. En sesiones de desarrollo largas (más de 2 horas), la ventana de contexto se llena y el costo por mensaje aumenta. La compresión periódica mantiene la calidad de las respuestas y reduce los costos.
También puedes pasar una instrucción:/compact foque nas decisoes de arquitetura e ignore os detalhes de CSS-- de esta manera el resumen prioriza lo que es importante para la siguiente etapa del trabajo.
¿Quieres dominar esto más rápido?
Todo lo que estás aprendiendo aquí se vuelve 10 veces más poderoso con habilidades ya preparadas. En lugar de escribir comandos manualmente, las habilidades hacen el trabajo pesado por usted. Más de 748 habilidades profesionales, se instala en 2 minutos.
Quiero las Habilidades — R$ 19Borra completamente el historial de chat, empezando desde cero. Diferente de/compact, no conserva ningún resumen.
Cuando usar:Cuando terminas una tarea y quieres empezar otra completamente diferente en el mismo proyecto. O cuando el contexto de la conversación quedó "contaminado" con información irrelevante.
claude > /clear Conversation cleared. Note: CLAUDE.md and project context will be reloaded on your next message.
La diferencia entre/compact e /cleare importante:
/compact= "resume lo que hemos hecho hasta ahora" (mantiene el contexto)/clear= "olvídate de todo, empieza de cero" (reinicia la conversación)
Use /clearentre diferentes tareas. Usar/compacten medio de una larga tarea.
Pídale a Claude que revise los cambios de código pendientes (preparados y no preparados en git). Funciona como una revisión de código automatizada.
Cuando usar:Antes de comprometerse. Antes de abrir un PR. Siempre que quieras una segunda opinión sobre los cambios que has realizado.
claude > /review Reviewing changes in 4 files... src/auth/jwt.ts Line 23: Potential security issue - token expiry is set to 30 days. Consider reducing to 24h for access tokens and using refresh tokens. Line 45: Good - proper error handling for invalid tokens. src/auth/middleware.ts Line 12: The catch block swallows the error silently. Add logging or re-throw. src/tests/auth.test.ts Line 8-34: Tests cover happy path but missing: - Expired token test - Malformed token test - Missing header test Summary: 2 issues, 1 suggestion, 1 missing test coverage area.
O /reviewy poderoso porque Claude tiene acceso acontexto completo del proyecto, no solo diferencia. Sabe qué estándares sigue (a través de CLAUDE.md), comprende la arquitectura y puede identificar problemas que un revisor humano apresurado pasaría por alto.
Busque y muestre comentarios de solicitudes de extracción de GitHub. Útil para comprender los comentarios de los revisores y abordarlos sin salir de la terminal.
Cuando usar:Cuando recibes comentarios sobre un PR y quieres resolver todo a través de Claude Code, sin cambiar entre navegador y terminal.
claude > /pr-comments PR #142: Add JWT authentication module Comments (3): @senior-dev (2h ago) on src/auth/jwt.ts:23 "Should we use asymmetric keys (RS256) instead of symmetric (HS256) for better security?" @tech-lead (1h ago) on src/auth/middleware.ts:12 "Add structured logging here. We use pino." @qa-engineer (30m ago) general "Can you add integration tests with the actual auth flow?"
Después de ver los comentarios, puedes pedirle a Claude que los resuelva directamente: "Abordar todos los comentarios del PR #142". Modificará los archivos, agregará pruebas y usted solo necesitará revisar y enviar.
Abra la configuración del Código Claude. Le permite ajustar la plantilla predeterminada, los permisos de las herramientas y las preferencias de comportamiento.
Cuando usar:Para cambiar el modelo predeterminado (Sonnet vs Opus), ajuste los permisos de ejecución de comandos o configure las preferencias globales.
claude > /config Claude Code Configuration ========================= Model: claude-sonnet-4 (default) Theme: dark Auto-compact: after 100K tokens Notification sound: enabled Tool permissions: File read: always allow File write: ask first Shell commands: ask first Git operations: always allow Open settings.json to edit? (y/n)
Una configuración importante:permisos de herramientas. De forma predeterminada, Claude Code solicita confirmación antes de escribir archivos o ejecutar comandos de shell. Puedes configurarlo para permitir siempre (confianza total) o preguntar siempre (control máximo). Ajústelo según su nivel de comodidad.
La característica más poderosa y menos conocida: puedes crear tus propios comandos agregando archivos Markdown a la carpeta.claude/commands/del proyecto.
Cuando usar:Para cualquier tarea que repitas con frecuencia. Implementación, generación de componentes, auditorías, estándares de código, flujos de trabajo específicos del equipo.
# Estrutura de arquivos: .claude/ commands/ deploy.md -> /deploy test-all.md -> /test-all new-component.md -> /new-component audit-security.md -> /audit-security # Conteudo de .claude/commands/deploy.md: Execute o seguinte workflow de deploy: 1. Rode os testes: npm test 2. Se todos passarem, faca build: npm run build 3. Deploy para produdacao: npm run deploy 4. Verifique se o health check responde 200 5. Reporte o status final # Uso: claude > /deploy Executando workflow de deploy... [roda testes - 47 passed] [build - success] [deploy - success] [health check - 200 OK] Deploy concluido com sucesso.
Cada archivo.mden la carpeta.claude/commands/se convierte en un comando de barra diagonal. El nombre del archivo (sin extensión) es el nombre del comando. El contenido del archivo son las instrucciones que Claude seguirá.
Y aquí el concepto dehabilidadesse vuelve transformador. En lugar de crear comandos genéricos, puede tenerInstrucciones profesionales escritas por expertos.que cubren:
- Contexto completo del área (normas, buenas prácticas, errores comunes)
- Plantillas y estructuras predefinidas
- Flujos de trabajo paso a paso con validación
- Criterios de calidad y lista de verificación.
Por ejemplo, una habilidad de “Auditoría SEO” no es simplemente “analizar el SEO de la página”. Contiene las más de 50 comprobaciones que realizaría un experto en SEO, los criterios de puntuación, el formato del informe y las recomendaciones priorizadas por impacto.
Crear habilidades desde cero requiere horas de investigación e iteración. O puede utilizar habilidades profesionales ya preparadas: escritas, probadas y optimizadas para obtener resultados reales.
Consejo adicional: indicadores de línea de comando
Además de los comandos de barra diagonal (utilizados dentro de la sesión interactiva), Claude Code aceptabanderas en la línea de comandocuando empezó:
# Executar um comando unico sem sessao interativa $ claude -p "explica o que esse projeto faz" # Usar um modelo especifico $ claude --model claude-opus-4 # Pipe de entrada (stdin) $ cat error.log | claude -p "analisa esse log e sugere fix" # Continuar ultima conversa $ claude --continue # Retomar uma sessao especifica $ claude --resume
la bandera-p(imprimir) y especialmente útil para integrar Claude Code en scripts y canalizaciones.CI/CD. Puede crear scripts que utilicen Claude para revisar automáticamente el código en cada inserción, por ejemplo.
la bandera--continuereanuda la última conversación donde la dejó, perfecto cuando cierras accidentalmente la terminal o necesitas continuar una tarea al día siguiente.
Siguiente paso: instale skills y vea la diferencia
Ya sabes lo básico. Ahora imagina a Claude Code sabiendo cómo hacer todo esto por sí mismo: SEO, redacción, revisión de código, implementación, análisis de datos. Eso es lo que hacen las habilidades. Acceso de por vida, actualizaciones incluidas.
Ver el Mega Paquete – R$ 19Preguntas frecuentes
Los elementos esenciales para la vida cotidiana son:/init(configurar proyecto),/compact(gestionar contexto),/cost(supervisar gastos),/review(revisión automática de código) y comandos de barra diagonal personalizados para tareas repetitivas. EL/doctorEs esencial cuando algo sale mal.
Crea la carpeta.claude/commands/en la raíz del proyecto. Cada archivo Markdown (.md) en esta carpeta se convierte en un comando de barra diagonal. El nombre del archivo y el nombre del comando (por ejemplo:deploy.md vira /deploy). El contenido del archivo son las instrucciones que sigue Claude al ejecutar el comando.
Muestra tokens de entrada, tokens de salida, tokens de caché (lectura y escritura) y el costo estimado en dólares de la sesión actual. Los valores se basan en los precios de Anthropic API. Útil para quienes usan la API y desean controlar los gastos, especialmente en sesiones largas de refactorización.