Antes de empezar
Necesitas:- acceso Premium activo de Capriole AI o acceso Team elegible;
- una clave API de Capriole AI desde la página de API;
- al menos un agente de programación instalado;
- una terminal donde puedas definir una variable de entorno.
Esta guía reutiliza una clave para demostrar compatibilidad. Para una configuración de larga duración o un equipo, crea una clave con nombre separada para cada agente o usuario. Las claves separadas reducen el impacto de una credencial filtrada y te permiten filtrar el uso o revocar el acceso de forma independiente desde la página de API.
Empareja el agente con su protocolo
Cada cliente conserva el protocolo de transmisión para el que se construyó, aunque la clave de la cuenta sea compartida.
Las rutas de Responses y Chat Completions incluyen
/v1 en la Base URL. Las rutas de Anthropic Messages usan la raíz de la API, salvo cuando una página de integración documenta un valor de adaptador específico del cliente. Copia el valor exacto de la página de integración coincidente.
Configura la clave compartida
1
Exporta la clave API de Capriole
Define una variable de shell antes de abrir un agente:Verifica que la variable existe sin imprimir el secreto:El resultado esperado es
Capriole API key is set.2
Elige la ruta del cliente
Abre la página de integración de la tabla y copia su configuración mantenida. Usa el mismo valor de Para OpenClaw:
CAPRIOLE_AI_API_KEY donde ese cliente pida un token.- Codex lee la clave de
CAPRIOLE_AI_API_KEYa través deenv_key. - Claude Code usa
ANTHROPIC_AUTH_TOKEN. Defínela a partir de la variable compartida antes del inicio. - Kilo Code referencia
{env:CAPRIOLE_AI_API_KEY}en su configuración de proveedor. - GitHub Copilot CLI usa
COPILOT_PROVIDER_API_KEYen las rutas compatibles con OpenAI yCOPILOT_PROVIDER_BEARER_TOKENen Anthropic Messages. - Las entradas de proveedor de OpenCode usan la clave de Capriole en
apiKeyoauthToken, según el adaptador del proveedor. - Las entradas de proveedor de OpenClaw referencian
CUSTOM_API_KEY. Defínela a partir de la variable compartida antes de iniciar el gateway.
3
Mantén el modelo en una ruta compatible
Empieza con un alias mantenido salvo que necesites una versión exacta de modelo:
- usa
openai-latesten las rutas de OpenAI Responses; - usa
claude-latesten las rutas de Anthropic Messages; - usa un modelo listado por la página de integración en las rutas compatibles con Chat Completions.
4
Inicia y verifica el agente
Inicia el cliente configurado desde un proyecto de prueba y pide:Busca una respuesta no vacía, idealmente el marcador
CAPRIOLE_OK solicitado. Los modelos no siempre siguen prompts de salida exacta, así que el texto puede diferir.Luego abre la página de API y confirma que la solicitud aparece en la vista de uso bajo la clave y el modelo esperados. El registro de uso es la comprobación decisiva de que el cliente usó Capriole. Una respuesta sola no basta cuando el cliente tiene otro proveedor o fallback configurado. La guía de claves API y uso muestra los filtros exactos y el ciclo de vida de las claves.Esta comprobación no prueba todas las herramientas ni todas las funciones de modelo.Cómo se ve el éxito
Las solicitudes de agentes de programación usan el saldo de API personal o de Team elegible. No forman parte del chat de pago ilimitado del navegador. Lee tokens cobrados de Capriole AI antes de ejecutar una carga de trabajo automatizada grande.