Gestionar adaptadores y modelos

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

Todo lo que hay aquí está en una sola página: Ajustes → Servidor → Proveedores de modelos. La entrada de la subbarra lateral 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 añadir un tercero.

Adaptador	CLI	Transporte
Control Center (built-in)	ninguno	Bucle de agente en proceso; habla 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 CLI independientes. Lo que sí puedes añadir 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 lista 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 listan 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.

Añadir un proveedor personalizado

Usa esto para Ollama, LM Studio, vLLM o un despliegue privado.

1. En Proveedores y modelos, dentro de Proveedores personalizados, pulsa Añadir proveedor
2. Rellena 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. Añade una clave de API si el endpoint la necesita y pulsa 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 el desplegable que hay al lado

En el caso del adaptador integrado, el desplegable se arma en vivo a partir del catálogo propio de cada proveedor conectado. Un proveedor sin credencial almacenada no aporta ningún modelo, y por eso un desplegable vacío 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 añade 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 van cualificados como provider/model y pueden llevar una cadena de respaldo separada por |. Con un respaldo, el coste se calcula según el modelo que atendió realmente el turno, no el que pediste.

Un agente sin adaptador se ejecuta en el bucle integrado

Cada espacio de trabajo crea de serie 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 pide a Anthropic su modelo predeterminado. Por eso, un agente que se deje totalmente sin configurar se ejecuta si has conectado una cuenta de Anthropic y, si no, falla con No credential for provider "anthropic".

Al terminar el paso del adaptador del onboarding, 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 más tarde siguen creando los cinco sin configurar. Define el adaptador y el modelo explícitamente 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, pulsa 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 guarda sus propias credenciales, en su propia configuración, en el host del servidor. Control Center no las gestiona.

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 de modo 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

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

El desplegable de modelos está vacío

• 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
• Gestionar claves API
• Diagnosticar un agente
• Gestionar costes

Conceptos relacionados

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