Qwen Code

O Qwen Code lê seus endpoints de modelProviders em ~/.qwen/settings.json — uma entrada com baseUrl e envKey coloca Claude e GPT no seletor /model.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

Passo a passo

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. Abra ~/.qwen/settings.json (crie-o se não existir) e mescle os quatro blocos acima. A documentação recomenda declarar modelProviders no arquivo do escopo do usuário “para evitar conflitos de mesclagem entre as configurações do projeto e do usuário”.
3. Se possível, guarde a chave em um lugar mais seguro que env. O Qwen Code a lê de process.env[envKey], e a documentação classifica as fontes da mais prioritária à menos prioritária: um export do shell, depois um arquivo .env, e por fim o bloco env em settings.json — que é identificado como armazenamento em texto simples. O bloco env acima é o mínimo necessário para funcionar, não a melhor opção para manter.
4. Execute qwen. Com security.auth.selectedType definido como openai e model.name correspondendo a um id que você declarou, não é necessário passar pela etapa interativa /auth — a documentação diz isso explicitamente após o exemplo de arquivo único.
5. Dê a ele uma tarefa que leia e edite um arquivo, não uma saudação. O Qwen Code é um agente: chamadas de ferramentas e streaming são o que uma primeira execução deve exercitar e são os primeiros recursos a falhar em um endpoint que só seja parcialmente compatível.
6. Adicione mais entradas em modelProviders.openai para alternar modelos durante a execução com /model. Essas edições são recarregadas automaticamente em uma sessão em andamento; providerProtocol é lido uma vez na inicialização e exige uma reinicialização.

Verificado em Página de autenticação do Qwen Code, opção 4: Chave de API (flexível) em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Qwen Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

Três pontos que a documentação esclarece e muita gente supõe errado

Essas informações vêm da página de autenticação e da referência de provedores de modelos citadas acima. Supor em vez de consultar cada uma delas gera um custo real de depuração.

1. Uma entrada modelProviders tem prioridade sobre os argumentos da CLI. A ordem documentada, da mais prioritária à menos prioritária, é: substituições feitas por /auth na sessão em andamento, depois o envKey do provedor de modelos selecionado, depois argumentos da CLI como --openai-api-key, em seguida variáveis de ambiente e, por fim, security.auth.apiKey nas configurações. A maioria das pessoas espera que o argumento prevaleça. Não prevalece — por isso --openai-base-url pode parecer ser ignorado.
2. security.auth.apiKey e security.auth.baseUrl foram descontinuados. A referência informa isso e recomenda migrar para modelProviders. Se um tutorial antigo orienta você a editar essas duas chaves, ele está indicando uma configuração que está sendo descontinuada.
3. wireApi escolhe o formato da solicitação, e nada detecta uma incompatibilidade. Se você não o especificar, será usado Chat Completions, como no bloco acima. Definir "wireApi": "responses" exige um endpoint realmente compatível com Responses, e a documentação afirma claramente que não há detecção de endpoint nem fallback automático quando uma solicitação falha. A Kunavo também responde em /v1/responses e em /v1/chat/completions, mas esta página não testou nenhuma das duas combinações, então comece com o padrão.

Se você chegou aqui procurando o plano gratuito

Boa parte do que ainda se escreve sobre o Qwen Code descreve um login OAuth do Qwen com uma cota diária gratuita. Essa opção não está mais disponível: a documentação registra que o plano gratuito foi descontinuado em 15 de abril de 2026 e informa que o Qwen OAuth não é mais uma opção selecionável na janela /auth. As três opções listadas agora são Alibaba ModelStudio — com Coding Plan, Token Plan e Standard API Key no submenu —, Third-party Providers e Custom Provider, descrito como uma forma de conectar “um servidor local, proxy ou provedor sem suporte”. A Kunavo é a terceira dessas opções. Observe também que as opções do submenu ModelStudio não são três formas de pagar uma única fatura: cada uma tem seu próprio host e sua própria chave, e uma chave Coding Plan não funcionará em um host Token Plan.