Configurar o Qwen Code: API Key, Base URL e leitura de arquivos

Conecte o Qwen Code ao BetterToken por modelProviders.openai em ~/.qwen/settings.json. Nos testes em macOS com um modelo GPT, o Qwen Code 0.26.0 concluiu solicitações de texto com Responses e Chat Completions.

As tarefas de leitura de arquivos foram instáveis nos testes com Qwen Code 0.26.0. Chat Completions retornou respostas finais vazias nas três tentativas; Responses retornou a resposta correta em duas de três. Os resultados das ferramentas continham o conteúdo correto do arquivo, mas a causa das falhas na resposta final não foi identificada. Ainda não dependa desta configuração para tarefas de leitura de arquivos.

Configurações principais

Campo	Valor
API Key	BetterToken API Key, referenciada por envKey
Base URL	https://bettertoken.ai/v1 em baseUrl
Modelo	YOUR_MODEL_ID
Configuração do provedor	modelProviders.openai
Formato da API	wireApi: "responses"

Pré-requisitos

• Node.js 22 ou superior para a instalação via npm abaixo
• Uma BetterToken API Key: cadastre-se e obtenha uma
• Um ID de modelo copiado da model plaza

Instalar

Use a opção npm do guia rápido oficial:

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

Configuração manual

Defina a API Key no terminal, substituindo YOUR_API_KEY:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Mescle estas configurações em ~/.qwen/settings.json. Substitua os dois valores de YOUR_MODEL_ID pelo mesmo ID de modelo exato:

{
  "modelProviders": {
    "openai": [
      {
        "id": "YOUR_MODEL_ID",
        "envKey": "BETTERTOKEN_API_KEY",
        "baseUrl": "https://bettertoken.ai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "YOUR_MODEL_ID"
  }
}

envKey indica o nome de uma variável de ambiente; não contém a própria API Key. A referência oficial de provedores de modelos também oferece suporte a wireApi: "chat-completions". Responses teve mais tentativas bem-sucedidas de leitura de arquivos neste teste, mas nenhum dos formatos passou em todas as tentativas.

Verificar a conexão

Execute esta verificação apenas de texto no mesmo terminal:

qwen -p "Reply with only: OK" --output-format stream-json --max-session-turns 4

Confira se a resposta final é OK. Uma solicitação de texto bem-sucedida não comprova que uma tarefa de leitura de arquivos produzirá uma resposta final correta; considere a limitação acima ao escolher seu fluxo de trabalho.

Trocar de modelo

Adicione uma entrada de modelo em modelProviders.openai, defina model.name com seu id exato e inicie uma nova sessão.

Erros comuns

Sintoma	O que verificar
Falha na autenticação	Exporte a variável indicada por envKey no terminal que executa o Qwen Code.
Endpoint incorreto	Use https://bettertoken.ai/v1 em baseUrl; wireApi seleciona o protocolo da solicitação.
Modelo não encontrado	Faça model.name corresponder a um id em modelProviders.openai.
Resposta vazia ou incorreta após ler um arquivo	Isso ocorreu na versão 0.26.0 mesmo com resultados corretos das ferramentas. Mudar para Responses não eliminou as falhas; use outro cliente testado para tarefas de leitura de arquivos.

Conteúdo relacionado

• Compare as ferramentas compatíveis
• Erros da API e limites de requisições
• Configuração do OpenCode

Detalhes técnicos

wireApi: "responses" seleciona /v1/responses; wireApi: "chat-completions" seleciona /v1/chat/completions. As duas rotas de texto passaram nos testes com Qwen Code 0.26.0. Os resultados de leitura de arquivos foram 2/3 e 0/3, respectivamente.