RealRelay.ai
程式碼代理

Qwen Code 設定指南

把 RealRelay.ai 設為 Qwen Code 的 OpenAI 相容供應商:安裝、在 ~/.qwen/settings.json 中新增模型項目、檢查連線並切換模型。

建立 API 密鑰瀏覽模型目錄
協定
OpenAI Chat Completions · OpenAI Responses
基礎位址
https://www.realrelay.ai/v1
官方文件
qwenlm.github.io
已對照工具官方文件核對
2026-10

概覽

Qwen Code 是 Qwen 團隊推出的終端機程式碼代理。它會讀取你的專案、編輯檔案並執行指令。它能與任何 OpenAI 相容服務通訊,因此是連到 RealRelay.ai 的 Chat Completions 端點 /v1/chat/completions。

  • 一組 API 金鑰,在主控台的 API 金鑰頁面取得。

  • 結尾要含 /v1 的基礎位址。Qwen Code 會在後面加上 /chat/completions。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 z-ai/glm-5.2。該模型必須支援工具呼叫。

Qwen Code 的 /auth 選單提供 QwenCloud、Alibaba ModelStudio 以及一份第三方服務清單。RealRelay.ai 不在其中;請改用下方的設定檔。

安裝

npm 套件需要 Node.js 22 或更新版本。Qwen Code 的 README 也列出了 Homebrew 與它自己的獨立安裝程式。

npm (Node.js 22+)
npm install -g @qwen-code/qwen-code@latestqwen --version
Homebrew (macOS · Linux)
brew install qwen-code
macOS · Linux
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
Windows PowerShell
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

如果 qwen --version 印出版本號,就代表安裝成功。使用獨立安裝程式後,請先開啟新的終端機。

設定

  1. 1

    把金鑰存進環境變數

    設定檔會從 REALRELAY_API_KEY 讀取金鑰,所以檔案本身不含任何機密。你可以在 shell 中設定,或寫進 ~/.qwen/.env,Qwen Code 啟動時會載入它。

    ~/.zshrc · ~/.bashrc
    export REALRELAY_API_KEY="sk-***"
    Windows PowerShell
    [Environment]::SetEnvironmentVariable("REALRELAY_API_KEY", "sk-***", "User")

    關閉並重新開啟終端機,讓它讀到新的變數。

    ~/.qwen/.env
    REALRELAY_API_KEY=sk-***
  2. 2

    在 settings.json 中新增模型

    如果檔案不存在,請先建立。在 Windows 上,它位於 %USERPROFILE%.qwen\settings.json。Qwen Code 建議把供應商設定放在這份使用者檔案中,而不是專案的 .qwen/settings.json。

    ~/.qwen/settings.json
    1{2  "modelProviders": {3    "openai": [4      {5        "id": "z-ai/glm-5.2",6        "name": "z-ai/glm-5.2 (RealRelay.ai)",7        "baseUrl": "https://www.realrelay.ai/v1",8        "envKey": "REALRELAY_API_KEY",9        "generationConfig": {10          "contextWindowSize": 20000011        }12      }13    ]14  },15  "security": {16    "auth": {17      "selectedType": "openai"18    }19  },20  "model": {21    "name": "z-ai/glm-5.2"22  }23}

  • modelProviders 底下的 openai 指的是協定,不是廠商。這份清單中的每個項目都會以 OpenAI 格式的請求送出。請不要改名:Qwen Code 會略過它不認得的供應商名稱。

  • id 是送到 RealRelay.ai 的模型 ID。envKey 指定存放金鑰的變數名稱。

  • contextWindowSize 告訴 Qwen Code 模型的視窗有多大。沒有設定時,Qwen Code 會依模型名稱猜測,而 RealRelay.ai 的模型清單並不含這個數字。

  • selectedType 與 model.name 讓 Qwen Code 直接以這個模型啟動,不會要求你執行 /auth。model.name 必須與上方某個 id 相同。

若想不用設定檔快速測試,設定三個標準 OpenAI 變數就夠了。不過其他讀取 OPENAI_API_KEY 的工具也會套用這些變數,所以日常使用請以設定檔為主。

Terminal
1export OPENAI_API_KEY="sk-***"2export OPENAI_BASE_URL="https://www.realrelay.ai/v1"3export OPENAI_MODEL="z-ai/glm-5.2"4qwen

驗證

  1. 1

    直接呼叫端點

    用你的金鑰執行這段指令。若收到含 choices 陣列的 JSON 回覆,就代表位址、金鑰與模型都沒問題。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    從終端機送出一個提示詞

    這會在不開啟互動畫面的情況下執行 Qwen Code,並印出回覆。

    Terminal
    qwen -p "Reply with OK"
  3. 3

    檢查工作階段

    在專案中啟動 qwen,並執行 /doctor。它會顯示驗證類型與環境檢查結果。送出一則簡短訊息,該請求會出現在主控台的用量日誌中。

    Qwen Code
    cd /path/to/your/projectqwen/doctor

模型

你想使用的每個模型,都是 openai 清單中的一個項目。每個模型新增一個項目,然後在工作階段中以 /model 切換。你的選擇會保留到下一次工作階段。

~/.qwen/settings.json → modelProviders.openai
1{2  "id": "z-ai/glm-5.2",3  "name": "z-ai/glm-5.2 (RealRelay.ai)",4  "baseUrl": "https://www.realrelay.ai/v1",5  "envKey": "REALRELAY_API_KEY",6  "generationConfig": { "contextWindowSize": 200000 }7},8{9  "id": "<another-model-id>",10  "name": "<another-model-id> (RealRelay.ai)",11  "baseUrl": "https://www.realrelay.ai/v1",12  "envKey": "REALRELAY_API_KEY",13  "generationConfig": { "contextWindowSize": 128000 }14}

若只想在單次執行中選用某個模型,請在命令列傳入:

Terminal
qwen --model "z-ai/glm-5.2"

這些範例中的視窗大小是安全的起始值。請把 contextWindowSize 設為模型目錄頁面上的實際上限。若要限制輸出長度,請設定 QWEN_CODE_MAX_OUTPUT_TOKENS 環境變數。

少數 OpenAI 模型是在 Responses 端點 /v1/responses 上提供。請在這些模型的項目中加上 wireApi,讓 Qwen Code 把請求送到那裡:

~/.qwen/settings.json → modelProviders.openai
1{2  "id": "openai/gpt-5.3-codex",3  "name": "openai/gpt-5.3-codex (RealRelay.ai, Responses)",4  "wireApi": "responses",5  "baseUrl": "https://www.realrelay.ai/v1",6  "envKey": "REALRELAY_API_KEY",7  "generationConfig": { "contextWindowSize": 400000 }8}

哪些模型適合代理使用、哪些模型由 Responses 端點提供,請見選擇模型。

疑難排解

  • Qwen Code 啟動時開啟 /auth 選單。它沒有找到可用的設定。請確認 selectedType 為 openai,且 model.name 與清單中某個 id 相同。

  • /model 中沒有該模型。modelProviders 底下的供應商鍵不是 openai,或 JSON 有語法錯誤。

  • 401。金鑰沒有送達 RealRelay.ai。在 shell 中 export 的金鑰優先於 .env 檔案,而 .env 檔案又優先於 settings.json 的 env 區塊;優先順序較高處的舊值,會蓋掉新值。

  • 404。基礎位址缺少 /v1,或已經以 /chat/completions 結尾。請使用以 /v1 結尾的位址。

  • 找不到模型。id 必須與 GET /v1/models 傳回的 ID 完全相同,包括斜線之前的部分。

  • 長時間工作階段中出現上下文錯誤。contextWindowSize 沒有設定,或大於模型的實際視窗。請依目錄頁面設定。

  • 設定了 wireApi: "responses" 的模型出現錯誤。只有「選擇模型」中列出的模型在 /v1/responses 上提供。其他模型請移除 wireApi。