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

# CLI

> Instale la CLI de MKA1 Code, abra sesiones interactivas y ejecute tareas desde scripts.

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>

La CLI de MKA1 Code ejecuta el agente de programación en su terminal. Su ejecutable es `mka1-code`; la [CLI de la MKA1 API](/es/docs/cli/introduction) utiliza `mka1` para llamar a operaciones de la API.

## Instale la CLI

En macOS, Linux o WSL, ejecute el script de instalación en un terminal:

```bash Bash theme={null}
curl -fsSL https://downloads.mka1.com/code/install.sh | bash
```

El script elige el build para su procesador, verifica su checksum e instala `mka1-code` en `~/.local/bin` sin `sudo`. No modifica la configuración de su shell. Si esa carpeta no está en su `PATH`, el script muestra una línea `export PATH` que debe añadir al archivo de inicio de su shell, como `~/.zshrc` para Zsh o `~/.bashrc` para Bash.

Abra un nuevo terminal y compruebe que la CLI se ejecuta:

```bash CLI theme={null}
mka1-code --version
```

Para actualizar la CLI, vuelva a ejecutar el script de instalación. Para instalarla en otra carpeta, defina `MKA1_INSTALL_DIR`:

```bash Bash theme={null}
curl -fsSL https://downloads.mka1.com/code/install.sh | MKA1_INSTALL_DIR="$HOME/bin" bash
```

### Instale un paquete descargado

En Windows, o para instalar la distribución de su organización, descargue el paquete de CLI e instálelo usted mismo. Para una distribución de su organización, siga los [pasos de descarga de la organización](/es/docs/mka1-code/install#distribuciones-de-organizaciones) y elija el paquete de CLI. En los demás casos, descargue el paquete para su sistema operativo y procesador. Estos enlaces corresponden a MKA1 Code 1.57.4.

| Plataforma | Descargar |
| - | - |
| macOS · Apple silicon | [Descargar CLI](https://downloads.mka1.com/code/v1.57.4/mka1-code-cli-1.57.4-darwin-arm64) |
| macOS · Intel | [Descargar CLI](https://downloads.mka1.com/code/v1.57.4/mka1-code-cli-1.57.4-darwin-x64) |
| Windows · x64 | [Descargar CLI](https://downloads.mka1.com/code/v1.57.4/mka1-code-cli-1.57.4-win32-x64.exe) |
| Linux · ARM64 | [Descargar CLI](https://downloads.mka1.com/code/v1.57.4/mka1-code-cli-1.57.4-linux-arm64) |
| Linux · x64 | [Descargar CLI](https://downloads.mka1.com/code/v1.57.4/mka1-code-cli-1.57.4-linux-x64) |

<Tabs>
  <Tab title="macOS / Linux">
    Abra un terminal en la carpeta del ejecutable descargado. Sustituya `<downloaded-file>` por el nombre exacto y copie el archivo a un directorio de comandos de su usuario:

    ```bash CLI theme={null}
    mkdir -p "$HOME/.local/bin"
    cp "<downloaded-file>" "$HOME/.local/bin/mka1-code"
    chmod +x "$HOME/.local/bin/mka1-code"
    export PATH="$HOME/.local/bin:$PATH"
    mka1-code --help
    ```

    El último comando debe mostrar la ayuda de la CLI. `export` solo afecta al terminal actual. Para usar la CLI en nuevos terminales, añada la misma línea `export PATH` al archivo de inicio de su shell, como `~/.zshrc` para Zsh o `~/.bashrc` para Bash.
  </Tab>

  <Tab title="Windows">
    1. Cree una carpeta para la CLI, como `%LOCALAPPDATA%\MKA1Code\bin`.
    2. Mueva el ejecutable descargado a esa carpeta y renómbrelo como `mka1-code.exe`.
    3. Añada la carpeta a la variable de entorno `Path` de su usuario y abra una nueva ventana de PowerShell.
    4. Ejecute `mka1-code --help`. Debe mostrar la ayuda de la CLI. Si no se encuentra el comando, compruebe que `Path` contiene la carpeta, no la ruta completa del ejecutable.
  </Tab>
</Tabs>

## Inicie sesión y empiece a trabajar

Tras instalar el ejecutable, abra un terminal en el directorio del proyecto, inicie sesión y abra una sesión interactiva:

```bash CLI theme={null}
mka1-code login
mka1-code doctor
mka1-code
```

Revise los resultados individuales de `doctor` antes de empezar. Identifica problemas de cuenta, catálogo de modelos, entorno de ejecución y conectores.

Describa la tarea en el terminal, siga el progreso y responda a las preguntas o solicitudes de aprobación. Use `/model` para seleccionar un modelo, `@` para referenciar archivos del proyecto, `/attach <ruta>` para adjuntar una imagen y `/sessions` para encontrar trabajos anteriores. Use `/help` para ver los comandos interactivos disponibles.

Para reanudar el trabajo, busque su identificador con `/sessions` y páselo a `--resume`:

```bash CLI theme={null}
mka1-code --resume <id-de-sesion>
```

<Frame caption="La salida de /help enumera comandos para agentes, acceso a la cuenta, consumo, plugins y diagnóstico.">
  <ScreenshotCrop src="/images/mka1-code/guides/cli.jpg" alt="Ayuda de la CLI con los comandos disponibles" width={1265} height={712} x={30} y={50} cropWidth={900} cropHeight={360} maxWidth="100%" />
</Frame>

## Ejecute una tarea desde un script

Para ejecutar una sola tarea, use `run`:

```bash CLI theme={null}
mka1-code run "Lea README.md e identifique cómo ejecutar este proyecto y sus pruebas. No modifique archivos."
```

Añada `--output-format json` cuando otro programa necesite consumir el resultado. La CLI devuelve un objeto de resultado cuando termina la ejecución:

```bash CLI theme={null}
mka1-code run --output-format json "Lea checkout.js y explique cómo afectan las cantidades de los artículos al total. No modifique archivos."
```

Una ejecución no interactiva no puede responder a preguntas ni solicitudes de aprobación. La CLI rechaza las solicitudes que requieren esa interacción en lugar de esperar indefinidamente. Use una sesión interactiva para tareas que necesitan sus decisiones. Los scripts deben comprobar el estado del resultado y el código de salida antes de considerar que la tarea terminó correctamente.

## Busque modelos y sesiones anteriores

Fuera de la interfaz interactiva, use:

```bash CLI theme={null}
mka1-code whoami
mka1-code models --refresh
mka1-code sessions
```

`whoami` identifica la cuenta activa. `models --refresh` actualiza el catálogo. `sessions` lista sesiones recientes; añada `--all` para incluir antiguas o `--json` para salida estructurada. Use el ID mostrado con `--resume` para continuar la conversación correcta.

En modo interactivo, `/plan` controla la planificación y `/permissions` la política de aprobación. `/compact` resume historial y `/usage` muestra consumo. `Ctrl + C` detiene el turno activo; si no hay uno, la CLI pregunta si desea salir. `/exit` cierra la interfaz.

## Elija el formato de salida

| Formato | Comportamiento | Uso |
| - | - | - |
| `text` | Imprime la respuesta como texto. | Leer el resultado en el terminal. |
| `json` | Escribe un objeto al terminar. | Procesar una tarea completada. |
| `stream-json` | Emite un registro JSON por línea durante la ejecución y un resultado final. | Seguir el progreso desde otro programa. |

Los errores de diagnóstico van a la salida de error estándar. Sepárelos de la salida estructurada en scripts. Una respuesta final no prueba que las pruebas hayan pasado: examine el estado y el resultado del comando.

Para un prompt en un archivo, use la entrada estándar:

```bash CLI theme={null}
mka1-code run - < task.txt
```

Incluya en `task.txt` la solicitud completa, los supuestos del proyecto y la salida esperada. Ejecute desde el directorio del proyecto.

Continúe con [Consumo y solución de problemas](/es/docs/mka1-code/troubleshooting).