Primeros Pasos con Claude Code
Que Es Claude Code
Claude Code es la interfaz de linea de comandos oficial de Anthropic, potenciada por inteligencia artificial y disenada para ingenieria de software. Se ejecuta directamente en tu terminal y se conecta a los modelos de frontera de Claude para ayudarte a leer, escribir y refactorizar codigo, ejecutar comandos de shell, gestionar flujos de trabajo con git y orquestar cambios complejos en multiples archivos a lo largo de toda tu base de codigo. A diferencia de los asistentes de IA basados en navegador donde copias y pegas fragmentos de ida y vuelta, Claude Code opera de forma nativa dentro del directorio de tu proyecto. Ve tu arbol de archivos, comprende la estructura de tu proyecto y puede ejecutar comandos reales con consecuencias reales.
Piensa en el como un ingeniero senior sentado en tu terminal que puede leer cada archivo de tu proyecto, ejecutar tu suite de tests, buscar en documentacion y hacer ediciones precisas -- todo mientras te pide permiso antes de hacer cualquier cosa destructiva.
Instalacion
Claude Code requiere Node.js version 18 o superior. Si no tienes Node.js instalado, descargalo de nodejs.org o usa un gestor de versiones como nvm. Una vez que Node.js este listo, instala Claude Code de forma global:
npm install -g @anthropic-ai/claude-code
Verifica la instalacion:
claude --version
Tambien necesitaras una clave API de Anthropic. Configurala como variable de entorno o deja que Claude Code te la solicite en el primer inicio:
export ANTHROPIC_API_KEY=sk-ant-tu-clave-aqui
En Windows, usa las variables de entorno del sistema o configurala en el perfil de tu shell. Claude Code tambien soporta Amazon Bedrock y Google Vertex AI como proveedores de modelos alternativos si tu organizacion lo requiere.
Tu Primer Inicio
Navega a cualquier directorio de proyecto y escribe:
claude
Esto inicia una sesion REPL interactiva. Claude carga contexto sobre tu proyecto -- leyendo tu arbol de archivos, cualquier archivo CLAUDE.md y la configuracion relevante -- y luego espera tus instrucciones. Veras un prompt donde puedes escribir solicitudes en lenguaje natural.
Para consultas puntuales sin entrar en modo interactivo, usa el modo de impresion:
claude -p "Explica que hace este proyecto basandote en el README y package.json"
El modo de impresion envia tu prompt, obtiene una respuesta y sale. Es perfecto para scripting y consultas rapidas.
Entendiendo la Interfaz
Cuando interactuas con Claude Code, notaras varios elementos distintos en la salida. Las llamadas a herramientas aparecen cuando Claude decide usar una capacidad -- leer un archivo, ejecutar un comando, escribir codigo. Cada llamada a herramienta se muestra con lo que esta haciendo y su resultado. Los prompts de permiso aparecen antes de acciones potencialmente impactantes. Claude te pedira que apruebes escrituras de archivos, ejecucion de comandos y otras operaciones antes de proceder.
Prueba esto como tu primera interaccion:
claude
> Explica la estructura de este proyecto y lista los puntos de entrada principales
Claude usara herramientas de lectura de archivos para escanear tu proyecto y luego resumira lo que encuentra. Observa las llamadas a herramientas desplazandose -- cada una te muestra exactamente lo que Claude esta haciendo.
Flags Clave de Linea de Comandos
Claude Code acepta varias flags que controlan su comportamiento:
# Usar un modelo especifico
claude --model claude-sonnet-4-20250514
# Establecer modo de permisos (mas detalles abajo)
claude --permission-mode acceptEdits
# Obtener salida JSON estructurada (util para scripting)
claude -p "Lista todos los comentarios TODO" --output-format json
# Limitar el numero de turnos agentivos
claude --max-turns 10
# Reanudar la sesion mas reciente
claude --resume
# Continuar desde una sesion especifica
claude --resume <session-id>
La flag --output-format json es especialmente util cuando canalizas Claude Code hacia otras herramientas. Devuelve datos estructurados que puedes analizar con jq o alimentar a scripts posteriores.
Tus Primeras Tareas Reales
Comienza con tareas de solo lectura y bajo riesgo para familiarizarte:
# Explicar un archivo especifico
claude -p "Explica que hace src/utils/auth.ts, funcion por funcion"
# Buscar bugs
claude -p "Revisa src/api/handlers.py en busca de posibles bugs o casos limite"
# Generar un componente
claude
> Crea un componente React llamado UserAvatar que reciba las props name e imageUrl,
> muestre la imagen en un circulo, y use las iniciales como fallback si no hay imagen
Para tu primera operacion de escritura, intenta algo pequeno y reversible:
claude
> Agrega comentarios JSDoc a todas las funciones exportadas en src/utils/helpers.ts
Claude te mostrara los cambios propuestos, pedira permiso para escribir el archivo y los aplicara solo despues de que apruebes.
El Sistema de Permisos
El sistema de permisos es la caracteristica de seguridad mas importante de Claude Code. Por defecto, Claude pide tu aprobacion explicita antes de escribir archivos, ejecutar comandos de shell o realizar cualquier accion que modifique tu sistema. Esto es intencional -- siempre deberias entender lo que Claude esta a punto de hacer antes de que lo haga.
Cuando Claude quiere ejecutar un comando o escribir un archivo, veras un prompt como:
Claude wants to run: npm test
Allow? (y/n/always)
Elegir "y" lo permite una vez. Elegir "always" le dice a Claude que puede ejecutar ese tipo especifico de comando sin preguntar de nuevo por el resto de la sesion.
Modos de Permisos
Claude Code proporciona seis modos de permisos que controlan cuanta autonomia tiene Claude. Elige el que coincida con tu nivel de confianza:
default -- Claude pide permiso para todo. Escrituras de archivos, comandos de shell, solicitudes web -- todo requiere aprobacion. Este es el modo mas seguro y donde cada nuevo usuario deberia comenzar.
acceptEdits -- Claude puede escribir y editar archivos libremente pero aun pregunta antes de ejecutar comandos de shell. Este es el punto ideal para la mayoria de los desarrolladores una vez que confias en la salida de codigo de Claude.
plan -- Claude crea un plan detallado y pide aprobacion antes de ejecutar. Util para tareas complejas donde quieres revisar el enfoque antes de que comience cualquier trabajo.
auto -- Claude ejecuta la mayoria de operaciones sin preguntar. Aun respeta una lista configurable de comandos peligrosos denegados. Usa esto para tareas confiables y bien definidas.
dontAsk -- Similar a auto pero con aun menos prompts. Disenado para entornos headless y CI/CD.
bypassPermissions -- Sin verificaciones de permisos en absoluto. Solo usa esto en entornos completamente aislados como contenedores o VMs desechables.
Prueba esto para ver los modos de permisos en accion:
# Iniciar con modo acceptEdits
claude --permission-mode acceptEdits
> Refactoriza el manejo de errores en src/api/routes.ts para usar un manejador de errores centralizado
Notaras que Claude edita archivos sin preguntar pero aun te solicita confirmacion antes de ejecutar cualquier comando.
Canalizando Entrada a Claude
Claude Code funciona bien en pipelines estilo Unix. Puedes canalizar contenido de archivos, salida de comandos o cualquier texto directamente a Claude:
# Canalizar un archivo para analisis
cat src/config.ts | claude -p "Hay algun problema de seguridad en esta configuracion?"
# Canalizar git diff para revision
git diff HEAD~3 | claude -p "Resume estos cambios y senala cualquier cosa riesgosa"
# Canalizar salida de tests para diagnostico
npm test 2>&1 | claude -p "Analiza estos fallos de tests y sugiere correcciones"
Este patron es poderoso para integrar Claude Code en scripts de shell existentes y flujos de trabajo de automatizacion.
Consejos Practicos para Principiantes
Comienza cada nuevo proyecto ejecutando claude en la raiz del proyecto y pidiendo a Claude que explique la estructura del proyecto. Esto construye el contexto de Claude y te da una orientacion rapida.
Usa el modo de permisos default durante tu primera semana. Una vez que desarrolles una idea de lo que Claude hace bien, cambia a acceptEdits para iterar mas rapido. Reserva el modo auto para tareas que ya hayas ejecutado antes y en las que confies completamente.
Si Claude comete un error, siempre puedes deshacerlo. Claude Code crea commits convencionales de git, asi que git diff y git checkout son tu red de seguridad. Asegurate de que tu trabajo este commiteado antes de iniciar tareas de refactorizacion grandes.
Ejecuta /cost periodicamente para ver cuantos tokens y cuanto dinero ha consumido tu sesion. Esto te ayuda a desarrollar intuicion sobre que tareas son baratas y cuales son costosas.
Finalmente, se especifico en tus prompts. En lugar de "arregla los bugs," intenta "arregla la excepcion de puntero nulo en la funcion handleUserLogin en src/auth/login.ts que ocurre cuando el objeto usuario no tiene campo email." La especificidad reduce turnos desperdiciados y te da mejores resultados mas rapido.