Conecte o Qwen Code ao CheapTokens: variáveis de ambiente e settings.json

O Qwen Code pode se conectar a um endpoint personalizado compatível com OpenAI, então conectá-lo ao CheapTokens exige três valores: a URL base https://api.cheaptokens.dev/v1, sua chave de API e um id de modelo completo, como deepseek-ai/DeepSeek-V4-Flash-0731. Exporte-os como OPENAI_API_KEY, OPENAI_BASE_URL e OPENAI_MODEL, ou coloque-os em ~/.qwen/settings.json. Ambas as rotas vêm da documentação de autenticação do Qwen Code (página atualizada pela última vez em 22 de outubro de 2026).

Imagine uma sessão longa: o agente lê uma dúzia de arquivos, edita três, roda os testes de novo. Cada etapa reenvia o contexto, então você paga pela entrada repetidas vezes. É por isso que um modelo barato em um saldo por token combina com um agente de terminal, e por isso a configuração abaixo vale dez minutos.

Instalar o Qwen Code#

O Qwen Code precisa do Node.js 22 ou mais recente. O README do projeto (github.com/QwenLM/qwen-code) lista várias formas de instalação; duas delas:

npm install -g @qwen-code/qwen-code@latest

brew install qwen-code

Você o inicia com qwen. A documentação também descreve /auth → Custom Provider para conectar um proxy ou um provedor não suportado manualmente. As duas rotas abaixo estão escritas linha por linha, então comece com uma delas.

Rota 1: três variáveis de ambiente#

A forma mais rápida. Abra um terminal no seu projeto e execute:

export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://api.cheaptokens.dev/v1"
export OPENAI_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
qwen

A chave é um placeholder; cole a sua do painel do CheapTokens. Exportar OPENAI_API_KEY também é o que diz ao Qwen Code para usar autenticação compatível com OpenAI quando você configura tudo por variáveis de ambiente. OPENAI_MODEL tem um alias, QWEN_MODEL.

Um detalhe pega as pessoas: o id do modelo. Use o id completo da documentação do CheapTokens. O nome curto que você vê ao lado dos preços, deepseek-v4-flash-0731, não é aceito pela API, e os ids variam entre provedores.

Qual variável faz o quê? Faça a correspondência:

As exportações duram até você fechar o terminal. Para manter a configuração, use a próxima rota.

Rota 2: settings.json e uma chave fora do git#

Digamos que você compartilhe o repositório com uma equipe e ninguém queira uma chave em um arquivo de configuração. Então descreva o modelo em ~/.qwen/settings.json e mantenha a chave em um arquivo separado.

{
  "modelProviders": {
    "openai": [
      {
        "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
        "name": "DeepSeek-V4-Flash (CheapTokens)",
        "baseUrl": "https://api.cheaptokens.dev/v1",
        "description": "DeepSeek-V4-Flash through CheapTokens",
        "envKey": "CHEAPTOKENS_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek-ai/DeepSeek-V4-Flash-0731" }
}

Quatro campos carregam o peso:

• id é o id do modelo enviado à API, então deve ser o id completo.
• model.name precisa corresponder a um dos valores de id, caso contrário o Qwen Code não tem nada para selecionar.
• security.auth.selectedType definido como "openai" escolhe a rota compatível com OpenAI.
• envKey nomeia a variável que contém a chave. É opcional e o padrão é OPENAI_API_KEY.

A chave em si vai em .qwen/.env, que a documentação recomenda para segredos, e esse arquivo fica fora do git:

CHEAPTOKENS_API_KEY=sk-your-api-key

Há um motivo para preferir isso ao bloco env em settings.json: valores de env têm a prioridade mais baixa, e um arquivo com uma chave dentro é fácil de commitar por acidente. Mais sobre manter chaves seguras está em armazenar uma chave de API com segurança.

Após iniciar, /model mostra os modelos configurados e permite alternar. Para começar com um específico, execute qwen --model "deepseek-ai/DeepSeek-V4-Flash-0731".

Quanto custa uma sessão de programação#

Agentes de terminal são pesados em entrada: cada etapa carrega os arquivos e o histórico acumulados até ali. Pegue uma tarefa de 40 etapas e assuma 30.000 tokens de entrada e 1.000 tokens de saída por etapa. Isso dá 40 × 30.000 = 1.200.000 tokens de entrada e 40 × 1.000 = 40.000 tokens de saída. Aqui está a tarefa inteira com preços ao vivo:

Somando entrada e saída, o CheapTokens é mais barato que o OpenRouter para cada modelo da tabela. Para esse tipo de loop, o DeepSeek-V4-Flash se encaixa bem: contexto de 380K, até 32.768 tokens de saída em uma resposta, um preço a qualquer hora e um saldo para todos os modelos. Seus próprios números serão diferentes, então mova os controles:

Os preços estão na página de preços. Se você acompanha o uso em outro agente, quanto custa o Cline percorre a mesma aritmética.

Outros modelos para experimentar#

Trocar é só mudar o id, nada mais. Pegue-o na página de modelos ou em GET /v1/models:

• zai-org/GLM-5.3-Flash: contexto de 390K, até 8.192 tokens de saída por resposta e um preço total menor que o do OpenRouter.
• MiniMaxAI/MiniMax-M2.7: contexto de 180K, até 8.192 tokens de saída por resposta e um preço total menor que o do OpenRouter.

Altere OPENAI_MODEL, ou adicione uma segunda entrada a modelProviders.openai e alterne entre elas com /model.

Se o Qwen Code não conectar#

• O tipo de autenticação não é escolhido. Apenas com variáveis de ambiente, OPENAI_API_KEY precisa ser exportado. Com settings.json, verifique se selectedType é "openai".
• Modelo não encontrado. model.name deve ser igual a um id caractere por caractere, e o id deve ser o id completo do gateway.
• 401. A chave está ausente ou errada. Se você usa envKey, certifique-se de que essa variável realmente existe em .qwen/.env ou no seu shell.
• 404. Verifique se a URL base termina com /v1 e se o id não tem erro de digitação. O passo a passo completo está em API 401 ou 404: chave, URL base ou id de modelo errados.
• Uma variável parece ser ignorada. Valores em env dentro do settings.json têm a prioridade mais baixa, então uma variável definida em outro lugar vence.

A configuração para outros agentes de terminal segue o mesmo padrão, por exemplo OpenCode e Aider. Todo o resto, das chaves à primeira requisição, está na documentação do CheapTokens.