Guía Claude Code CLI

📥 Instalación

Abre PowerShell y ejecuta este único comando para instalar Claude Code:

# Instalar Claude Code en Windows
irm https://claude.ai/install.ps1 | iexpowershell

Métodos alternativos:

# Con WinGet
winget install Anthropic.ClaudeCode

# Con Homebrew (si lo usas)
brew install --cask claude-code

# Actualizar a la versión más reciente
claude updatepowershell

💻 Comandos desde PowerShell

Estos comandos se escriben directamente en la terminal, antes de iniciar una sesión con Claude.

Ejemplos prácticos

# Navega a tu proyecto primero
cd C:\Users\Humberto.Acosta\Projects\mi-proyecto

# Inicia Claude
claude

# Pregunta rápida sin abrir sesión
claude -p "¿qué hace esta función?"

# Continúa donde lo dejaste ayer
claude -c

# Retoma una sesión específica del historial
claude -rpowershell

⚙ Slash Commands (dentro de Claude)

Estos comandos se escriben cuando Claude ya está corriendo, durante la sesión interactiva.

Navegación y sesión

Código y cambios

Configuración

🏴 Flags y Opciones

Estas opciones se agregan al comando claude al lanzarlo desde PowerShell.

# Tarea compleja con razonamiento profundo
claude --effort high "optimiza estas consultas SQL"

# Usar Opus para tareas muy complejas
claude --model opus "refactoriza toda la capa de autenticación"

# Modo automático (cuidado: aprueba todo sin preguntar)
claude --permission-mode acceptEditspowershell

🏃 Flujo Básico de Trabajo

Así se ve una sesión tipica con Claude Code desde cero:

📄 Trabajar con tu Código

Claude Code lee automáticamente los archivos de tu proyecto. No necesitas subirlos manualmente.

Explorar el proyecto

# Dentro de Claude, escribe en lenguaje natural:
¿qué hace este proyecto?
explica la estructura de carpetas
¿cuáles tecnologías usa?
¿dónde está el punto de entrada principal?claude

Hacer cambios de código

# Claude encuentra el archivo, muestra el cambio y pide aprobación
agrega una función que valide emails en utils.js
crea un componente de botón reutilizable
agrega manejo de errores a todas las llamadas a la APIclaude

Cambios multi-archivo

# Claude coordina cambios en varios archivos automáticamente
agrega validación de inputs al formulario de registro,
actualiza tanto el frontend como el backendclaude

🍀 Git Integration

Puedes pedirle a Claude que haga operaciones de Git en lenguaje natural:

# Ver cambios y estado
¿qué archivos he modificado?
muéstrame los últimos 5 commits

# Commits
haz commit de mis cambios con un mensaje descriptivo

# Branches
crea una nueva rama llamada feature/auth-redesign
cambia a la rama develop

# Revisión de código antes de commit
/code-reviewclaude

🚀 PowerShell Pipes y Automatización

Una de las ventajas del CLI es que puedes encadenar comandos con el pipeline de PowerShell:

# Analizar últimas líneas de un log
Get-Content app.log -Tail 100 | claude -p "que errores hay?"

# Resumir fallos de tests
npm test 2>&1 | claude -p "resume los fallos y sugiere soluciones"

# Generar un README automáticamente
claude -p "genera un README.md para este proyecto" > README.md

# Ejecutar tests y hacer commit si pasan
claude "corre los tests y si pasan haz commit"

# Analizar código específico
Get-Content src/auth.js | claude -p "busca vulnerabilidades de seguridad"powershell

⚖ CLI vs Claude Desktop (GUI)

⚡ Referencia Rápida

Todo lo esencial en un vistazo:

💡 Tips para el Contexto

Claude tiene un límite de contexto (memoria de la sesión). Para proyectos grandes:

Atajos de teclado dentro de Claude