Pular para o conteúdo principal
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.

Por que as solicitações falham com erros de endpoint?

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