Antes de começar
Você precisa de:- Premium da Capriole AI ativo ou acesso Team elegível;
- uma API key da Capriole AI na página da API;
- pelo menos um agente de programação instalado;
- um terminal em que você possa definir uma variável de ambiente.
Este guia reutiliza uma key para comprovar compatibilidade. Em uma configuração de longa duração ou em uma equipe, crie uma key nomeada separada para cada agente ou usuário. Keys separadas reduzem o impacto de uma credencial vazada e permitem filtrar o uso ou revogar o acesso de forma independente na página da API.
Combine o agente com o protocolo
Cada cliente mantém o protocolo de transmissão para o qual foi feito, mesmo com a key da conta compartilhada.
Os caminhos Responses e Chat Completions incluem
/v1 na base URL. Os caminhos Anthropic Messages usam a raiz da API, exceto quando uma página de integração documenta um valor de adaptador específico do cliente. Copie o valor exato da página de integração correspondente.
Configure a key compartilhada
1
Exporte a API key da Capriole
Defina uma variável de shell antes de abrir um agente:Verifique que a variável existe sem imprimir o secret:O resultado esperado é
Capriole API key is set.2
Escolha o caminho do cliente
Abra a página de integração da tabela e copie a configuração mantida. Use o mesmo valor de Para o OpenClaw:
CAPRIOLE_AI_API_KEY onde o cliente pedir um token.- O Codex lê a key de
CAPRIOLE_AI_API_KEYporenv_key. - O Claude Code usa
ANTHROPIC_AUTH_TOKEN. Defina a partir da variável compartilhada antes de iniciar. - O Kilo Code referencia
{env:CAPRIOLE_AI_API_KEY}na configuração do provedor. - O GitHub Copilot CLI usa
COPILOT_PROVIDER_API_KEYem caminhos compatíveis com OpenAI eCOPILOT_PROVIDER_BEARER_TOKENem Anthropic Messages. - As entradas de provedor do OpenCode usam a key da Capriole em
apiKeyouauthToken, conforme o adaptador do provedor. - As entradas de provedor do OpenClaw referenciam
CUSTOM_API_KEY. Defina a partir da variável compartilhada antes de iniciar o gateway.
3
Mantenha o modelo em uma rota compatível
Comece com um alias mantido, a menos que você precise de uma versão exata do modelo:
- use
openai-latestem caminhos OpenAI Responses; - use
claude-latestem caminhos Anthropic Messages; - use um modelo listado pela página de integração em caminhos compatíveis com Chat Completions.
4
Inicie e verifique o agente
Inicie o cliente configurado em um projeto de teste e peça:Procure uma resposta não vazia, de preferência o marcador
CAPRIOLE_OK pedido. Os modelos nem sempre seguem prompts de saída exata, então o texto pode ser diferente.Depois, abra a página da API e confirme que a solicitação aparece na visualização de uso sob a key e o modelo esperados. O registro de uso é a verificação decisiva de que o cliente usou a Capriole. Uma resposta sozinha não basta quando o cliente tem outro provedor ou fallback configurado. O guia de API keys e uso mostra os filtros exatos e o ciclo de vida da key.Esta verificação não testa toda ferramenta ou recurso de modelo.Como é o sucesso
As solicitações de agente de programação usam o saldo de API pessoal ou Team elegível. Elas não fazem parte do Browser Chat pago ilimitado. Leia Tokens cobrados da Capriole AI antes de executar uma carga de trabalho automatizada grande.