Saltar al contenido principal
Una sola clave API de Capriole AI puede autenticar Codex, Claude Code, Kilo Code, GitHub Copilot CLI, OpenCode, OpenClaw, Cline, Qwen Code, Crush y Pi. La clave se mantiene igual, mientras que la Base URL, el protocolo y el selector de modelo deben coincidir con el cliente que estás configurando. Usa esta guía para pasar de una cuenta de Capriole a un agente en funcionamiento. Premium personal cuesta USD 9 al mes, incluye 5 millones de tokens cobrados de API y también desbloquea chat ilimitado del navegador con todos los modelos compatibles de Premium. Una membresía puede cubrir por tanto el espacio de trabajo del navegador y las 10 rutas de agente mantenidas. Las páginas de integración individuales siguen siendo la fuente de verdad para la configuración completa de cada cliente.

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.
Mantén la clave API fuera de repositorios y archivos de configuración confirmados. Los ejemplos usan YOUR_CAPRIOLE_AI_API_KEY como marcador de posición.
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_KEY a través de env_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 apiKey y en un encabezado Authorization. Su único proveedor de Capriole envía cada familia de modelo a Responses, Messages o Chat Completions.
  • GitHub Copilot CLI usa COPILOT_PROVIDER_API_KEY en las rutas compatibles con OpenAI y COPILOT_PROVIDER_BEARER_TOKEN en Anthropic Messages.
  • OpenCode referencia {env:CAPRIOLE_AI_API_KEY} en apiKey y en un encabezado Authorization. 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 envKey y puede leerla de ~/.qwen/.env.
  • Crush lee $CAPRIOLE_AI_API_KEY en la entrada de proveedor de su crushrc.
  • Pi lee $CAPRIOLE_AI_API_KEY en models.json.
Para Claude Code:
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-latest en las rutas de OpenAI Responses, o el nativo gpt-6.2-astra en Codex;
  • usa claude-latest en las rutas de Anthropic Messages, o claude-fable-5-1 en Claude Code;
  • usa un modelo listado por la página de integración en las rutas compatibles con Chat Completions.
El catálogo de modelos actual lista los modelos de la API pública.
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.

Corrige fallos habituales de configuración

Elige la siguiente página

Lee el artículo de compatibilidad de agentes de programación cuando necesites el modelo detrás de estas rutas. Para código de aplicación directo, continúa con la guía de los SDK de OpenAI y Anthropic. Riesgos de seguridad de un gateway LLM enumera qué revisar antes de que un agente envíe tu código fuente. Si tu agente no es uno de estos 10, conéctalo mediante un endpoint personalizado. Prueba los modelos insignia actuales en el chat gratuito del navegador y luego pasa a Premium cuando estés listo para crear la clave API que usan tus agentes de programación.
Última modificación el 18 de noviembre de 2026