Pular para o conteúdo principal

O que é Qwen Code

O Qwen Code é um agente de programação de código aberto para o terminal. A configuração modelProviders dele lista os modelos que você pode usar e o protocolo de API de cada um. Esta configuração adiciona modelos da Capriole AI a essa lista.

Pré-requisitos

Antes de começar, confira se você tem:

Instalação

Instale o Qwen Code com npm (Node.js 22 ou posterior):
Ou instale com Homebrew:
Verifique a instalação:

Configuração

Validação dos modelos

O Qwen Code 0.25.3 passa nas verificações de leitura de arquivo, escrita de arquivo e resposta final pela Capriole AI com todos os modelos da seção Modelos suportados, usando a configuração abaixo. Coloque sua key em ~/.qwen/.env:
Crie ou atualize ~/.qwen/settings.json:
O que cada configuração faz:
  • Os modelos em openai usam Chat Completions. Os modelos GPT adicionam wireApi: "responses" para usar a API Responses.
  • Os modelos em anthropic usam Anthropic Messages. O baseUrl deles não tem /v1.
  • envKey indica a variável de ambiente que contém sua key. O Qwen Code envia a key como Bearer token para a Capriole AI.
  • contextWindowSize informa ao Qwen Code a janela de contexto de cada modelo.
  • security.auth.selectedType e model.name definem o modelo padrão. /model atualiza os dois quando você troca de modelo.

Executar Qwen Code

Inicie o Qwen Code no diretório do projeto:
Troque de modelo com /model. Para uma execução única, passe o prompt, o modelo e o tipo de autenticação do grupo dele:

Modelos suportados

openai-latest e claude-latest sempre apontam para o nosso modelo principal mais recente de cada família.

Solução de problemas

Por que o Qwen Code retorna um erro de autenticação?

Confirme que ~/.qwen/.env define CAPRIOLE_AI_API_KEY ou exporte a variável no mesmo shell.

Por que um modelo falha com um erro de protocolo?

Execute o modelo com o tipo de autenticação do grupo dele: --auth-type openai para modelos em openai e --auth-type anthropic para modelos em anthropic. O /model define isso para você.

Por que as solicitações Claude falham com Unsupported Claude Messages model?

Os modelos Claude em anthropic precisam dos IDs Claude sem prefixo, como claude-opus-5-5.

Observações

  • Mantenha sua key em ~/.qwen/.env, e não em settings.json.
  • Para adicionar outro modelo da Capriole AI, copie a entrada de um modelo da mesma família e altere o ID. GET https://api.caprioletech.com/v1/models lista todos os IDs de modelo.
  • Referências oficiais: Qwen Code e Provedores de modelo do Qwen Code.
Última modificação em 20 de outubro de 2026