CursosBlogClaude WebinarIniciar sesión
Inicio

Comandos CLI Básicos - El Punto de Entrada

Capítulo 4: Comandos CLI Básicos - El Punto de Entrada

La Revolución de la Interfaz de Terminal

Los comandos CLI de Claude Code representan tu primera interacción con esta nueva forma de desarrollo conversacional. No son simplemente otra herramienta de línea de comandos; son la puerta de entrada a un ecosistema donde la intención se traduce directamente en acción, donde la complejidad se abstrae sin sacrificar control, y donde la productividad se amplifica attraverso de la inteligencia contextual.

Esta revolución comienza en el lugar más familiar para cualquier desarrollador: la terminal. Desde ahí, Claude Code extiende naturalmente tu flujo de trabajo existente, integrándose seamlessly con tus herramientas actuales mientras introduce capacidades que transforman fundamentalmente cómo abordas los problemas de desarrollo.

La maestría de los comandos CLI no radica en memorizar flags y opciones, sino en desarrollar una comprensión intuitiva de cuándo y cómo usar cada modalidad de interacción para maximizar tu efectividad según el contexto específico de cada situación.

El Comando Base: claude

Entrada al Mundo Conversacional

El comando claude sin argumentos es la puerta más directa al desarrollo conversacional. Te lleva al modo interactivo donde puedes mantener diálogos extendidos, explorar problemas complejos paso a paso, y recibir asistencia contextual que evoluciona con tu trabajo.

1claude
2# Inicia modo interactivo completo
3

Esta simplicidad esconde una sofisticación profunda. El modo interactivo mantiene contexto de proyecto, aprende de tus patrones de trabajo, y se adapta a tu estilo específico de desarrollo. No es un simple prompt; es un colaborador inteligente que comprende tu proyecto y puede razonar sobre él de manera sofisticada.

Consultas Directas y Análisis Puntuales

Para tareas específicas que no requieren sesión extendida, puedes expresar tu intención directamente como argumento:

1claude "analiza la estructura de este proyecto React y sugiere mejoras arquitectónicas"
2claude "¿qué tecnologías usa este repositorio y cómo están organizadas?"
3claude "revisa el código en src/ y identifica posibles problemas de rendimiento"
4claude "explica qué hace esta función y cómo podría optimizarse"
5

Esta modalidad es invaluable para:

  • Análisis rápidos: Evaluación inmediata de código o arquitectura
  • Consultas específicas: Preguntas que pueden resolverse en una interacción
  • Integración con scripts: Incorporación en workflows automatizados
  • Verificaciones puntuales: Validación rápida de approaches o decisiones

Flags de Control Fundamental

--print / -p: Scripting y Automatización

La flag --print transforma Claude Code en una poderosa herramienta de scripting que puede integrarse en pipelines, workflows de CI/CD, y scripts de automatización:

1# Análisis para scripting
2claude -p "genera un resumen de los cambios en el último commit"
3claude --print "verifica que todos los tests pasen y reporta cualquier fallo"
4claude -p "evalúa la complejidad de este módulo en escala 1-10"
5
6# Integración en pipelines
7ANALYSIS=$(claude -p "analiza la calidad del código y dame un score numérico")
8if [[ $ANALYSIS =~ "score: [89]|score: 10" ]]; then
9    echo "✅ Código aprobado para merge"
10else
11    echo "❌ Código requiere mejoras antes del merge"
12    exit 1
13fi
14
15# Generación de reports
16claude -p "genera reporte de cobertura de tests en formato JSON" > coverage-report.json
17

Características Clave:

  • Output limpio: Solo la respuesta, sin interfaz interactiva
  • Scriptable: Perfecto para capturar output en variables
  • CI/CD friendly: Ideal para integraciones automatizadas
  • Format agnóstico: Puede generar cualquier formato requerido

--continue / -c: Continuidad de Contexto

Una de las capacidades más poderosas: reanudar conversaciones previas con todo el contexto intact:

1claude --continue
2# Reanuda la conversación más reciente
3
4claude -c  
5# Forma abreviada del comando anterior
6

Potencia de la Continuidad:

  • Memoria de proyecto: Recuerda análisis previos y decisiones tomadas
  • Contexto evolutivo: Entiende cómo ha cambiado tu proyecto over time
  • Workflows extendidos: Permite tareas que se desarrollan a lo largo de múltiples sesiones
  • Aprendizaje acumulativo: Cada sesión informa las siguientes

Casos de Uso Típicos:

1# Sesión 1: Análisis inicial
2claude "analiza la arquitectura de este proyecto de e-commerce"
3
4# Sesión 2: Continuación al día siguiente  
5claude -c "basándote en el análisis de ayer, implementa optimizaciones de performance"
6
7# Sesión 3: Una semana después
8claude -c "¿cómo han afectado los cambios recientes a las optimizaciones que implementamos?"
9

--model: Selección Estratégica de Capacidades

Diferentes modelos ofrecen diferentes balances entre velocidad, profundidad, y especialización:

1claude --model sonnet-3.5 "análisis arquitectónico profundo de este sistema complejo"
2claude --model haiku-3 "verificación rápida de sintaxis en este archivo"
3claude --model opus-3 "revisión exhaustiva de seguridad y code review completo"
4

Estrategias de Selección:

  • Sonnet: Balance óptimo para la mayoría de tareas de desarrollo
  • Haiku: Respuestas rápidas para consultas simples y verificaciones
  • Opus: Análisis profundos y tareas que requieren razonamiento complejo

--add-dir: Expansión de Contexto

Para proyectos que abarcan múltiples directorios o cuando necesitas incluir contexto específico:

1claude --add-dir /path/to/frontend --add-dir /path/to/backend "analiza la integración completa"
2claude --add-dir ./docs --add-dir ./tests "verifica que la documentación esté actualizada con los tests"
3

Esta capacidad es crucial para:

  • Proyectos monorepo: Analizando múltiples packages simultáneamente
  • Arquitecturas distribuidas: Frontend, backend, y servicios relacionados
  • Context expansion: Incluyendo documentación, tests, o configuraciones específicas

--output-format: Control de Formato

Diferentes formatos para diferentes necesidades de integración:

1# JSON estructurado para processing programático
2claude --output-format json "analiza este código y estructura la respuesta"
3
4# Text plano para legibilidad humana
5claude --output-format text "dame un resumen simple de los cambios"  
6
7# Streaming JSON para resultados en tiempo real
8claude --output-format stream-json "análisis detallado con resultados progresivos"
9

Aplicaciones por Formato:

  • JSON: Integración con otras herramientas, processing automatizado
  • Text: Output limpio para usuarios, documentación
  • Stream-JSON: Interfaces en tiempo real, feedback progresivo

Comandos de Mantenimiento y Configuración

claude update: Evolución Continua

1claude update
2# Actualiza a la versión más reciente con nuevas capacidades
3

Mantener Claude Code actualizado es crucial porque:

  • Nuevos modelos: Acceso a capacidades mejoradas
  • Bug fixes: Resolución de problemas conocidos
  • Features: Nuevas funcionalidades y integraciones
  • Performance: Optimizaciones de velocidad y eficiencia

claude mcp: Gestión de Integraciones

1claude mcp
2# Accede al sistema de configuración de Model Context Protocol
3

MCP permite integraciones sofisticadas con:

  • Servicios externos: APIs, databases, herramientas especializadas
  • Custom tools: Herramientas desarrolladas específicamente para tu workflow
  • Team integrations: Servicios compartidos del equipo

Patrones de Uso Efectivo

Workflows Cotidianos

1# Inicio del día: Context refresh
2claude -c "¿en qué estábamos trabajando y cuáles son los próximos pasos?"
3
4# Análisis rápido antes de empezar trabajo
5claude "revisa el estado actual del proyecto y sugiere prioridades para hoy"
6
7# Verificación antes de commit
8claude -p "revisa estos cambios y verifica que estén listos para commit" | tee commit-review.txt
9
10# End of day: Progress summary
11claude "resume el progreso de hoy y prepara context para mañana"
12

Integración con Git Workflows

1# Pre-commit analysis
2claude -p "analiza los archivos en staging, busca problemas potenciales"
3
4# Commit message generation  
5COMMIT_MSG=$(claude -p "genera un mensaje de commit descriptivo para estos cambios")
6git commit -m "$COMMIT_MSG"
7
8# Post-merge analysis
9claude "analiza el resultado del merge y identifica potential integration issues"
10

Debugging y Troubleshooting

1# Error analysis
2claude "analiza este error y sugiere soluciones: $(cat error.log)"
3
4# Performance investigation
5claude --model sonnet-3.5 "investiga estos performance issues en detalle" --add-dir ./profiling
6
7# Verbose diagnostic mode  
8claude --verbose "¿por qué está fallando este deployment?" > diagnostic-report.md
9

Combinando Comandos para Workflows Sofisticados

Pipeline de Code Review

1#!/bin/bash
2# Comprehensive code review pipeline
3
4echo "🔍 Iniciando review automatizado..."
5
6# Quick syntax and style check
7claude -p "verificación rápida de sintaxis y estilo" --model haiku-3
8
9# Deep architectural analysis  
10claude -p "análisis arquitectónico profundo" --model sonnet-3.5 > arch-review.md
11
12# Security audit
13claude -p "audit de seguridad exhaustivo" --model opus-3 > security-review.md
14
15# Generate summary report
16claude -p "consolida estos reports en un summary ejecutivo" \
17  --add-dir ./arch-review.md --add-dir ./security-review.md > final-review.md
18
19echo "✅ Review completo disponible en final-review.md"
20

Development Session Orchestration

1# Smart development session startup
2function dev-session() {
3    local project_context=$(claude -c "resume el contexto actual del proyecto")
4    echo "📋 Context: $project_context"
5    
6    local priorities=$(claude -p "basándote en el estado actual, ¿cuáles son las 3 prioridades principales para hoy?")
7    echo "🎯 Prioridades: $priorities"
8    
9    # Start interactive session with full context
10    claude -c
11}
12

Best Practices para CLI Usage

Context Management

1# Establish rich context at session start
2claude "# PROYECTO: E-commerce Platform
3Stack: React 18, Node.js, MongoDB, Stripe
4Estado actual: Implementando checkout flow
5Constraints: Must maintain PCI compliance"
6
7# Maintain context continuity
8claude --continue "continuando con checkout implementation..."
9

Performance Optimization

1# Use appropriate model for task complexity
2claude --model haiku-3 "simple syntax check"           # Fast
3claude --model sonnet-3.5 "architectural analysis"     # Balanced  
4claude --model opus-3 "comprehensive security audit"   # Thorough
5

Output Management

1# Structured output for further processing
2claude -p --output-format json "analiza dependencies y list outdated packages" | jq '.packages[]'
3
4# Clean text for documentation
5claude -p --output-format text "genera user documentation para esta API" > api-docs.md
6

El Futuro de la CLI Conversacional

Evolución de las Interfaces

Los comandos CLI de Claude Code representan la primera generación de interfaces conversacionales para desarrollo. Las futuras evoluciones probablemente incluirán:

  • Predictive commands: Sugerencias automáticas basadas en context y patterns
  • Cross-session intelligence: Memory persistente que evoluciona con tu proyecto
  • Adaptive interfaces: CLI que se adapta a tu estilo específico de trabajo
  • Integrated workflows: Coordination seamless con todas las herramientas de desarrollo

Preparándose para el Futuro

La maestría de los comandos CLI actuales proporciona la foundation para aprovechar futuras capabilities. Los principios fundamentales—expresión clara de intenciones, context management efectivo, y integration thoughtful con workflows existentes—permanecerán relevantes incluso mientras las interfaces específicas evolucionan.

Dominando la Base

Los comandos CLI de Claude Code son tu foundation para todo lo que sigue. No son simplemente una forma de invocar funcionalidades; son la interface fundamental entre tu intención y la ejecución inteligente. Dominar estos comandos significa desarrollar intuición sobre cuándo usar cada modalidad, cómo combinarlas efectivamente, y cómo integrarlas seamlessly en tu workflow de desarrollo actual.

Cada comando CLI que hemos explorado aquí se convierte en más poderoso cuando se combina con los slash commands que exploraremos en el próximo capítulo, donde descubrirás cómo controlar granularmente el comportamiento de Claude Code durante sesiones interactivas.

La CLI de Claude Code no es solo una herramienta; es el primer paso hacia un new paradigm de desarrollo donde la conversación con sistemas inteligentes se convierte en parte natural del creative process.