Skip to main content
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.
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 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
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:
CLI
Para actualizar la CLI, vuelva a ejecutar el script de instalación. Para instalarla en otra carpeta, defina MKA1_INSTALL_DIR:
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 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.
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:
CLI
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.

​
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:
CLI
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:
CLI

La salida de /help enumera comandos para agentes, acceso a la cuenta, consumo, plugins y diagnóstico.

​
Ejecute una tarea desde un script

Para ejecutar una sola tarea, use run:
CLI
Añada --output-format json cuando otro programa necesite consumir el resultado. La CLI devuelve un objeto de resultado cuando termina la ejecución:
CLI
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:
CLI
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

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:
CLI
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.