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

Elegir y cambiar modelos

Encontrar un modelo utilizable

Primero conecta un proveedor. En el terminal, escribe /models, busca entre los proveedores conectados y selecciona un modelo. Los favoritos y las opciones recientes facilitan volver a él.

El selector agrupa por proveedor. Los modelos sin la salida de texto o las llamadas a herramientas necesarias pueden ocultarse o desactivarse. Los modelos locales gestionados pueden aparecer antes de descargar los pesos; completa su preparación antes de usarlos.

Para consultar los ID disponibles en tu CLI instalada, ejecuta:

ax-code models
ax-code models --json --verbose

Copia el ID completo provider/model. El mismo nombre mediante dos proveedores puede tener credenciales, capacidades y límites distintos.

Seleccionar para una ejecución

Sustituye el valor de ejemplo por un ID mostrado por tu instalación. El primer comando abre el terminal; el segundo ejecuta una instrucción. Coloca la instrucción después de --.

MODEL='provider/model'
ax-code --model "$MODEL"
ax-code run --model "$MODEL" -- "Explain the project entry point without changing files."

Los alias de familia deepseek, glm y qwen eligen modelos Flash compatibles mediante las conexiones disponibles. Sus destinos pueden cambiar entre versiones. Usa un ID completo para pedir un modelo o nivel concreto; una referencia aislada no es un ID completo.

Guardar una opción predeterminada

Integra este campo en el ax-code.json de proyecto o global existente; cambia el marcador, sin reemplazar todo el archivo:

{
  "model": "provider/model"
}

Reinicia tras editar. Sin un modelo explícito, las opciones del agente, la sesión o recientes pueden influir; comprueba el modelo activo antes de enviar la tarea. Desktop gestiona sus propios ajustes.

Elegir según la tarea

Empieza con una pregunta pequeña sobre el repositorio. Para editar, verifica las llamadas a herramientas y ejecuta las comprobaciones del proyecto. Para imágenes, confirma la entrada de imágenes. En tareas largas, revisa límites de contexto y salida en lugar de basarte solo en el nombre.

Compara candidatos con la misma tarea, entradas y criterios de aceptación. Considera latencia, condiciones del proveedor, tratamiento de datos y memoria local necesaria. Ningún modelo garantiza un cambio correcto.

El esfuerzo de razonamiento y el enrutamiento automático son controles distintos. Empieza con un modelo explícito antes de activar el enrutamiento. La generación Wiki puede usar su propio wiki.model, independiente de la sesión en primer plano.

Si el modelo no funciona

• No aparece: verifica que el proveedor esté conectado y habilitado; después revisa filtros de capacidades y descubrimiento de la pasarela. No inventes ID a partir de nombres comerciales.

• No autorizado o prohibido: comprueba el ID exacto solicitado y los permisos de cuenta y clave. Iniciar sesión o listar correctamente no demuestra permiso de ejecución.

• Error de preparación local o memoria: completa la descarga y carga y revisa los requisitos de hardware. Reduce la carga o selecciona un modelo compatible más pequeño.

Siguientes pasos

Referencia de proveedores y modelos · Recuperación de modelos · Selección AX Engine · Inicio rápido Wiki · Inicio de documentación