Conectar una app de IA

En el Mac y en Windows, una app de IA como Claude Code o Claude Desktop puede trabajar en los proyectos que tienes abiertos en Pyxen: leer tu código, comprobarlo, ejecutar tu juego para probarlo y cambiarlo. Ves cada cambio en Pyxen en el momento en que ocurre y puedes deshacerlo.

Conectar una app de IA forma parte de Pyxen, licencia completa, en el Mac y en Windows. Está desactivado hasta que lo actives.

Activarlo

Abre Pyxen › Ajustes… (en Windows, Editar › Ajustes…), elige IA y activa Permitir que las apps de IA de este ordenador usen Pyxen. La fila Estado dice lo que pasa: Esperando una app de IA y luego Conectado a … cuando una app habla con Pyxen.

Pyxen solo escucha mientras el ajuste está activado y Pyxen está abierto. Desactívalo y se cierran todas las conexiones.

Añadir Pyxen a tu app de IA

Ajustes › IA copia la configuración por ti, con todo ya rellenado.

Claude Code

1. Elige Copiar comando para Claude Code.
2. Pega el comando en Terminal (en Windows, en PowerShell o en Terminal Windows) y pulsa Retorno. Añade Pyxen a Claude Code para todas las carpetas en las que trabajes.
3. En Claude Code, /mcp muestra pyxen y sus herramientas.
4. Pregúntale algo sobre tu juego: «Añade un doble salto al juego abierto en Pyxen y pruébalo.»

Claude Desktop

1. Elige Copiar configuración para Claude Desktop.
2. En Claude Desktop, abre Settings › Developer › Edit Config y pega las líneas en el archivo. Si ya muestra servidores, añade la parte pyxen junto a ellos.
3. Cierra Claude Desktop y vuelve a abrirlo.

Claude Desktop inicia Pyxen por sí mismo para llegar a la app que tienes abierta, así que el archivo no contiene ningún token. Mantén Pyxen abierto con el ajuste activado.

Otra app de IA

Una app que se conecta a una dirección: elige Copiar dirección y token y dale la dirección y el token, enviado como Authorization: Bearer …. Una app que solo inicia servidores como un comando: dale el propio Pyxen con --mcp detrás, como hace la configuración de Claude Desktop.

La primera vez que una app se conecta

En el Mac, la primera vez que una app de IA pide trabajar en tus proyectos, Pyxen te lo pregunta, en su propia ventana: Claude quiere trabajar en Pyxen, con lo que podrá hacer. Elige Permitir y Pyxen lo recuerda: no se vuelve a preguntar por esa app. Elige No permitir y la app sabe que dijiste que no; se vuelve a preguntar la próxima vez que se conecte. La pregunta te espera dos minutos y luego se le pide a la app que lo intente de nuevo. Si Pyxen está detrás de otra app, su icono rebota en el Dock.

En Windows, Pyxen todavía no pregunta: una app que has configurado se conecta en cuanto el ajuste está activado.

Lo que puede hacer la app de IA

• Ver tus proyectos como los muestra el inicio de Pyxen, y trabajar en cualquiera que esté abierto. Si no nombra ninguno, trabaja en la ventana de delante. Para abrir un proyecto cerrado, primero te pregunta: Claude quiere abrir Bat Cave, con Abrir y No abrir. El proyecto se abre en una ventana detrás de la tuya, así que sigues escribiendo donde estás. Permitir durante esta sesión le deja abrir otros sin volver a preguntar hasta que se desconecte.
• Leer tus archivos, los ajustes del proyecto y los componentes que usan tus scripts.
• Comprobar el código con el comprobador de Pyxen Script. El código que no pasa la comprobación nunca se escribe: la app recibe la línea y el motivo, y lo vuelve a intentar.
• Ejecutar tu juego sin ventana, con teclas y movimientos del ratón fotograma a fotograma, y leer la consola, las entidades y una imagen de cualquier fotograma, dibujada como la dibuja la Vista previa. Tu propio juego en la Vista previa nunca se pausa ni se toca.
• Mirar tu juego tal como la Vista previa lo muestra ahora, o en cualquier fotograma que Pyxen guarda.
• Viajar atrás por los últimos 300 fotogramas de tu juego y de sus propias ejecuciones, fotograma a fotograma, como el depurador de viaje en el tiempo, y comparar una ejecución antes y después de un cambio. Tu Vista previa se queda en el fotograma que elegiste.
• Buscar en la referencia, el manual y los fragmentos, para escribir Pyxen Script como lo hace Pyxen.
• Cambiar scripts, ajustes del proyecto y paquetes, y añadir archivos.
• Añadir mecánicas, y cambiar sus ajustes.

En Windows, solo trabaja en los proyectos abiertos en las ventanas de Pyxen: todavía no puede abrir un proyecto cerrado.

Seguir lo que hace

En el Mac, mientras una app trabaja en un proyecto, la barra de herramientas de su ventana lo dice: Claude · trabajando, con Detener. Haz clic en el nombre para abrir el panel Asistente: cada paso que ha dado (Leyó main.py, Comprobado: ningún problema, Lo ejecutó por su cuenta: 90 fotogramas) y cada cambio que ha hecho, con los archivos y las líneas que cambió.

Sus cambios entran en tu proyecto a medida que los hace. Un panel de código que muestra un archivo cambiado muestra el cambio al momento, y Editar › Deshacer (Ctrl+Z) en ese panel lo retira. Un juego en marcha muestra Código modificado · Recargar.

• Deshacerlo. Justo después de su cambio, Editar › Deshacer el cambio de Claude (⌘Z) lo retira entero, de una vez, en cada archivo que tocó; Pyxen pregunta antes cuando tocó varios. En cuanto editas algo, ⌘Z vuelve a deshacer tus propias ediciones.
• Revertir, en el panel Asistente, retira cualquiera de sus cambios, siempre que no hayas editado sus archivos desde entonces. La app sabe que lo revertiste.
• Detener, en la barra de herramientas o en el panel Asistente, rechaza sus siguientes peticiones en este proyecto y le dice que te pregunte antes de seguir. Vuelve a trabajar en su siguiente turno, cuando le pides algo nuevo.

En Windows, el nombre en la barra de herramientas, el panel Asistente y Deshacer el cambio de Claude todavía no están.

Preguntar antes de cambiar el proyecto. En el Mac, para decidir antes de que nada cambie, activa Ajustes › IA › Preguntar antes de cambiar el proyecto (desactivado por defecto). Los cambios de la app esperan entonces en el panel Asistente como una sola propuesta, Un cambio te espera, con los archivos y las líneas que cambiaría. Tu proyecto sigue como estaba hasta que eliges, mientras la app lee y ejecuta su propuesta. Aceptar la pone en tu proyecto como un solo cambio, que puedes deshacer o revertir como cualquier otro; Rechazar la descarta, y la app lo sabe. Si editas uno de sus archivos mientras tanto, solo queda Rechazar: vuelve a pedírselo a la app.

Lo que no puede hacer

Solo trabaja en los proyectos abiertos en las ventanas de Pyxen. Nunca llega a un archivo fuera del proyecto, a la red, a los ajustes de Pyxen ni a tu licencia. En el Mac, un proyecto cerrado solo aparece con su nombre: no se lee hasta que dejas que se abra. En Windows, solo aparecen los proyectos abiertos.

Tu privacidad

La conexión se queda en tu ordenador: Pyxen solo escucha en este ordenador, cada solicitud necesita el token y se rechazan las solicitudes de páginas web. En Windows, el token se guarda de modo que solo tu cuenta de Windows puede leerlo. Pyxen no nos envía nada. Lo que pidas a la app de IA sigue sus propios términos.

Nuevo token en Ajustes › IA crea un token nuevo y desconecta las apps que usan el anterior. Claude Code necesitará entonces el nuevo comando; la configuración de Claude Desktop sigue funcionando.

Consejos

• Después de un cambio, pide a la app de IA que ejecute el juego y mire el resultado. Puede mantener teclas pulsadas durante varios fotogramas, leer dónde están las cosas y mirar una imagen del fotograma, lo que detecta la mayoría de los errores.
• Pyxen funciona con cualquier modelo de IA, y mejor con los más capaces.
• Conectar una app de IA está en el Mac, con la Licencia completa.