> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sesiones y contexto del proyecto

> Añada archivos, oriente tareas activas, encuentre trabajos anteriores y consulte el contexto.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

Una sesión de Code conserva la conversación, los resultados de las herramientas y el entorno seleccionado. Úsela para investigar un problema, orientar una tarea activa y retomarla más adelante. Empiece por el [inicio rápido](/es/docs/mka1-code/first-task) si aún no ha ejecutado una sesión.

## Inicie y organice una sesión

Abra **Code → New session**, elija una carpeta y compruebe la rama, el modelo y los permisos antes del primer mensaje. Ese mensaje vincula el entorno a la sesión. Para trabajar en otro entorno de ejecución, cree una sesión y elija primero el destino.

Dedique cada sesión a un propósito concreto, como investigar una prueba de checkout o revisar un cambio de API. Use el menú de la sesión para renombrarla, fijar trabajo frecuente o archivar lo terminado. Las sesiones archivadas siguen en **Archived**. Eliminar una sesión local borra su historial guardado en este equipo; lea la confirmación antes de continuar.

Una conversación nueva no crea otra copia del repositorio. Si dos tareas necesitan editarlo de forma independiente, use [worktrees separados](/es/docs/mka1-code/workspaces).

## Añada contexto del proyecto

Mencione las rutas de archivos con `@` o adjunte la salida de la prueba fallida. El campo de mensaje permite seleccionar archivos, arrastrarlos y soltarlos o pegar adjuntos, incluidas especificaciones y capturas de pantalla. Para enviar imágenes, elija un modelo que admita ese tipo de entrada.

### Formule una solicitud verificable

Incluya el comportamiento observado, el esperado y cómo comprobar el resultado. Los nombres de archivos y la salida del error permiten empezar por el código relevante:

> El checkout devuelve 12 para tres artículos de precio 12. Lea @checkout.js y @checkout.test.js. Añada una prueba que falle al esperar un total de 36, corrija el cálculo y ejecute npm test. Conserve la firma pública de la función.

Seleccione el elemento correcto en las sugerencias de `@` antes de enviar. Adjunte un diseño o una captura cuando importe la apariencia y explique qué parte debe examinarse. Algunos formatos de documento requieren una skill; la aplicación avisa si está inactiva.

Para una captura, abra **Mark up the image** en la miniatura y señale el control o la región relevante. Revise la imagen y elija **Apply**. La imagen marcada sustituye el anexo de ese mensaje.

## Siga una tarea en ejecución

La cronología registra las respuestas del agente y la actividad de las herramientas durante la tarea. Cada tarjeta muestra una acción y su resultado: lectura de un archivo, ejecución de un comando o respuesta de un servicio conectado. En el ejemplo de la compra, examine primero el fallo de la prueba y compárelo con el resultado después de cambiar el cálculo. Pulse una tarjeta para expandir el comando y su salida.

Cuando la aplicación solicite aprobación, examine la acción propuesta antes de aprobarla o rechazarla. Responda a las preguntas del agente en la sesión y envíe nuevas instrucciones si necesita cambiar el rumbo de la tarea.

El envío de mensajes durante una ejecución sigue **Settings → Composer → A message typed during a run**. **Queue** guarda el mensaje hasta que termine la ejecución. **Interrupt** lo entrega en la siguiente interacción con el modelo, lo que permite cambiar la próxima acción del agente. Para detener la ejecución activa, elija **Cancel run**.

### Ponga en cola, reoriente o detenga

Use **Queue** para un mensaje que dependa del resultado actual, como pedir un resumen al terminar las pruebas. Use **Interrupt** para cambiar la próxima acción, por ejemplo al corregir un archivo o reducir el alcance. La interrupción se entrega en el siguiente turno del modelo; examine la cronología para ver qué se ha ejecutado.

Cancelar detiene el turno activo. Revise después **Session changes** para ver qué ediciones permanecen y decidir cómo continuar. Cancelar no revierte los archivos mediante Git.

## Vuelva a un trabajo anterior

Para volver a un trabajo anterior, use **Search sessions** y busque una sesión por su nombre o por el texto de la conversación. Selecciónela para reabrirla y continuar con su entorno guardado. Use **Search this session** para encontrar un resultado dentro de un historial largo.

### Revise una decisión anterior

Fije un mensaje útil y abra **Pinned** para encontrarlo después. Cuando **Branch from here** esté disponible, úselo para explorar otro enfoque en una conversación separada. Esto bifurca la discusión; use también una rama Git o un worktree si necesita separar los archivos.

**Restart from this message** y **Edit and restart from here** sustituyen la conversación posterior. La confirmación puede ofrecer restaurar archivos modificados desde ese punto. Revise la lista: conservar una transcripción, sustituir mensajes y restaurar archivos son operaciones distintas.

<Frame caption="La búsqueda encuentra sesiones anteriores para retomar la conversación y consultar sus resultados.">
  <ScreenshotCrop src="/images/mka1-code/guides/sessions.jpg" alt="Resultados de búsqueda de sesiones del ejemplo del carrito" width={2720} height={1660} x={875} y={616} cropWidth={970} cropHeight={395} maxWidth="100%" />
</Frame>

## Comprenda el uso del contexto

El indicador de contexto muestra cuánto se utiliza de la ventana de contexto del modelo. Cuando **Compact session** está disponible, resume el historial anterior para liberar espacio; la transcripción original permanece en la sesión. Abra el indicador para consultar los detalles. Los totales de solicitudes y tokens del gateway aparecen por separado en [Consumo](/es/docs/mka1-code/troubleshooting).

## Use el chat junto con la programación

Cambie a **Chat** para discutir un enfoque o pedir una explicación a un modelo. Use **Code** para trabajar en un proyecto seleccionado con herramientas de archivos y comandos. En Chat, las respuestas aparecen a medida que se generan y el historial se guarda localmente. Puede renombrar conversaciones, detener una respuesta o volver a generar la última respuesta.

Chat y Code admiten dictado. Grabe su solicitud con el micrófono junto al campo de mensaje y revise la transcripción antes de enviarla.

Continúe con [Planificación y permisos](/es/docs/mka1-code/permissions).