Configurar o Crush: instalação, API Key e modelos

Conecte o Crush ao BetterToken com um provedor openai-compat no crushrc. Nos testes em macOS com um modelo GPT, o Crush 0.98.2 concluiu as três solicitações de texto após inicializações a frio e uma chamada de ferramenta para leitura de arquivo por /v1/chat/completions.

Configurações principais

Campo	Valor
API Key	BetterToken API Key, passada com --api-key
Base URL	https://bettertoken.ai/v1, passada com --base-url
Modelo	bettertoken/YOUR_MODEL_ID
Tipo de provedor	openai-compat
Arquivo de configuração	~/.config/crush/crushrc

Pré-requisitos

• Homebrew para o comando de instalação abaixo
• Uma BetterToken API Key: cadastre-se e obtenha uma
• Um ID de modelo e seu limite de contexto da model plaza

Instalar

Use o comando Homebrew do repositório oficial do Crush:

brew install charmbracelet/tap/crush
crush --version

Configuração manual

Defina sua BetterToken API Key no terminal que executará o Crush:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Crie ~/.config/crush/crushrc com o formato de configuração Bash recomendado. Substitua todas as ocorrências de YOUR_MODEL_ID e defina --context-window com o limite documentado do modelo escolhido. O valor 128000 do exemplo é uma declaração do cliente, não um limite de modelo verificado no BetterToken.

provider add bettertoken --type openai-compat --base-url "https://bettertoken.ai/v1" --api-key "$BETTERTOKEN_API_KEY"
model add bettertoken/YOUR_MODEL_ID --name "YOUR_MODEL_ID" --context-window 128000
model large bettertoken/YOUR_MODEL_ID
model small bettertoken/YOUR_MODEL_ID
permissions allow view

Salve esses comandos no crushrc; o Crush os executa ao iniciar. permissions allow view permite a ferramenta de visualização de arquivos. O formato JSON antigo foi descontinuado pelo projeto, mas ainda funciona; sua solicitação de texto também passou nos testes.

Verificar a conexão

Execute a partir do projeto, no mesmo terminal:

crush run "Reply with only: OK"

Confira se a resposta final é OK. Para verificar o acesso a arquivos, peça que o Crush leia um arquivo conhecido do projeto e confira tanto o resultado da ferramenta view quanto a resposta final.

Trocar de modelo

Adicione outro modelo com model add, atualize as seleções de model large e model small no crushrc e inicie uma nova execução.

Erros comuns

Sintoma	O que verificar
No providers configured	O Crush informa esse erro antes de enviar uma solicitação quando nenhum provedor utilizável foi carregado. Confira o local e o conteúdo do crushrc, incluindo configurações de projeto que possam substituí-lo.
401	Exporte BETTERTOKEN_API_KEY antes de iniciar o Crush e confira seu valor.
Nenhum modelo explícito na configuração	Com apenas um provedor configurado, o Crush descobriu modelos por /v1/models nos testes. Entradas explícitas de model add permitem definir o modelo usado neste exemplo.
O acesso a arquivos exige aprovação	Confira permissions allow view na configuração carregada.

Conteúdo relacionado

• Compare as ferramentas compatíveis
• Erros da API e limites de requisições
• Referência de configuração do Crush

Detalhes técnicos

O provedor openai-compat testado enviou solicitações de geração para /v1/chat/completions. A descoberta de modelos usou /v1/models quando as entradas explícitas de modelos foram omitidas.