Versión de la documentación · CLI 7.30.1 · SDK 2.6.53. Desktop utiliza el runtime incluido en su propia versión. Los comandos y ejemplos se conservan del original en inglés. Original en inglés

Conectar tu primer proveedor de modelos

Elegir una conexión

El proveedor es la conexión a un servicio de modelos; el modelo es la opción concreta elegida mediante ella. Conectar un proveedor no selecciona todos sus modelos ni otorga acceso a la cuenta.

En la interfaz de terminal, escribe /connect y elige una de las opciones siguientes. Desktop tiene configuración y motor integrado propios; estos comandos con barra corresponden al terminal.

API en la nube: elige API Cloud Provider, selecciona el servicio y sigue las instrucciones de credenciales. Una suscripción de chat no incluye necesariamente acceso ni crédito de API.
CLI de programación: instala primero una CLI compatible e inicia sesión, después elige CLI Provider. AX Code reutiliza esa sesión local; las capacidades dependen del adaptador.
Modelo local: inicia Ollama o LM Studio y carga un modelo con llamadas a herramientas; elige Local LLM runtime y confirma el endpoint. AX-Engine runtime tiene su propio proceso de configuración y descarga en los Mac compatibles.
Pasarela: elige AX Trust para su endpoint, API Cloud Provider → Custom API provider para otra pasarela, o Private GPU cloud para un despliegue compatible dedicado. Introduce la URL, el token y los ID exactos anunciados por el servicio.

Verificar la conexión

Ejecuta estos comandos en un terminal interactivo. El inicio de sesión solicita proveedor y credenciales; no pegues claves reales en comandos compartidos o archivos del repositorio.

ax-code providers login
ax-code providers list
ax-code models

Deberían aparecer el proveedor y los ID utilizables. Guardar credenciales u obtener la lista no demuestra permiso de inferencia. Continúa con la selección del modelo y envía una pequeña solicitud de prueba.

Gestionar credenciales y configuración

Usa /providers para gestionar conexiones y /connect para sustituir una clave. Desactivar conserva las credenciales guardadas; desconectar las elimina. Las variables de entorno y las claves configuradas aún pueden proporcionar acceso.

Usa el ax-code.json del proyecto para ajustes compartidos sin secretos o el ~/.config/ax-code/ax-code.json global para tus preferencias. Mantén los secretos fuera del control de versiones; usa el diálogo de credenciales o las referencias de entorno de la guía de pasarelas. Reinicia tras cambios manuales.

Si falla la configuración

Error de autenticación: comprueba que la clave corresponde al servicio, endpoint y plan de API elegidos. En una CLI de programación, verifica primero su propia sesión.
Lista vacía o conexión rechazada: comprueba servidor local activo, modelo cargado, URL y puerto correctos. Ollama suele usar http://localhost:11434/v1; LM Studio usa http://localhost:1234/v1.
Modelo rechazado: usa el ID exacto del endpoint y comprueba los permisos de la cuenta. El nombre mostrado por una pasarela puede diferir del ID enviado al servicio de origen.
Proveedor ausente: revisa enabled_providers y disabled_providers. Para diagnosticar la instalación, ejecuta ax-code doctor; no valida tu cuenta del proveedor.

Siguientes pasos

Catálogo y métodos de acceso · Pasarelas personalizadas y GPU privadas · Elegir modelo · Crear AX Wiki · Inicio de documentación