Como usar o Crush com sua chave GPTAll
O Crush é o agente de terminal da Charm. Ele tem um tipo de provedor openai-compat feito exatamente para casos como o da GPTAll, pagando em reais.
Se você ainda não tem chave, escolha um plano ou peça um teste grátis.
O detalhe que mais gera chamado: o endereço da API termina em https://api.tn1.top/v1. O /v1 no fim não é opcional — sem ele o gateway responde 401 dizendo que a chave está inválida, e você vai procurar o problema no lugar errado.
1. Pré-requisitos
- Uma chave GPTAll ativa.
- O Crush instalado:
npm install -g @charmland/crush
2. Configurar o Crush
Declare a GPTAll como provedor. A chave entra por referência a variável de ambiente, com $ na frente — não escreva o valor no arquivo.
| Sistema | Onde fica |
|---|---|
| macOS | ~/.config/crush/crush.json |
| Linux | ~/.config/crush/crush.json |
| Windows | %USERPROFILE%\.config\crush\crush.json |
{
"providers": {
"gptall": {
"type": "openai-compat",
"base_url": "https://api.tn1.top/v1",
"api_key": "$GPTALL_API_KEY",
"models": [
{ "id": "gpt-5.6-luna", "name": "GPTAll gpt-5.6-luna" }
]
}
}
}- Exporte a chave:
export GPTALL_API_KEY="sua-chave". - Rode
crushna pasta do projeto e escolha o modelo. - Também aceita um
crush.jsonna raiz do projeto, se você quiser config por repositório.
De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que a GPTAll usa por baixo (comando omniroute setup-crush). Nós ainda não executamos o Crush contra o gateway para conferir de ponta a ponta. Se algo divergir, escreva para suporte@tn1.top: corrigimos e creditamos o aviso.
3. Modelos disponíveis
O GPTAll anuncia 3 nomes, todos 100% Codex: gpt-5.6-luna (rápido, dia a dia), gpt-5.6-sol (raciocínio profundo) e gpt-5.6-terra (equilíbrio entre custo e qualidade). O gateway responde igual em todos — é o mesmo nome nos planos pagos e no trial.
No Crush o modelo é informado por id do modelo dentro do provedor openai-compat.
| Modelo | Como escrever |
|---|---|
gpt-5.6-luna | gpt-5.6-luna |
gpt-5.6-sol | gpt-5.6-sol |
gpt-5.6-terra | gpt-5.6-terra |
4. O que funciona
| Recurso | Status | Observação |
|---|---|---|
| Agente de terminal | Não testamos | É o modo principal do Crush; não executamos aqui. |
Endereço com /v1 | Funciona | O openai-compat espera o caminho completo: https://api.tn1.top/v1. |
| Chave fora do disco | Funciona | O $ em "$GPTALL_API_KEY" é referência a variável de ambiente, não o valor. |
| Config por projeto | Funciona | Um crush.json na raiz sobrepõe o global. |
5. Troubleshooting
| Sintoma | O que fazer |
|---|---|
401 dizendo que a chave está ausente ou inválida | Duas causas: a variável GPTALL_API_KEY não está exportada, ou o base_url está sem o /v1. O endereço correto é https://api.tn1.top/v1. |
| A chave literal foi parar no arquivo | O valor de api_key deve ser $GPTALL_API_KEY, com o cifrão. Sem ele, o Crush trata como a chave em si e ela fica gravada em disco. |
| O modelo não aparece no seletor | Cada modelo precisa de uma entrada em models, com id igual ao nome do modelo na GPTAll. |
6. FAQ
Preciso de conta na OpenAI?
Não. openai-compat é o formato da API.
Posso listar vários modelos?
Sim, cada um com seu id e name.
Dúvida que não está aqui? Fale com a gente em suporte@tn1.top.
7. O mesmo modelo em qualquer ferramenta
O GPTAll não é a chave de "tanto faz qual modelo responde". No Crush, como em qualquer outra ferramenta compatível, o nome que você configura é sempre um dos 3 — gpt-5.6-luna, gpt-5.6-sol ou gpt-5.6-terra — todos 100% Codex.
Isso significa que trocar de ferramenta não muda o que você recebe: a mesma chave, o mesmo nome de modelo, o mesmo comportamento — só a interface muda.
Outras ferramentas com o mesmo modelo travado, na mesma chave: