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
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}enapiKeyy en un encabezadoAuthorization. Su único proveedor de Capriole envía cada familia de modelo a Responses, Messages o Chat Completions. - GitHub Copilot CLI usa
COPILOT_PROVIDER_API_KEYen las rutas compatibles con OpenAI yCOPILOT_PROVIDER_BEARER_TOKENen Anthropic Messages. - OpenCode referencia
{env:CAPRIOLE_AI_API_KEY}enapiKeyy en un encabezadoAuthorization. Su único proveedor de Capriole envía cada familia de modelo a Responses, Messages o Chat Completions. - Las entradas de proveedor de OpenClaw referencian
${CAPRIOLE_AI_API_KEY}directamente. Exporta la variable compartida en la terminal que inicia el gateway. - Cline guarda la clave una sola vez con
cline auth -k "$CAPRIOLE_AI_API_KEY". - Qwen Code indica la variable en
envKeyy puede leerla de~/.qwen/.env. - Crush lee
$CAPRIOLE_AI_API_KEYen la entrada de proveedor de sucrushrc. - Pi lee
$CAPRIOLE_AI_API_KEYenmodels.json.
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, o el nativogpt-6.2-astraen Codex; - usa
claude-latesten las rutas de Anthropic Messages, oclaude-fable-5-1en Claude Code; - 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.Cómo se ve el éxito
Las solicitudes de agentes de programación usan el saldo de API personal o de Team elegible. Lee tokens cobrados de Capriole AI antes de ejecutar una carga de trabajo automatizada grande.

