Todo el mundo te dice que uses Claude Code. Pero nadie te explica que si no configuras tres archivos antes de escribir tu primer prompt, vas a desperdiciar tokens, exponer contraseñas y obtener respuestas basura. Lo sé porque cometí esos tres errores.

El 62% de desarrolladores ya usa herramientas de IA en su flujo de trabajo, un salto desde el 44% del año anterior (Stack Overflow Developer Survey). Pero usar IA y dominarla son cosas distintas. Claude Code no es un chatbot — es un agente que ejecuta acciones reales en tu ordenador. Y si no lo configuras bien, te va a pasar factura.

En esta guía vas a aprender los 5 conceptos fundamentales, las 3 configuraciones obligatorias, y cómo conectar Claude con herramientas externas usando MCP servers. Todo basado en cientos de horas de uso real y la documentación oficial de Anthropic.

bolt TL;DR

Claude Code es un agente de IA que ejecuta acciones reales desde tu terminal. Necesitas 3 archivos para dominarlo: `CLAUDE.md` (reglas del proyecto), `settings.json` (permisos y seguridad) y hooks (automatizaciones sin tokens).

¿Qué es Claude Code y por qué no es un chatbot?

Claude Code es la herramienta agéntica de Anthropic que vive en tu terminal. No es una ventana de chat donde preguntas cosas y recibes texto. Es un agente que lee archivos, escribe código, ejecuta comandos y hace commits — todo desde la línea de comandos (Anthropic, 2025).

La instalación ocupa 30 segundos:

bash 
npm install -g @anthropic-ai/claude-code
cd tu-proyecto
claude

Necesitas Node.js 18+ y una cuenta de Claude.ai. Nada más.

¿Qué lo hace diferente? Tres cosas. Primero, no tienes que decirle qué herramienta usar. Le describes tu objetivo y él decide si necesita leer un archivo (read), crearlo (write), editar código (edit) o ejecutar un comando (bash). Segundo, trabaja en tu código real, no en un sandbox aislado. Tercero, se conecta con herramientas externas vía MCP servers — Supabase, Notion, Figma, GitHub, Google Drive...

¿El resultado? En una sesión normal, Claude puede crear un componente React, instalar dependencias, configurar tests y hacer commit — sin que abras un solo archivo. Pero ahí viene el problema: si no configuras los permisos, te va a preguntar antes de cada acción. En un proyecto de 3 horas, eso significa una interrupción cada 10 segundos.

Mi primera semana con Claude Code la pasé aprobando permisos como si fuera un CAPTCHA. Luego configuré settings.json y mi productividad se triplicó. No es exageración — es la diferencia entre usar la herramienta y que la herramienta te use a ti.

Los 5 conceptos que cambian tu productividad con Claude CodeEl 76% de desarrolladores está usando o …