O que é Crush
O Crush é o agente de programação de código aberto da Charm para o terminal. Ele lê a configuração de um arquivo crushrc, que é Bash com comandos específicos do Crush. Esta configuração adiciona a Capriole AI como um único provedor compatível com OpenAI.
Pré-requisitos
Antes de começar, confira se você tem:
Instalação
Instale o Crush com Homebrew:
Ou instale com npm:
Verifique a instalação:
Configuração
Validação dos modelos
O Crush 0.98.1 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 ~/.config/crush/crushrc:
O que cada configuração faz:
--type openai-compat envia todos os modelos para Chat Completions. A Capriole AI oferece todos esses modelos em Chat Completions.--api-key "$CAPRIOLE_AI_API_KEY" lê sua key do ambiente quando o Crush carrega o arquivo, e o Crush a envia como Bearer token.--discover-models false limita a lista aos modelos que você adiciona.model large é o modelo principal de programação. model small é o modelo para tarefas leves, como títulos de sessão.
Executar Crush
Defina sua API key e inicie o Crush no diretório do projeto:
Pressione Ctrl+L para trocar de modelo. Para uma execução não interativa, use crush run:
Modelos suportados
As referências de modelo usam o formato capriole/<model-id>.
openai-latest e claude-latest sempre apontam para o nosso modelo principal mais recente de cada família.
Solução de problemas
Por que o Crush retorna um erro de autenticação?
Exporte CAPRIOLE_AI_API_KEY antes de iniciar o Crush. O Crush lê a variável quando carrega crushrc.
No Chat Completions, use os IDs Claude com o prefixo anthropic/, como anthropic/claude-opus-5-5. Os IDs sem prefixo, como claude-opus-5-5, são para Anthropic Messages.
Por que as mudanças de configuração não se aplicam?
Um arquivo .crushrc ou crushrc no diretório do projeto tem prioridade sobre ~/.config/crush/crushrc. Verifique se ele existe e reinicie o Crush.
Observações
crushrc é executado como um script de shell. Não cole sua key nele.- Para adicionar outro modelo da Capriole AI, adicione mais uma linha
model add. GET https://api.caprioletech.com/v1/models lista todos os IDs de modelo.
- Referências oficiais: Crush e Configuração do Crush.
Última modificação em 20 de outubro de 2026
