Documentación de PIX CLI

Requisitos previos

Antes de instalar PIX CLI, es necesario contar con lo siguiente:

• PIX Studio instalado. Los scripts .pix generados se abren, revisan y ejecutan ahí.
• Conexión a internet activa, necesaria para comunicarse con el modelo de IA durante la generación de scripts.
• Acceso a Claude de Anthropic, mediante una cuenta de Claude (Pro/Max) o una clave de API de la empresa.
• Git instalado en el sistema. Es un requisito del motor de Claude Code que PIX CLI usa internamente.

Instalación

El instalador se descarga desde el portal de PIX Robotics y se ejecuta como cualquier instalador de Windows (PIX-CLI-Setup.exe).

1

Ejecutar el archivo descargado.

Icono del instalador de PIX CLI.

2

En “Seleccione las Tareas Adicionales”, dejar marcadas las opciones recomendadas: “Agregar 'pix' al PATH del sistema” y “Crear un acceso directo en el Escritorio”.

Agregar 'pix' al PATH del sistema es lo que permite ejecutar el comando pix desde cualquier ubicación en la terminal. Se recomienda dejar esta opción activada.

Pantalla de tareas adicionales del instalador.

3

Revisar el resumen en “Listo para Instalar” y hacer clic en “Instalar”.

Resumen previo a la instalación.

4

Esperar a que el instalador extraiga los archivos necesarios.

PIX CLI incluye su propio entorno de Node.js, por lo que no es necesario instalarlo por separado.

Progreso de instalación (extracción de archivos).

5

Al finalizar, la pantalla “Completando la instalación de PIX CLI” confirma que el proceso terminó. Se puede marcar “Abrir PIX CLI ahora” o hacerlo más tarde, y hacer clic en “Finalizar”.

Instalación completada.

Conexión con Claude (inicio de sesión)

PIX CLI necesita una sesión activa con Claude de Anthropic para generar scripts. Existen dos formas de conectarse: con una cuenta de Claude (Pro/Max) o con una clave de API de la empresa. El primer inicio de sesión se realiza desde una terminal (Símbolo del sistema o PowerShell).

Iniciar sesión con pix login

1

Abrir una terminal y ejecutar el comando pix login.

Comando pix login en la terminal.

2

PIX CLI explica que la autenticación se realiza con la cuenta de Claude (Pro/Max) desde el navegador. La primera vez, también solicita confirmar que se confía en la carpeta de trabajo (Quick safety check): seleccionar “Yes, I trust this folder” para continuar.

terminalCopiar

Te vas a autenticar con tu cuenta de Claude (Pro/Max) en el navegador.
Cuando termines de iniciar sesión, escribe /exit para volver. Después abre pix normalmente.

Mensaje de autenticación y verificación de la carpeta de trabajo.

3

Tras confirmar, se inicia una sesión de Claude Code (el motor de IA que usa PIX CLI internamente) y se muestra un mensaje de bienvenida.

4

Una vez que el navegador confirma el inicio de sesión, escribir /exit en esa ventana para cerrar Claude Code y volver a la terminal.

5

Ejecutar pix nuevamente para abrir la interfaz normal de PIX CLI, ya autenticada.

Volver a autenticarse

Este proceso se puede repetir en cualquier momento con el comando /login dentro del chat de PIX CLI, o ejecutando pix login desde la terminal.

Primera navegación: la interfaz de PIX CLI

Al ejecutar pix (ya autenticado), se abre el menú principal. En la parte superior se muestra la versión instalada, el modelo activo (sonnet 4.5), el plan conectado (Claude Pro/Max) y la carpeta de trabajo actual.

Menú principal de PIX CLI (v0.8.0).

Para moverse por el menú se usan las flechas ↑ ↓, Enter para confirmar la opción resaltada, o directamente el número (1, 2, 3 o 4) como atajo directo.

Comandos disponibles

El campo para escribir solo se habilita dentro de las opciones [2] Tengo una idea y la armamos juntos y [3] Ya sé lo que quiero (modo avanzado). Desde el menú principal, donde se navega con las flechas, no hay un campo de texto activo: primero hay que entrar a alguna de esas dos opciones para poder escribir comandos.

Modo guiado (opción 2).

Modo avanzado (opción 3).

Una vez dentro de alguno de esos modos, se pueden ver los comandos disponibles en cualquier momento escribiendo /help.

Mensaje de ayuda (/help) con los comandos disponibles.

Cualquier otro texto que se escriba se envía directamente al agente: es la forma normal de pedirle que genere, revise o explique algo.

Cambiar el idioma

PIX CLI se adapta automáticamente al idioma detectado durante la instalación, con soporte para español (ES), inglés (US), portugués (BR) y ruso (RU). Se puede cambiar de tres formas:

• Desde el chat: /idioma <código> (por ejemplo /idioma en).
• Desde la terminal, de forma permanente: pix idioma <código>.
• Desde la terminal, solo para esa sesión: pix --lang <código> (no modifica la configuración guardada).

Ejemplo: cambiar del español al inglés desde el chat

1

Dentro del modo guiado o del modo avanzado, escribir /idioma en y presionar Enter.

Comando /idioma en escrito en el campo de texto.

2

PIX CLI confirma el cambio con el mensaje “Language changed to English.”.

Confirmación del cambio de idioma a inglés.

3

A partir de ese momento toda la interfaz, incluido el menú principal, se muestra en el idioma elegido.

Menú principal de PIX CLI ya traducido al inglés.

Qué tener en cuenta antes de usar PIX CLI

PIX CLI es una herramienta de productividad para acelerar la creación de bots, pero no reemplaza el proceso de revisión técnica.

Soporte

Ante problemas para instalar PIX CLI, configurar Claude o generar el primer script, se puede contactar al equipo de soporte de PIX Robotics, o usar la opción “Reportar un problema” dentro de PIX CLI, que empaqueta los registros automáticamente.