RealRelay.ai
程式碼代理

CodeBuddy Code 設定指南

把 RealRelay.ai 設為騰訊 CodeBuddy Code 的自訂模型:安裝、以完整的 Chat Completions URL 在 models.json 中新增模型、檢查連線並切換模型。

建立 API 密鑰瀏覽模型目錄
協定
OpenAI Chat Completions
基礎位址
https://www.realrelay.ai/v1
官方文件
www.codebuddy.ai
已對照工具官方文件核對
2026-10
實驗性. 尚未在 RealRelay.ai 上完整端對端測試。步驟依據該工具的官方文件；若某一步失敗，請附上錯誤訊息聯絡支援。

概覽

CodeBuddy Code 是騰訊推出的終端機程式碼代理。它會讀取你的專案、編輯檔案並執行指令。你可以在名為 models.json 的檔案中,把 RealRelay.ai 的模型加為自訂模型。自訂模型使用 OpenAI Chat Completions 格式,所以請求會送到 /v1/chat/completions。

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

  • 以 /v1/chat/completions 結尾的完整端點 URL。與大多數工具不同,CodeBuddy Code 不會替你補上路徑。

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

這套設定依據 CodeBuddy 的文件撰寫,但尚未在 RealRelay.ai 上完整端對端跑過。CodeBuddy Code 第一次啟動時會要求你登入 CodeBuddy 帳戶,而它的文件並未說明不登入時自訂模型能否運作。本頁只涵蓋終端機代理,不涵蓋 CodeBuddy IDE 外掛或 WorkBuddy。

安裝

可以用 npm 安裝(需要 Node.js 18.20 或更新版本),或使用騰訊的 Homebrew tap(不需要 Node.js)。

npm (Node.js 18.20+)
npm install -g @tencent-ai/codebuddy-codecodebuddy --version
Homebrew (macOS · Linux)
brew install Tencent-CodeBuddy/tap/codebuddy-codecodebuddy --version

如果 codebuddy --version 印出版本號,就代表安裝成功。如果找不到指令,請開啟新的終端機,讓它讀到更新後的 PATH。

第一次執行 codebuddy 時,會出現登入畫面。中國以外的使用者請選擇 International Site(國際站)。

設定

  1. 1

    把金鑰存進環境變數

    這樣金鑰就不會出現在設定檔中。完成後請開啟新的終端機。

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

    在 models.json 中新增模型

    如果檔案不存在,請先建立。在 Windows 上,它位於 %USERPROFILE%\.codebuddy\models.json。CodeBuddy Code 約一秒內就會偵測到變更,所以不需要重新啟動。

    ~/.codebuddy/models.json
    1{2  "models": [3    {4      "id": "z-ai/glm-5.2",5      "name": "z-ai/glm-5.2 (RealRelay.ai)",6      "vendor": "RealRelay.ai",7      "url": "https://www.realrelay.ai/v1/chat/completions",8      "apiKey": "${REALRELAY_API_KEY}",9      "maxInputTokens": 200000,10      "maxOutputTokens": 32000,11      "supportsToolCall": true,12      "supportsImages": false13    }14  ]15}

  • id 是送到 RealRelay.ai 的模型 ID。name 只是模型清單中顯示的標籤。

  • url 必須是完整路徑。只寫到 /v1 的 URL 在這裡無法運作。

  • CodeBuddy Code 啟動時,apiKey 會從 REALRELAY_API_KEY 讀取金鑰。如果沒有設定該變數,預留位置字串會原封不動地送出,請求就會失敗。

  • 在這個範例中,maxInputTokens 與 maxOutputTokens 是安全的下限值。請換成模型目錄頁面上標示的上限。

  • supportsToolCall 必須為 true,代理才能編輯檔案與執行指令。只有接受圖片的模型,才把 supportsImages 設為 true。

  • 專案內的 .codebuddy/models.json 會覆寫你家目錄中的那一份。不要把金鑰放進會提交的檔案。

驗證

  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

    以該模型啟動 CodeBuddy Code

    在專案中以選定的模型啟動它,然後列出它所知道的模型。

    CodeBuddy Code
    cd /path/to/your/projectcodebuddy --model z-ai/glm-5.2/model list
  3. 3

    檢查清單並送出訊息

    你的模型應出現在清單中,並帶有 custom 標記。送出一則簡短訊息;收到回覆即確認整條路徑暢通,而該請求也會出現在主控台的用量日誌中。

模型

你想使用的每個 RealRelay.ai 模型,都在 models 清單中新增一個項目,並各自設定上限。接著在工作階段中以 /model 加上 ID 切換,或以 codebuddy --model 啟動。任務執行中時無法切換模型。

CodeBuddy Code
/model z-ai/glm-5.2

若只想在清單中顯示部分模型,請加上一個列出其 ID 的 availableModels 陣列。設定之後,所有不在其中的模型都會被隱藏,內建模型也一樣。

CodeBuddy Code 還會用一個較輕量的模型處理背景工作,並用一個推理模型處理困難的步驟。沒有為這兩者另外設定的自訂模型,會兩者都由自己擔任,所以一開始只要一個項目就夠了。適合程式碼代理的模型,列於選擇模型。

疑難排解

  • 模型沒有出現在 /model list 中。JSON 無效、檔案沒有存在 ~/.codebuddy/ 中,或是 availableModels 陣列中漏了該 ID。專案層級的 availableModels 會完全取代你家目錄中的那一份。

  • 401。啟動 CodeBuddy Code 的終端機中沒有設定 REALRELAY_API_KEY。請開啟新的終端機,以 echo $REALRELAY_API_KEY 確認,再重新啟動。

  • 404。url 只寫到 /v1。請加上 /chat/completions。

  • 找不到模型。id 與 GET /v1/models 傳回的不完全相同。請保留斜線前的前綴。

  • 回覆被截斷。maxOutputTokens 對這項任務來說太低。請調高,但不超過模型的上限。

  • 長任務中出現上下文錯誤。maxInputTokens 高於模型的實際視窗。請設為模型的上限。

  • 修改檔案後沒有效果。變更沒有存到磁碟,或是專案層級的 models.json 定義了相同的 id 而優先生效。