Administrar adaptadores y modelos

Esta guía te muestra cómo conectar proveedores de modelos y elegir con qué se ejecuta un agente.

Todo lo que hay aquí vive en una sola página: Ajustes → Servidor → Proveedores de modelos. La entrada de la barra lateral secundaria dice «Proveedores de modelos»; el encabezado de la página dice «Adaptadores».

Qué es un adaptador

Un adaptador es el ejecutor que lleva a cabo un turno de agente. Hay dos y la lista es fija: no puedes agregar un tercero.

Adaptador	CLI	Transporte
Control Center (built-in)	ninguno	Bucle de agente en proceso; se comunica con los proveedores por HTTP
Claude Code	claude	claude -p --output-format stream-json

Cursor, Codex, Anthropic, OpenAI y el resto son proveedores del adaptador integrado, no CLIs independientes. Lo que sí puedes agregar es otro proveedor: cualquier endpoint compatible con OpenAI o con Anthropic. De eso trata la sección siguiente.

La detección sondea el servidor, no tu máquina

La tarjeta Ejecutores detectados enumera lo que cc_server encontró en el PATH del host del servidor. En un cliente ligero o web, esa es una máquina distinta de la que estás viendo. Instala la CLI en la máquina que ejecuta cc_server.

Conectar un proveedor de modelos

El adaptador integrado necesita al menos un proveedor conectado para poder funcionar. El catálogo incluye catorce.

1. Ve a Ajustes → Servidor → Proveedores de modelos
2. Desplázate hasta Proveedores y modelos
3. Busca tu proveedor y conéctalo:

Proveedor	Cómo conectarlo
Anthropic	Clave de API. Una suscripción Claude Pro/Max no es un inicio de sesión en la API de Anthropic: para ese plan, usa el adaptador Claude Code
OpenAI, Codex, Cursor	Inicio de sesión OAuth en el navegador, o una clave de API. Codex es ChatGPT Plus/Pro a través del backend Codex Responses, no un proceso de CLI lanzado aparte
Kimi Code	Solo OAuth en el navegador: un flujo de código de dispositivo. Es un plan de tarifa plana, así que no tiene precio por token
OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API)	Clave de API

Comprobación: la insignia de la fila cambia a conectado y, al expandirla, se enumeran los modelos que ofrece ese proveedor, cada uno con su precio por millón de tokens y su ventana de contexto.

Los tokens de OAuth se guardan en el almacén de credenciales del propio servidor y se renuevan antes de que caduquen. Las credenciales de los proveedores son globales del host: las comparte cada espacio de trabajo de la instalación, no están acotadas a uno.

Agregar un proveedor personalizado

Usa esto para Ollama, LM Studio, vLLM o una implementación privada.

1. En Proveedores y modelos, dentro de Proveedores personalizados, presiona Añadir proveedor
2. Completa un nombre, elige el tipo de API (compatible con OpenAI o compatible con Anthropic) e indica la URL base (por ejemplo, http://localhost:11434/v1)
3. Agrega una clave de API si el endpoint la necesita y luego presiona Añadir proveedor

Un proveedor personalizado aparece en la misma lista, con un botón de eliminación que sus hermanos integrados no tienen.

Elegir un modelo para un agente

1. Ve a Ajustes → Espacio de trabajo → Agentes y selecciona el agente
2. En la pestaña Ajustes, elige el adaptador
3. Elige el modelo en la lista desplegable que está al lado

En el caso del adaptador integrado, la lista desplegable se arma en vivo a partir del catálogo propio de cada proveedor conectado. Un proveedor sin credenciales almacenadas no aporta ningún modelo, y por eso una lista desplegable vacía casi siempre significa «todavía no hay nada conectado» y no «no hay nada disponible».

models.dev es un enriquecimiento, nunca una fuente de ids

El catálogo empaquetado de models.dev aporta el precio y la ventana de contexto de un modelo que ya está en la lista en vivo. Nunca agrega un id de modelo. Si falta un modelo que esperabas ver, es que el endpoint del proveedor no lo está devolviendo.

Los ids de modelo del adaptador integrado llevan el formato calificado provider/model y pueden incluir una cadena de respaldo separada por |. Con un respaldo, el costo se calcula según el modelo que atendió realmente el turno, no el que solicitaste.

Un agente sin adaptador se ejecuta en el bucle integrado

Cada espacio de trabajo crea cinco agentes —un CEO más qa, architect, engineer y librarian— sin adaptador y sin modelo. El despacho recurre a Control Center (built-in), no al ajuste Ejecutores predeterminados de esta página, que es una preferencia del cliente que la ruta de despacho nunca lee. El registro de ejecución anota cc-harness en esas ejecuciones, así que la transcripción indica con qué se ejecutó realmente.

Si tampoco hay modelo, el bucle integrado le pide a Anthropic su modelo predeterminado. Por eso, un agente que se deje totalmente sin configurar se ejecuta si conectaste una cuenta de Anthropic y, si no, falla con No credential for provider "anthropic".

Al terminar el paso del adaptador de la configuración inicial se aplica retroactivamente el par que elegiste a todos los agentes a los que todavía les falte un adaptador o un modelo —el CEO y los especialistas, en todos los espacios de trabajo que existan en ese momento—. Los espacios de trabajo creados después siguen creando los cinco sin configurar. Define el adaptador y el modelo de forma explícita en cada agente que tengas previsto usar.

Instalar la CLI de un ejecutor

El adaptador integrado no necesita instalación. En el caso de Claude Code, instala su CLI en el host del servidor con el gestor de paquetes propio de esa herramienta, por ejemplo:

npm install -g @anthropic-ai/claude-code

Después, presiona Actualizar en la parte superior de la página. Cada fila detectada muestra la versión y la ruta resueltas, además de etiquetas que indican si admite el modo JSON y la selección de modelo.

Una CLI externa conserva sus propias credenciales, en su propia configuración, en el host del servidor. Control Center no las administra.

Los argumentos del adaptador y las variables de entorno se quedan en este dispositivo

Cada fila de adaptador ofrece un campo Argumentos y un cuadro de diálogo Variables de entorno. Esos valores se guardan en tu dispositivo. El servidor lee el argv y el entorno de lanzamiento desde su propio almacén de ajustes. Pon las claves de los proveedores en el servidor (OAuth o el campo de clave de la página Proveedores de modelos), no en esos dos campos.

Restringir qué proveedores puede usar un espacio de trabajo

La gobernanza de proveedores es por espacio de trabajo y se evalúa con la regla de que gana la última coincidencia.

1. En Proveedores y modelos, desactiva el interruptor Permitir de la fila de un proveedor

Eso escribe una declaración deny para ese proveedor en el espacio de trabajo activo, y sus modelos desaparecen del catálogo de ese espacio de trabajo. Volver a activar el interruptor elimina la declaración.

Solución de problemas

Un ejecutor aparece como no encontrado

• Verifica que la CLI esté en el PATH del host del servidor, no solo en el tuyo
• Una aplicación de escritorio iniciada desde la interfaz gráfica arranca su servidor con un PATH mínimo; una CLI instalada en una ruta que solo existe en el shell puede pasarle inadvertida
• Presiona Actualizar después de instalarla

La lista desplegable de modelos está vacía

• El adaptador es el integrado y no hay ningún proveedor conectado: conecta uno en Proveedores y modelos
• O el proveedor está conectado, pero lo deniega el interruptor de gobernanza de este espacio de trabajo

Un modelo se ejecuta, pero el precio aparece como desconocido

La lista de modelos en vivo incluye el id; el precio y el contexto vienen de models.dev. Un modelo recién salido, o uno de un proveedor personalizado, todavía no tiene entrada en el catálogo.

Guías relacionadas

• Crear y configurar un agente
• Administrar claves de API
• Diagnosticar un agente
• Administrar costos

Conceptos relacionados

• El modelo de agentes
• Ciclo de vida del despacho de un agente