RealRelay.ai
程式碼代理

Cline 設定指南

以 OpenAI Compatible 供應商將 VS Code 與 JetBrains 的 Cline 擴充功能接上 RealRelay.ai:安裝、填入基礎位址、金鑰與模型、設定模型上限並檢查連線。

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

概覽

Cline 是在編輯器中執行的開源程式碼代理。它會規劃修改、編輯檔案並執行終端機指令;除非你允許它直接進行,否則每一步之前都會先詢問你。要把它接上 RealRelay.ai,請使用它的 OpenAI Compatible 供應商,這個供應商會把請求送到 Chat Completions 端點 /v1/chat/completions。

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

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

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 z-ai/glm-5.2。請挑選支援工具呼叫、上下文至少 64K 的模型。

Cline 無法從 RealRelay.ai 讀取模型的上下文視窗或輸出上限。如果留空,它會假設視窗為 128,000 token。請依「設定」一節的說明自行設定。

安裝

請從編輯器本身的擴充功能市集安裝 Cline,不需要另外下載。

  1. 1

    開啟擴充功能

    在 Windows 與 Linux 上按 Ctrl+Shift+X,在 macOS 上按 Cmd+Shift+X。

  2. 2

    安裝 Cline

    搜尋 Cline 並點選 Install。同樣的步驟也適用於 Cursor、Windsurf 與 VSCodium。

  3. 3

    開啟 Cline

    點選側邊欄中的 Cline 圖示。

  1. 1

    開啟外掛市集

    前往 Settings → Plugins → Marketplace。

  2. 2

    安裝 Cline

    搜尋 Cline,點選 Install,然後重新啟動 IDE。

  3. 3

    開啟 Cline

    前往 View → Tool Windows → Cline。

Cline 也提供自家的付費帳戶與訂閱方案。使用 RealRelay.ai 時兩者都不需要:只要在設定中選擇你自己的供應商即可。

設定

  1. 1

    開啟設定

    點選 Cline 面板頂端的設定圖示(⚙)。

  2. 2

    選擇供應商

    在 API Provider 清單中選擇 OpenAI Compatible。

  3. 3

    填寫連線資訊

    輸入基礎位址,以你的金鑰取代 sk-***,然後輸入或選取模型 ID。

    Cline → Settings (⚙) → API Configuration
    1API Provider:  OpenAI Compatible2Base URL:      https://www.realrelay.ai/v13API Key:       sk-***4Model ID:      z-ai/glm-5.2
  4. 4

    設定模型上限

    點選 Model Configuration 展開,然後填寫下列欄位。請使用模型目錄頁面上的數字;這裡顯示的值是安全的下限,而不是模型的實際上限。

    Cline → Settings → Model Configuration
    Supports Images:      off (on only for models that accept images)Context Window Size:  200000Max Output Tokens:    32000

  • Base URL 是唯一決定請求送往何處的欄位。它必須以 /v1 結尾,後面不能再接任何內容。

  • Model ID 要保留斜線之前的部分。單獨的 glm-5.2 不是 RealRelay.ai 的模型 ID。

  • Context Window Size 讓 Cline 知道對話何時快要滿了。Max Output Tokens 限制單次回覆的長度。

  • Supports Images 預設為開啟。對於純文字模型請把它關閉,以免 Cline 把螢幕截圖送給它們。

  • 請讓 Use Azure Identity Authentication 保持關閉。RealRelay.ai 使用的是 API 金鑰。

驗證

  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

    交給 Cline 一個小任務

    開啟一個專案資料夾,建立新任務,並送出一個會讓 Cline 使用工具、但不會改動任何東西的請求。

    Cline → New task
    List the files in this folder and say which one looks like the entry point. Do not change anything.
  3. 3

    檢查結果

    Cline 應會先請求讀取資料夾,然後作答。這表示模型能呼叫工具。該請求也會出現在主控台的用量日誌中。

模型

要切換模型,請開啟設定並修改 Model ID。填好基礎位址與金鑰後,Cline 會從 RealRelay.ai 載入模型清單,你可以從中選取或直接輸入 ID。每次都要一併更新 Model Configuration,因為上限是跟著模型走的。

Cline 有兩種模式:Plan 只讀取與討論,Act 則實際進行修改。若想用較強的模型做規劃、用較快的模型做編輯,請在設定中開啟 Use different models for Plan and Act modes,再分別設定每種模式。

適合程式碼代理的模型,列於選擇模型。

疑難排解

  • 「Invalid API Key」或 401。金鑰錯誤,或頭尾多了空格。請從主控台重新貼上。

  • 404。基礎位址缺少 /v1,或已經以 /chat/completions 結尾。它應以 /v1 結尾。

  • 「Model Not Found」。模型 ID 與 GET /v1/models 傳回的不完全相同。請檢查前綴與大小寫。

  • 模型清單一直是空的。Cline 無法讀取 /v1/models,通常是因為基礎位址或金鑰有誤。請先修正這兩項。你仍可手動輸入模型 ID。

  • 長任務中出現上下文錯誤,或對話過早被截斷。Model Configuration 中的上下文視窗與模型不符。請設為模型的實際上限。

  • 附加圖片時出現錯誤。該模型只支援文字。請關閉 Supports Images,或改選接受圖片的模型。

  • Plan 模式正常但 Act 模式失敗,或反過來。你開啟了 Plan 與 Act 分別使用不同模型,而其中一種模式仍是舊設定。請把兩種模式都設定好。

  • 模型會回答,卻從不編輯檔案或執行指令。Cline 會送出很長的提示詞,並仰賴工具呼叫。請從目錄中選擇支援工具呼叫的模型。