Ir al contenido
Documentation

Elija modelos para el agente de IA

El agente trabaja mediante herramientas, por lo que el modelo que utilice debe ser compatible con el uso de herramientas. De forma predeterminada, la plataforma elige un modelo adecuado para usted.

Con Automático, dirigeCHAMPREP cada turno y cada tarea de subagente a un modelo que se ajuste a la solicitud y satisfaga las necesidades de ese turno, elegido de entre los modelos de los que dispone. Es la opción recomendada, y la línea de estado muestra Auto.

Vuelva a «Auto» en cualquier momento con /model auto o seleccionando Automático (recomendado) en /models.

/models

El selector muestra:

  • Automático (recomendado).
  • Modelos de la plataforma, agrupados por proveedor. Cada uno muestra iconos de capacidades: tools o no tools, vision, y long context. Los modelos marcados con 🔒 no están incluidos en su plan y no pueden seleccionarse.
  • Sus modelos: modelos que haya registrado con su propia clave de proveedor.
  • Registrar un nuevo modelo.

Escriba para filtrar y, a continuación, pulse Enter. También puede cambiar directamente con /model NAME o inicie una sesión con champrep ai --model NAME, donde NAME es un identificador de modelo de la plataforma, el nombre de un modelo que haya registrado, o auto.

Su elección se recuerda para el proyecto actual en .champrep/settings.local.json. Allí solo se almacenan los identificadores de los modelos, nunca las claves. Los subagentes utilizan la misma selección.

Desde un script, enumere los modelos a su disposición con:

Ventana de terminal
champrep ai models ls

Cuando un modelo no puede realizar una acción

Sección titulada «Cuando un modelo no puede realizar una acción»
  • No hay soporte mediante herramientas. Si elige un modelo marcado como no tools, el agente le avisa primero: sin herramientas, no puede leer ni editar archivos, ejecutar comandos ni utilizar CHAMPREP servicios. Puede cambiar a «Auto», conservar el modelo para el chat sin funciones avanzadas o elegir otro.
  • Capacidad ausente. Si un turno requiere algo de lo que carece el modelo elegido, como una entrada de imagen o una ventana de contexto más amplia, el turno se rechaza y no se produce ningún cambio. El agente le ofrece cambiar a «Auto» y reenviar la solicitud, o bien seleccionar otro modelo. Nunca realiza el cambio por usted.

Puede registrar un modelo que utilice su propia API clave de un proveedor compatible. Las solicitudes con ese modelo las factura su proveedor en su propia cuenta y no consumen sus CHAMPREP AI créditos.

Los proveedores compatibles son Anthropic, OpenAI, GeminiGoogle, xAI, DeepSeek y Moonshot Kimi. El registro muestra los modelos disponibles para cada proveedor.

/model register
  1. Pegue la claveAPI de su proveedor en el campo enmascarado.
  2. Confirme el proveedor. Se detecta a partir de la clave siempre que sea posible; en caso contrario, debe seleccionarlo usted.
  3. Elija el modelo y asígnele un nombre, por ejemplo My Claude.

La clave se comprueba con el proveedor antes de guardarse. Seleccione el nuevo modelo en /models, donde se denomina su clave, o con champrep ai --model "My Claude".

La clave se lee desde un indicador oculto o desde la entrada estándar con --key-stdin. Nunca se acepta como opción ni como variable de entorno, por lo que no puede aparecer en el historial del shell ni en las listas de procesos.

Ventana de terminal
champrep ai models register --name "My Claude"
Ventana de terminal
pass show anthropic | champrep ai models register --name "My Claude" --key-stdin

Opciones opcionales: --provider (de lo contrario, se detecta a partir de la clave) y --model (en caso contrario, el primer modelo compatible con la herramienta del proveedor).

  • Solo se introduce en un campo enmascarado o desde la entrada estándar, y nunca se vuelve a mostrar, imprimir ni escribir en la transcripción, el historial de la línea de comandos ni los registros.
  • Se envía una sola vez a su CHAMPREP AIcuenta y se almacena allí, no en su ordenador. Posteriormente, solo se muestra una huella digital enmascarada.
  • Solo se utiliza para sus propias solicitudes con ese modelo.
  • Las claves pegadas en una línea de comandos normal se bloquean y nunca se envían al modelo.

/model remove "My Claude"
Ventana de terminal
champrep ai models rm "My Claude"

Al eliminar un modelo, se borra su clave de su CHAMPREP AIcuenta. También puede gestionar sus claves en su configuraciónCHAMPREP AI en la web.

  • /effort low|medium|high|max|off Establece el esfuerzo de razonamiento para los modelos que lo admiten.
  • /context Muestra qué parte del contexto del modelo utiliza la conversación.
  • /compact [focus] Resume la conversación en contexto libre, conservando lo que usted denomine.