Crush

Agente no terminal · OpenAI Chat, Anthropic Messages

Guia completo

Formato	Onde configurar
OpenAI Chat, Anthropic Messages	crushrc (configuração Bash): ./.crushrc, ./crushrc ou ~/.config/crush/crushrc; o formato antigo crush.json está obsoleto, mas funciona

Configuração

Copie a configuração e substitua sk-... pela sua chave da área pessoal Ailoot. É preferível guardar a chave na variável de ambiente AILOOT_API_KEY, se a aplicação o permitir.

Antes de iniciar, consulte GET /v1/models com a sua chave Ailoot. Escolha um ID exato de modelo cujos métodos incluam POST /v1/chat/completions, POST /v1/messages e use-o na configuração. Para agentes, verifique também as ferramentas e funcionalidades necessárias à sua versão do cliente.

~/.config/crush/crushrc

export AILOOT_API_KEY="sk-..."
provider add ailoot --type openai-compat \
  --base-url "https://api.ailoot.ai/v1" \
  --api-key "$AILOOT_API_KEY"

model add ailoot/deepseek-v4-pro \
  --name "DeepSeek V4 Pro (Ailoot)" \
  --context-window 1000000 \
  --default-max-tokens 32000

# formato Anthropic para Claude: endereço sem /v1
provider add ailoot-claude --type anthropic \
  --base-url "https://api.ailoot.ai" \
  --api-key "$AILOOT_API_KEY"

model add ailoot-claude/claude-sonnet-5-5 \
  --name "Claude Sonnet 5.5 (Ailoot)" \
  --context-window 1000000 \
  --default-max-tokens 64000 \
  --can-reason true --supports-images false

Esta configuração lê a chave da variável AILOOT_API_KEY. Defina-a antes de iniciar a aplicação:

export AILOOT_API_KEY="sk-..."   # adicione a ~/.zshrc ou ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # depois reinicie o terminal

Exemplo de modelo: deepseek-v4-pro. Escolha qualquer outro modelo no catálogo — verifique se suporta o formato necessário.

O que deve saber

O tipo openai-compat corresponde ao formato OpenAI Chat, com endereço incluindo /v1. O tipo anthropic corresponde ao formato Messages, com endereço sem /v1: o Crush transmite-o ao anthropic-sdk-go, que acrescenta automaticamente /v1/messages. O exemplo do README do Crush com /v1 produziria o caminho /v1/v1/messages e um erro 404. A chave é enviada no cabeçalho x-api-key, aceite pelo Ailoot. Se a lista de modelos estiver vazia, o fornecedor openai-compat carrega-os automaticamente de /v1/models. crushrc é executado como código: não inicie o Crush em pastas de terceiros que contenham este ficheiro. Neste exemplo, Claude tem supports-images = false: o catálogo de 2026-09-30 anuncia apenas texto para o formato Messages escolhido. Se a sua versão do Crush suportar esta opção, ative-a apenas para um modelo cuja ficha atual no catálogo indique entrada image no formato de API escolhido; a opção do cliente não acrescenta, por si só, suporte de imagens ao modelo.

Verificação

Para o formato OpenAI, o endereço é https://api.ailoot.ai/v1 (ou o caminho completo, se a aplicação pedir o endereço completo).
Para o formato Anthropic, o endereço é https://api.ailoot.ai sem /v1.
Faça uma pergunta curta. Se receber um erro, consulte o código e o Request ID e compare com a página Erros e limites.
Um 404 logo após a configuração quase sempre indica um endereço incorreto: um segmento a mais ou em falta, /v1.
402 — o saldo não chega para a reserva. Os agentes reservam mais do que um chat: porquê.

Documentação da aplicação: https://github.com/charmbracelet/crush#custom-providers

Ainda tem dúvidas? Envie o Request ID e uma descrição — ajudamos a esclarecer.Contactar o suporte