$ man how-to/claude-code-quickstart

Claude Code es un agente AI basado en terminal. Sin GUI. Sin editor. Solo tu terminal y Claude. Escribes una tarea, Claude lee tus archivos, escribe codigo, ejecuta comandos y construye cosas. Vive en tu terminal junto a git, npm y todas las demas herramientas CLI que usas. La ventaja sobre un agente basado en IDE: Claude Code opera a nivel de repo. No esta limitado a un solo archivo o una sola pestana del editor. Ve todo tu proyecto y trabaja entre archivos de forma natural. La desventaja: sin editor visual, sin diffs inline, sin clic para aceptar. Todo sucede a traves de texto. Para algunos flujos de trabajo, eso es una caracteristica. Para otros, quieres el IDE. Por eso existe Claude Code dentro de Cursor.

CODE

Instala Claude Code globalmente via npm: npm install -g @anthropic-ai/claude-code Si recibes errores de permisos en Mac, corrige la propiedad primero: sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} Despues ejecuta la instalacion de nuevo sin sudo. Tras la instalacion, ejecuta hash -r para limpiar la cache del shell, o abre una nueva terminal. Verifica con: claude --version. En el primer inicio, Claude Code te pedira autenticarte con tu cuenta de Anthropic. Sigue el flujo del navegador. Una vez autenticado, estas listo. Navega a cualquier carpeta de proyecto y escribe claude para iniciar una sesion.

PATTERN

Navega a tu carpeta de proyecto. Escribe claude. Ahora estas en una sesion interactiva. Claude puede ver cada archivo en el directorio actual y subdirectorios. Prueba: "Lee el README y resume de que trata este proyecto." Claude leera el archivo y te dara un resumen. Eso verifica que puede ver tu proyecto. Prueba: "Crea un script de Python llamado hello.py que imprima la fecha y hora actual." Claude creara el archivo y escribira el codigo. Puedes ejecutarlo con python hello.py. Prueba: "Que archivos hay en este proyecto y como estan organizados?" Claude escaneara el arbol de directorios y describira la estructura. Esto es util cuando estas explorando una base de codigo desconocida. El modelo de interaccion: describes la intencion, Claude ejecuta. Revisas la salida, Claude ajusta. Cada tarea construye sobre el contexto de la sesion.

PRO TIP

Crea un archivo CLAUDE.md en la raiz de tu proyecto. Claude Code lee este archivo al inicio de cada sesion. Pon tus valores predeterminados de entorno aqui: OS, shell, lenguajes principales, reglas de gestion de paquetes, preferencias de estilo de codigo. Mantenlo corto. Menos de 50 lineas. Todo en CLAUDE.md consume espacio de la ventana de contexto durante toda la sesion. Tambien puedes crear un ~/.claude/CLAUDE.md para valores predeterminados globales que apliquen a cada proyecto. CLAUDE.md a nivel de proyecto sobreescribe la configuracion global. Esto te permite establecer preferencias universales (valores predeterminados de lenguaje, reglas de git) globalmente mientras mantienes configuraciones especificas del proyecto en cada repo.

PATTERN

Presiona Shift+Tab en una sesion de Claude Code para alternar entre modo de planificacion y modo de ejecucion. El modo de planificacion es de solo lectura. Claude explora, lee archivos y mapea pasos sin cambiar nada. El modo de ejecucion es donde Claude realmente escribe archivos y ejecuta comandos. El flujo de trabajo: comienza en modo de planificacion para tareas complejas. Deja que Claude analice la base de codigo, identifique los archivos involucrados y proponga un plan paso a paso. Revisa el plan. Si se ve bien, cambia al modo de ejecucion y dile a Claude que proceda. Si se ve mal, ajusta el plan antes de que se escriba cualquier codigo. Esta es la caracteristica mas subutilizada de Claude Code. La gente salta directamente a la ejecucion y se pregunta por que Claude hace suposiciones erroneas. El modo de planificacion previene esas suposiciones al forzar la exploracion antes de la accion.