🤖 CLI y configuración

Las tres formas de instalar Claude Code: npm, Homebrew y winget.

Sin una instalación correcta, nada más funciona.

Node.js 18+; npm global install; autenticación con API key.

Ejecutar el comando claude por primera vez y entender lo que aparece.

El primer paso real. Sin él, lo demás es teoría.

Interfaz interactiva; prompt de Claude; respuesta en línea.

claude (interactivo) vs claude -p "pregunta" (one-shot, sin sesión).

Saber cuándo usar cada modo ahorra tiempo y contexto.

Modo interactivo = conversación; flag -p = one-shot; pipes con -p.

Los flags que usarás todos los días: --help, --version, -p, --model, --verbose.

Conocer las flags evita perderse en Google.

--help como referencia rápida; flags más usadas.

Cómo actualizar Claude Code y verificar la versión instalada.

Las nuevas versiones incluyen funciones y correcciones importantes.

npm update -g; changelog; cambios incompatibles.

Los errores más comunes durante la instalación y cómo resolver cada uno.

Saber resolver errores evita que te bloquees al principio.

EACCES permission; Node version mismatch; auth errors.

Los atajos de teclado de Claude Code: Escape, Tab, Ctrl+C y más.

Los atajos ahorran clics y mantienen el foco en la terminal.

Escape para cancelar; Tab para aceptar; Ctrl+C para interrumpir.

Comandos con barra dentro de la sesión interactiva de Claude Code.

Son el panel de control dentro de la conversación.

/help; /clear; /model; /memory; /resume; /compact.

Qué modelo se ejecuta detrás de Claude Code y cómo funciona el contexto.

Entender el modelo ayuda a calibrar las expectativas y los costos.

Opus/Sonnet; ventana de contexto; presupuesto de tokens.

Las sesiones persisten entre ejecuciones. /resume retoma la conversación anterior.

No perder el contexto de trabajo al cerrar la terminal.

Session ID; /resume; flag --resume; selector de sesiones.

Claude Code lee imágenes del filesystem y analiza capturas de pantalla.

Debug visual, reproducir diseños, leer diagramas.

Arrastrar y soltar; pegar una captura de pantalla; referencia mediante path.

Usar claude -p con pipes de Unix: | jq, | grep, > archivo.

La integración nativa con el ecosistema Unix multiplica el poder.

Stdout; --output-format json; piping con jq; scripts wrapper.

Un archivo Markdown que Claude Code lee automáticamente en cada sesión.

Es la única forma de darle al agente contexto persistente sobre tu proyecto.

System prompt; instrucciones persistentes; contexto del proyecto.

~/.claude/CLAUDE.md (global) > ./CLAUDE.md (proyecto) > subdir/CLAUDE.md (carpeta).

Cada nivel resuelve un problema de alcance diferente.

Cascada de instrucciones; herencia; override por nivel.

Cómo escribir CLAUDE.md para que el modelo realmente lo siga.

Un CLAUDE.md mal redactado se ignora; uno bueno lo cambia todo.

Encabezados claros; listas; ejemplos; tono imperativo.

Qué tipos de instrucciones realmente cambian el comportamiento del agente.

Menos instrucciones acertadas > muchas instrucciones vagas.

Stack; convenciones; prohibiciones; patrones del proyecto.

Ejemplos comentados de CLAUDE.md de proyectos reales.

Ver ejemplos reales acorta la curva de aprendizaje.

Patrones comunes; antipatrones; tamaño ideal.

CLAUDE.md debe evolucionar junto con el proyecto e ir en git.

Un CLAUDE.md desactualizado es peor que no tener ninguno.

Hacer commit en el repo; revisar mensualmente; /memory como complemento.

El archivo JSON que controla el comportamiento global y por proyecto.

Sin settings.json, te quedas con los defaults genéricos.

~/.claude/settings.json; .claude/settings.json; combinación de configuraciones.

Archivo que indica a Claude Code qué archivos/carpetas debe ignorar.

Protege secretos, reduce el contexto innecesario y acelera al agente.

Sintaxis glob; .env; node_modules; build artifacts.

Definir qué herramientas puede usar Claude Code sin pedir permiso.

Equilibrar la seguridad con la productividad.

allowedTools; deniedTools; solicitudes de permiso; niveles de confianza.

Variables de entorno que Claude Code reconoce: ANTHROPIC_API_KEY, CLAUDE_MODEL, etc.

Configuración por entorno sin tocar archivos.

ANTHROPIC_API_KEY; CLAUDE_MODEL; .env local.

Diferentes configuraciones para distintos proyectos/contextos.

Un proyecto personal y uno corporativo tienen necesidades diferentes.

Settings local vs global; herencia de configuraciones.

Cómo usar --model, /model y proveedores alternativos (Bedrock, Vertex).

Flexibilidad para usar el modelo adecuado en cada tarea.

--model flag; CLAUDE_MODEL; Bedrock; Vertex AI.

Claude Code no tiene memoria mágica. Todo vive en la ventana de contexto de la sesión.

Entender el modelo mental evita frustraciones con «se olvidó».

Context window = memoria de trabajo; CLAUDE.md = memoria persistente.

/memory guarda notas persistentes que Claude Code lee en cada sesión futura.

Es la forma rápida de enseñar preferencias sin editar CLAUDE.md.

/memory; CLAUDE.md generado; ~/.claude/CLAUDE.md.

La ventana de contexto tiene un límite fijo (200k tokens). Todo compite por espacio.

Cuando el contexto se llena, baja la calidad de las respuestas.

Tokens; límite de contexto; degradación gradual.

Claude Code resume automáticamente la conversación cuando se llena el contexto.

Compaction hace perder detalles. Saber cuándo ocurrirá te ayuda a prepararte.

/compact manual; auto-compaction; qué se pierde.

Estrategias para transferir contexto de una sesión a otra.

Las sesiones largas se degradan. Saber cómo dividirlas mantiene la calidad alta.

/resume; resumen manual; CLAUDE.md como handoff.

Técnicas para guardar el estado del trabajo antes de que se llene el contexto.

Los puntos de control evitan perder el progreso en tareas largas.

Commits de Git como checkpoint; notas en CLAUDE.md; archivos TODO.

Aliases de shell que acortan los comandos frecuentes de Claude Code.

Cada segundo ahorrado se multiplica por cientos de usos.

alias cc='claude'; alias ccr='claude --resume'; .bashrc/.zshrc.

Scripts de shell que combinan claude -p con otras herramientas.

Los scripts wrapper automatizan tareas repetitivas con IA.

Scripts wrapper; entrada mediante pipe; análisis de la salida.

Usar Claude Code dentro del terminal de VS Code y con la extensión oficial.

VS Code es el editor más usado. Una buena integración maximiza la productividad.

Terminal integrado; extensión Claude Code; lado a lado.

Usar tmux o screen para ejecutar Claude Code en sesiones persistentes.

Las sesiones sobreviven a las desconexiones y permiten varios agentes.

tmux new-session; paneles lado a lado; detach/attach.

Mantener las configuraciones de Claude Code en archivos dotfiles versionados.

Setup reproducible en cualquier máquina nueva.

Repositorio de dotfiles; symlinks; script de bootstrap.

La configuración completa que combina todo: aliases + tmux + VS Code + dotfiles.

Una referencia concreta de cómo encaja todo.

Flujo integrado; ritmo diario; evolución incremental.