Configurar Qwen Code: API Key, Base URL y modelos

Conecta Qwen Code a BetterToken mediante modelProviders.openai en ~/.qwen/settings.json. En pruebas en macOS con un modelo GPT, Qwen Code 0.26.0 completó solicitudes de texto con Responses y Chat Completions.

Las tareas de lectura de archivos no fueron fiables en las pruebas con Qwen Code 0.26.0. Chat Completions devolvió respuestas finales vacías en los tres intentos; Responses devolvió la respuesta correcta en dos de tres. Los resultados de las herramientas contenían el contenido correcto del archivo, pero aún no se ha identificado la causa de los fallos en la respuesta final. Por ahora, no confíes en esta configuración para tareas de lectura de archivos.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key, indicada mediante envKey
Base URL	https://bettertoken.ai/v1 en baseUrl
Modelo	YOUR_MODEL_ID
Configuración del proveedor	modelProviders.openai
Formato de API	wireApi: "responses"

Requisitos previos

• Node.js 22 o posterior para la instalación con npm siguiente
• Una BetterToken API Key: Regístrate y obtén una
• Un Model ID copiado de la model plaza

Instalación

Usa la opción npm de la guía de inicio rápido oficial:

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

Configuración manual

Define la API Key en tu terminal y sustituye YOUR_API_KEY:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Combina estos ajustes con ~/.qwen/settings.json. Sustituye ambos valores YOUR_MODEL_ID por el mismo Model ID exacto:

{
  "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 el nombre de una variable de entorno; no contiene la API Key. La referencia oficial de proveedores de modelos también admite wireApi: "chat-completions". Responses tuvo más aciertos al leer archivos en esta prueba, pero ninguno de los formatos superó todos los intentos.

Verificar la conexión

Ejecuta esta prueba solo de texto en el mismo terminal:

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

Comprueba que la respuesta final contenga OK. Que una solicitud de texto se complete correctamente no garantiza una respuesta final correcta en una tarea de lectura de archivos; ten en cuenta esta limitación al elegir tu flujo de trabajo.

Cambiar de modelo

Añade una entrada de modelo en modelProviders.openai, asigna a model.name su id exacto e inicia una sesión nueva.

Errores frecuentes

Síntoma	Qué comprobar
Falla la autenticación	Exporta la variable indicada por envKey en el terminal donde se ejecuta Qwen Code.
Endpoint incorrecto	Usa https://bettertoken.ai/v1 en baseUrl; wireApi selecciona el protocolo de solicitud.
No se encuentra el modelo	Haz que model.name coincida con un id de modelProviders.openai.
Respuesta vacía o incorrecta después de leer un archivo	Esto ocurrió incluso cuando los resultados de las herramientas eran correctos en la versión 0.26.0. Cambiar a Responses no eliminó los fallos; usa otro cliente probado para tareas de lectura de archivos.

Enlaces relacionados

• Comparar herramientas compatibles
• Errores de API y límites de solicitudes
• Configurar OpenCode

Detalles técnicos

wireApi: "responses" selecciona /v1/responses; wireApi: "chat-completions" selecciona /v1/chat/completions. Ambas rutas de texto superaron las pruebas con Qwen Code 0.26.0. Los resultados de lectura de archivos fueron 2/3 y 0/3, respectivamente.