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

# Instalación

> Instale la aplicación de escritorio, conecte la cuenta y compruebe el gateway y los modelos disponibles.

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>
  La interfaz de MKA1 Code está disponible en inglés y portugués de Brasil. Esta guía conserva los nombres de controles en inglés para que pueda localizarlos en la aplicación.
</Note>

Necesita una cuenta o clave API para el gateway MKA1 de su organización. El paquete de escritorio incluye el entorno de ejecución del agente; no necesita instalar la CLI ni compilar la aplicación desde el código fuente.

Antes de descargar, compruebe si su organización exige una distribución propia. Si es así, use ese paquete; en caso contrario, use las descargas públicas siguientes. Necesitará acceso de red al gateway y una cuenta o clave API autorizada. La lista de modelos depende de ese acceso.

La aplicación incluye el entorno de ejecución del agente, pero no instala las herramientas del proyecto. Por ejemplo, un proyecto JavaScript puede necesitar Node.js y sus dependencias para ejecutar pruebas. Puede instalar la aplicación y conectar su cuenta antes de preparar un proyecto.

<span id="descargue-el-instalador" />

## 1. Descargue

Descargue el instalador de escritorio para su sistema operativo y procesador. Estos enlaces corresponden a MKA1 Code 1.57.4.

| Plataforma | Descargar |
| - | - |
| macOS · Apple silicon | [Descargar DMG](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-arm64.dmg) |
| macOS · Intel | [Descargar DMG](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-x64.dmg) |
| Windows · x64 | [Descargar EXE](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-x64-setup.exe) |
| Linux · ARM64 | [Descargar AppImage](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-arm64.AppImage) |
| Linux · x64 | [Descargar AppImage](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-x86_64.AppImage) |

El [manifiesto de la versión pública](https://downloads.mka1.com/code/latest/manifest.json) enumera la versión publicada y las sumas de verificación de los paquetes.

En macOS, abra **Acerca de este Mac** para comprobar si el equipo tiene un chip Apple o un procesador Intel. Las descargas para Windows admiten x64. En Linux, elija ARM64 para un procesador ARM o x64 para uno x86-64. El paquete debe corresponder al equipo donde se ejecutará la aplicación de escritorio.

### Distribuciones de organizaciones

Si su organización proporciona una distribución con su marca o exige una versión específica, use sus paquetes:

1. Abra [Aplicaciones en la consola MKA1](https://platform.mka1.com/downloads) e inicie sesión. Si su organización utiliza otra dirección para la consola, ábrala y seleccione **Aplicaciones** al final de la barra lateral.
2. Seleccione su organización. Su distribución puede tener otro nombre y logotipo.
3. En la tarjeta de descarga de la aplicación, use **Plataforma** para seleccionar el sistema operativo y el procesador.
4. Elija **Descargar** junto a **Aplicación de escritorio**. Para las otras interfaces, elija el paquete de la extensión de VS Code o de la CLI.

Si la distribución que exige su organización no aparece o no está disponible para su plataforma, solicite al administrador el instalador y acceso al gateway.

<span id="instale-la-aplicación-de-escritorio" />

## 2. Instale

<Tabs>
  <Tab title="macOS">
    1. Abra el archivo `.dmg` descargado.
    2. Arrastre la aplicación a **Aplicaciones** y espere a que termine la copia.
    3. Expulse la imagen de disco y abra la aplicación instalada desde **Aplicaciones**. Ejecute la copia instalada, no la que está dentro de la imagen de disco.
    4. Continúe con **Conecte su cuenta** más abajo.
  </Tab>

  <Tab title="Windows">
    1. Abra el instalador `x64-setup.exe` descargado.
    2. Siga las instrucciones hasta que termine la instalación.
    3. Abra la aplicación instalada desde el menú **Inicio**.
    4. Continúe con **Conecte su cuenta** más abajo.
  </Tab>

  <Tab title="Linux">
    1. Guarde el `.AppImage` descargado en la carpeta donde quiera conservar la aplicación.
    2. Abra un terminal en esa carpeta. Sustituya `<application>.AppImage` por el nombre exacto del archivo descargado y ejecute estos comandos para hacerlo ejecutable y abrirlo:

    ```bash Bash theme={null}
    chmod +x "<application>.AppImage"
    ./"<application>.AppImage"
    ```

    3. Conserve el AppImage en una carpeta con permiso de escritura para que la aplicación pueda actualizarlo.
    4. Continúe con **Conecte su cuenta** más abajo.
  </Tab>
</Tabs>

Si el sistema operativo bloquea el instalador o la aplicación, solicite al administrador el procedimiento de instalación de su organización.

<span id="conecte-su-cuenta" />

## 3. Conecte su cuenta

El inicio de sesión se abre en el navegador. El código que muestra la aplicación identifica la solicitud de autorización que debe confirmar:

1. Inicie el proceso de acceso. La aplicación muestra un código de autorización y abre el navegador.
2. En el navegador, acceda con la cuenta de su organización. Compruebe que el navegador y la aplicación muestran el mismo código antes de aprobar el acceso. Mientras espera, puede copiar el código o volver a abrir la página de autorización desde la aplicación.
3. Vuelva a la aplicación cuando termine la autorización. Consulte el selector de modelos para ver cuáles están disponibles a través de su gateway.

Si su organización le proporciona una clave API, abra **Settings → Access**, seleccione **API key**, introduzca la clave y elija **Use API key**. La aplicación la valida antes de activarla. Las funciones que requieren la identidad de la cuenta, incluida la [memoria del proyecto](/es/docs/mka1-code/memory), siguen requiriendo iniciar sesión con una cuenta.

<Frame caption="Elija el inicio de sesión con cuenta o una clave de API en Settings → Access.">
  <ScreenshotCrop src="/images/mka1-code/guides/install.jpg" alt="Opciones de cuenta y clave de API en los ajustes de acceso" width={2720} height={1660} x={1030} y={30} cropWidth={1080} cropHeight={340} maxWidth="100%" />
</Frame>

### Elija un modelo

Abra el selector y elija un modelo disponible a través del gateway. Para consultar código mediante texto, use uno que su organización recomiende para programación. Si adjuntará capturas, elija un modelo que admita imágenes. Un selector vacío indica un problema de conexión o catálogo que debe resolver antes de empezar; no indica que el proyecto local esté vacío.

Si regresa a la aplicación tras iniciar sesión y no aparecen modelos, compruebe la conexión como se explica a continuación. Si la autorización caducó, solicite otro código y repita el proceso. Consulte [Consumo y solución de problemas](/es/docs/mka1-code/troubleshooting) para los pasos de recuperación.

### Compruebe la conexión

En **Settings → Connection**, use la URL del gateway proporcionada por el administrador. Con una credencial activa, elija **Test connection** para comprobar el acceso y los modelos disponibles. La prueba no guarda los cambios; elija **Save** para aplicarlos. Cambiar el origen del servidor elimina la credencial activa, por lo que debe volver a autenticarse después de guardar.

También puede elegir idioma y tema en **Settings**.

En las sesiones locales, el agente y las herramientas del proyecto se ejecutan en su ordenador. En las sesiones remotas, se ejecutan en el entorno seleccionado. Los prompts, el contenido relevante de los archivos y los resultados de las herramientas se envían al gateway MKA1 configurado como contexto para las solicitudes al modelo.

### Verifique la instalación

Después de iniciar sesión, compruebe que el selector muestra los modelos de su gateway. Abra un proyecto local en **Code** y envíe una solicitud cuyo resultado pueda comprobar, como:

> Lea README.md y explique qué hace este proyecto. No modifique archivos.

Si el proyecto no tiene `README.md`, indique otro archivo de texto que contenga. Compruebe que llega una respuesta y examine el resultado de la lectura del archivo en la cronología.

Para ejecutar comandos del proyecto, instale sus dependencias habituales y las herramientas de compilación o pruebas. Git es necesario para utilizar ramas, worktrees y commits. En sesiones remotas, estas herramientas deben estar instaladas en el entorno seleccionado.

Continúe con [Inicio rápido](/es/docs/mka1-code/first-task).