Claude Code funciona distinto a cualquier asistente de IA porque su lógica gira en torno al contexto, no al prompt. Si entiendes cinco conceptos clave (ventana de contexto, subagentes, Model Context Protocol, CLI y context engineering) podrás usarlo con intención, precisión y resultados consistentes desde el primer día.

Esta guía te muestra cómo piensa, cómo recuerda y cómo colabora contigo, sin tecnicismos innecesarios y con ejemplos directos del flujo real de trabajo en terminal.

¿Qué es la ventana de contexto en Claude Code?

La ventana de contexto es la memoria de trabajo de Claude: todo lo que puede procesar y recordar al mismo tiempo, incluyendo tu código, la conversación activa y los resultados que va generando [0:25].

La versión por defecto maneja 200 000 tokens y existe una versión extendida de un millón de tokens, suficiente para analizar proyectos medianos o incluso grandes. Cuando esa memoria se llena, Claude empieza a olvidar lo más antiguo, pero gestiona el espacio automáticamente: limpia lo irrelevante y conserva lo útil.

¿Cómo optimizo la ventana de contexto? Referencia archivos con el símbolo @ en lugar de copiar bloques largos de código. Si notas que Claude olvida una decisión, abre una nueva sesión y vuelve a apuntar a los archivos clave.

Esa práctica mantiene la conversación enfocada y libera tokens para razonamiento real, no para repetir información.

¿Cómo funcionan los subagentes especializados?

Los subagentes son versiones de Claude enfocadas en tareas específicas, como si fueran miembros de tu equipo de desarrollo [1:20]. Cada uno tiene su propio contexto, herramientas y conocimiento técnico, y trabajan sin saturar la sesión principal.

• Arquitecto: analiza la estructura general del sistema.
• Backend: implementa endpoints y APIs.
• Frontend: construye los componentes de interfaz.
• QA: valida la calidad final del entregable.

Invocas al que necesites según la tarea. Mientras trabajan en paralelo, mantienen contextos separados, así que el flujo se vuelve modular y se parece mucho a coordinar un equipo real.

¿Qué es el Model Context Protocol (MCP)?

El Model Context Protocol es el sistema que permite a Claude Code conectarse con herramientas externas más allá de tu código [2:15]. Gracias al MCP, Claude no solo lee archivos: accede a bases de datos, ejecuta pruebas automatizadas, revisa issues en GitHub o interactúa con servicios como Figma o Zapier.

En la práctica, puedes pedirle que corra pruebas en Playwright desde la conversación, que revise un pull request o que consulte una API sin salir de la terminal. Configuras cada conexión una vez y desde ese momento cualquier miembro del equipo la usa conversacionalmente.

¿Para qué sirve el MCP en el día a día? Convierte a Claude Code en un puente entre tu proyecto y tu ecosistema de herramientas. Lo que antes requería abrir cinco pestañas, ahora ocurre en una sola conversación.

¿Por qué Claude Code vive en la CLI?

Claude Code no tiene interfaz gráfica: vive en la terminal, el mismo lugar donde ya usas Git, Docker o npm [3:10]. Esa es su ventaja, no una limitación.

Usa comandos del sistema con el prefijo !. Claude no te dice qué deberías ejecutar, lo ejecuta, analiza los resultados y te ayuda a interpretarlos. Eso mantiene tu flujo limpio y dividido en tres espacios claros:

• Terminal para conversar con Claude.
• Editor para escribir código.
• Navegador para validar resultados.

Menos cambios de contexto, menos fricción y un ciclo de iteración mucho más rápido que con asistentes basados en chat aislado.

¿Qué es el context engineering y por qué reemplaza al prompting?

Claude Code no necesita prompts perfectos, necesita un contexto útil donde pueda razonar con precisión [4:05]. A esa práctica se le llama context engineering: diseñar el entorno de información, no redactar instrucciones rebuscadas.

Una instrucción vaga como "ayúdame con el código" genera ruido. Una instrucción con contexto produce resultados precisos. Para lograrlo:

• Referencia archivos con @ en lugar de pegar código.
• Explica el propósito real de la tarea.
• Indica qué patrón seguir o evitar.
• Mantén la conversación limpia de información innecesaria.

¿Cuál es la diferencia entre prompting y context engineering? El prompting busca la frase mágica. El context engineering construye un espacio de pensamiento compartido con la IA, donde cada decisión tiene la información que necesita para tener sentido.

El poder de Claude Code no está en escribir más líneas de código, sino en pensar dentro del contexto correcto. Cuéntame en los comentarios cuál de estos cinco conceptos vas a aplicar primero en tu proyecto.