Com uma única API key da Capriole AI, você usa Claude Fable 5.1 e Opus 5.5 no Claude Code pagando até 92% menos que os preços oficiais da API.
O que é Claude Code
O Claude Code é a ferramenta de programação agentiva da Anthropic para ler bases de código, editar arquivos, executar comandos e integrar-se a ferramentas de desenvolvimento. Esta configuração aponta o Claude Code para a Capriole AI pelas configurações de gateway dele: o endpoint da API, o token de autenticação e o modelo de cada alias. Com um login do Claude Pro ou Max, o Claude Code consome os limites de uso de cinco horas e semanais do plano; com uma API key da Capriole AI, ele usa o seu saldo de tokens da API.
Pré-requisitos
Antes de começar, confira se você tem:
- Uma conta Capriole AI (Cadastre-se aqui)
- Um plano Premium (USD 9 por mês, também inclui chat na web ilimitado) ou um plano Team, necessário para a API key (Assine)
- Uma API key da Capriole AI (Obtenha sua key)
Instalação
Instale o Claude Code com o instalador nativo oficial:
Ou instale com Homebrew:
Ou instale com npm (Node.js 22 ou posterior):
Verifique a instalação:
Configuração
Validação dos modelos
O Claude Code 2.1.304 passa nas verificações de leitura de arquivo, escrita de arquivo e resposta final pela Capriole AI com todos os modelos da seção Modelos suportados, usando a configuração abaixo.
Crie ou atualize ~/.claude/settings.json:
O que cada configuração faz:
model é o modelo padrão para novas sessões. Um modelo que você escolhe com /model é salvo e usado na próxima vez.
ANTHROPIC_BASE_URL envia as solicitações para a Capriole AI. Não adicione /v1; o próprio Claude Code adiciona /v1/messages.
ANTHROPIC_AUTH_TOKEN envia sua key como Bearer token, que a Capriole AI exige.
- Os três valores
ANTHROPIC_DEFAULT_*_MODEL apontam os aliases opus, sonnet e haiku para modelos que a Capriole AI oferece. haiku é o modelo que o Claude Code usa para tarefas rápidas em segundo plano.
Para uma configuração pontual no shell, exporte o endpoint e o token e depois passe o modelo:
Executar Claude Code
Inicie o Claude Code no diretório do projeto:
Troque de modelo em uma sessão com /model, por exemplo /model opus para Opus 5.5. Para uma execução não interativa, use o modo print:
Modelos suportados
O Claude Code usa o protocolo Anthropic Messages, então suporta os modelos Claude da Capriole AI:
claude-fable-5-1 (Fable 5.1, o padrão recomendado)
claude-opus-5-5 (Opus 5.5)
claude-fable-5
claude-opus-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6
claude-latest, que sempre aponta para o nosso modelo principal Claude mais recente (atualmente Fable 5.1)
O Claude Code não reconhece claude-latest como nome de modelo, então assume uma janela de contexto de 200K para ele. Use um ID concreto, como claude-fable-5-1, para ter a janela de contexto completa do modelo.
Solução de problemas
Por que o Claude Code retorna um erro de autenticação?
Use ANTHROPIC_AUTH_TOKEN para que o Claude Code envie sua chave da Capriole AI como token Bearer no cabeçalho Authorization.
Confirme que ANTHROPIC_BASE_URL é https://api.caprioletech.com sem /v1.
Por que o Claude Code volta para outro modelo a cada inicialização?
Remova ANTHROPIC_MODEL das suas configurações e do shell. Quando essa variável está definida, o Claude Code volta para esse modelo na próxima inicialização, em vez de usar o modelo que você salvou com /model.
Por que /model opus ou /model sonnet falha?
Mantenha os três valores ANTHROPIC_DEFAULT_*_MODEL para que o Claude Code associe os aliases aos modelos Claude da sua configuração da Capriole AI.
Por que o Claude Code não usa meu nível de esforço?
O Claude Code salva o nível de esforço separadamente para cada modelo. Escolha-o com /effort enquanto o modelo estiver ativo. Um effortLevel no nível superior das suas configurações de usuário não se aplica ao Opus 5.5.
Por que a contagem de tokens falha?
A Capriole AI encaminha /v1/messages/count_tokens para o upstream selecionado. Quando esse upstream não oferece suporte à contagem de tokens, o Claude Code estima a contagem, e a sessão continua funcionando.
Observações
Última modificação em 18 de novembro de 2026