> ## 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.

# Inicio rápido

> Lea un proyecto, reproduzca un error de checkout, verifique la corrección y prepare la revisión.

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>;

<Note>
  Este recorrido empieza con una pregunta de solo lectura y sigue un error de cantidades mediante una prueba de regresión, una corrección y una revisión Git. Use la muestra ejecutable o adapte los archivos y comandos a su repositorio. La respuesta y secuencia de herramientas pueden variar; compruebe los resultados reales.
</Note>

La aplicación de escritorio funciona en macOS, Windows y Linux. **Code** abre una sesión vinculada a una carpeta de proyecto y a un entorno de ejecución, con herramientas de archivos y comandos disponibles para el agente. **Chat** abre una conversación con un modelo. Cada sesión de Code conserva su propio historial para que pueda consultar la investigación y los resultados de las herramientas más adelante.

## Antes de empezar

[Instale la aplicación de escritorio y conecte su cuenta](/es/docs/mka1-code/install). Elija un proyecto con las dependencias y herramientas de pruebas ya instaladas. Use un proyecto local para este recorrido.

<Note>
  Este recorrido empieza con una pregunta de solo lectura y sigue un error de cantidades mediante una prueba de regresión, una corrección y una revisión Git. Use la muestra ejecutable o adapte los archivos y comandos a su repositorio. La respuesta y secuencia de herramientas pueden variar; compruebe los resultados reales.
</Note>

## Prepare un ejemplo pequeño

Use su repositorio o cree una carpeta vacía `checkout-example` con estos tres archivos. La muestra usa el ejecutor de pruebas integrado de Node.js y no necesita paquetes externos. El cálculo ignora deliberadamente la cantidad para seguir un fallo real hasta su corrección.

<Accordion title="Archivos del proyecto de ejemplo">
  <CodeGroup>
    ```json package.json theme={null}
    {
      "name": "checkout-example",
      "private": true,
      "type": "module",
      "scripts": {
        "test": "node --test"
      }
    }
    ```

    ```js checkout.js theme={null}
    export function calculateTotal(items) {
      return items.reduce((total, item) => total + item.price, 0);
    }
    ```

    ```js checkout.test.js theme={null}
    import test from 'node:test';
    import assert from 'node:assert/strict';
    import { calculateTotal } from './checkout.js';

    test('one unit costs 12', () => {
      assert.equal(calculateTotal([{ price: 12, quantity: 1 }]), 12);
    });
    ```
  </CodeGroup>
</Accordion>

En un terminal abierto en esa carpeta, ejecute:

```bash Bash theme={null}
npm test
```

La prueba inicial debe pasar porque solo cubre una unidad. Cree un `README.md` con «Este ejemplo calcula totales de checkout. Ejecute npm test para ejecutar las pruebas». La primera solicitud lo utiliza. Para revisar con Git, inicialice la carpeta como repositorio y cree un commit con los archivos iniciales, o use un repositorio existente cuyo diff pueda revisar.

Esta muestra mínima no tiene página web. La verificación en el navegador de las otras guías se aplica a su propio proyecto web.

## Elija el proyecto y el modelo

Una sesión de Code necesita una carpeta de proyecto, un modelo y un modo de permisos. La carpeta determina el proyecto en el que trabaja el agente; el gateway proporciona los modelos disponibles; el modo de permisos determina cómo se gestionan las solicitudes de aprobación de las herramientas.

1. Abra una nueva sesión de **Code** y elija la carpeta del proyecto. Para un repositorio Git, seleccione la rama o [cree un worktree separado](/es/docs/mka1-code/workspaces) para la tarea.
2. Elija un modelo en el selector. Los modelos disponibles proceden del gateway configurado.
3. Elija un modo de permisos. Use **Always ask** para una primera tarea si desea revisar las solicitudes para modificar archivos o ejecutar comandos.
4. Describa la tarea y envíe el mensaje. Incluya el resultado esperado y cómo comprobarlo.

Los controles de carpeta, rama y worktree están junto al campo de mensaje. Elija el entorno antes del primer mensaje; una sesión existente conserva su destino de ejecución.

<Frame caption="Elija la carpeta del proyecto y el entorno de ejecución antes de iniciar una sesión.">
  <ScreenshotCrop src="/images/mka1-code/desktop-project.jpg" alt="Selector de proyecto con la carpeta checkout-demo y opciones de ejecución local o remota" width={2720} height={1660} x={975} y={500} cropWidth={685} cropHeight={415} maxWidth={520} />
</Frame>

## Pregunte sobre el proyecto

Empiece con una pregunta cuya respuesta pueda comprobar en el proyecto:

> Lea @README.md e identifique cómo ejecutar este proyecto y sus pruebas. No modifique archivos.

Seleccione `README.md` en las sugerencias de `@` para incluir el archivo en la solicitud. Expanda la tarjeta de lectura del archivo y compare la respuesta con el README. En la muestra, la respuesta debe identificar `npm test` y explicar el cálculo. No debe afirmar haber ejecutado pruebas si la cronología no contiene ese comando y su resultado.

## Reproduzca y corrija un error

A continuación, proporcione un problema reproducible y un resultado esperado:

> El total de la compra ignora las cantidades de los artículos. Añada una prueba de regresión en checkout.test.js para tres unidades de 12 USD cada una: el total esperado es 36 USD. Ejecute npm test para reproducir el fallo, corrija checkout.js y vuelva a ejecutar las pruebas.

La primera ejecución debe mostrar el total incorrecto de `12`; tras la corrección, la misma aserción debe pasar con `36`. Revise la salida de las pruebas antes de aceptar el resumen del agente.

## Compruebe el resultado

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.

<Frame caption="La sesión de ejemplo indica el fallo reproducido, la corrección de cantidades y dos pruebas superadas.">
  <ScreenshotCrop src="/images/mka1-code/guides/quickstart.jpg" alt="Solicitud sobre cantidades del carrito y resumen de las pruebas de regresión" width={2720} height={1660} x={1000} y={120} cropWidth={1160} cropHeight={550} maxWidth="100%" />
</Frame>

## Revise antes del commit

Abra **Session changes** y revise `checkout.js` y `checkout.test.js`. Compruebe que el cálculo multiplica el precio por la cantidad y que la prueba de regresión cubre tres unidades. Expanda el resultado para verificar que ambas pruebas pasaron; después, [revise los cambios y cree el commit](/es/docs/mka1-code/review-changes). Para un proyecto web, también puede [comprobar la página en el navegador](/es/docs/mka1-code/previews).