在 CodeBuddy Code 中使用 Claude:自訂端點設定

設定三個環境變數,就能讓騰訊的 CodeBuddy Code CLI 透過 AI in IDE 使用 Claude Opus 5.5、Sonnet 5.5 或 Haiku 4.5。

已於 2026-11-06 以 @tencent-ai/codebuddy-code 2.180.0 測試:依下方設定,codebuddy -p 透過 claude-sonnet-5-5 與 claude-haiku-4-5-20251001 都有回覆。

快速設定

  1. 安裝 CLI。 執行 npm install -g @tencent-ai/codebuddy-code,再執行 codebuddy --version。
  2. 建立 API Key。 打開 API Keys 建立金鑰,渠道選 AWSQ 或 CCMAX。
  3. 設定環境變數。 加入 ~/.zshrc 或 ~/.bashrc,然後開一個新的終端機:
1
export CODEBUDDY_BASE_URL="https://api.aiinide.com/v1"
2
export CODEBUDDY_API_KEY="YOUR_DASHBOARD_API_KEY"
3
export CODEBUDDY_MODEL="claude-sonnet-5-5"

在 Windows PowerShell 中,使用 setx CODEBUDDY_BASE_URL "https://api.aiinide.com/v1",另外兩個也照同樣方式設定,然後開一個新視窗。

  1. 驗證。 執行 codebuddy -p "Reply with exactly: OK"。回覆是 OK,這筆請求也會出現在 Usage。

Base URL 結尾必須是 /v1

CodeBuddy Code 使用 OpenAI Chat Completions 格式,會自己加上 /chat/completions。填 https://api.aiinide.com/v1 時會呼叫 /v1/chat/completions,這個路徑接受 AWSQ 與 CCMAX 金鑰。只填主機位址時會呼叫 /chat/completions,也就是 Codex 渠道的路徑,並以 400 This endpoint requires a CODEX API key 失敗。

CodeBuddy 的文件說明,在非互動的 -p 模式下一定會使用 CODEBUDDY_API_KEY。如果互動式工作階段的請求沒有出現在 AI in IDE 的用量中,請用 /model 檢查該工作階段選用的帳號或模型。

支援模型

CODEBUDDY_MODEL渠道適合
claude-opus-5-5AWSQ、CCMAX高難度重構、長時間自動執行
claude-sonnet-5-5AWSQ、CCMAX日常寫程式
claude-haiku-4-5-20251001AWSQ、CCMAX快速修改、便宜的驗證呼叫

根據 CodeBuddy 的文件,CODEBUDDY_SMALL_FAST_MODEL 與 CODEBUDDY_CODE_SUBAGENT_MODEL 分別設定背景模型與子代理模型;設成 claude-haiku-4-5-20251001 可以壓低成本。費率請看模型與定價。

常見問題

CodeBuddy Code 接 AI in IDE 要用哪個 Base URL?

https://api.aiinide.com/v1。CodeBuddy 會加上 /chat/completions;只填主機位址會連到 Codex 路徑並回傳 400。

這在 CodeBuddy IDE 外掛中可以用嗎?

本頁只涵蓋 CodeBuddy Code CLI。IDE 外掛的模型設定沒有測試過。

Claude 專屬的工具功能能透過這個端點使用嗎?

相容 OpenAI 的端點支援文字、串流與用戶端 function tools。它不支援 Fast mode 或託管工具等 Claude 擴充功能;需要這些功能請用 Claude Code。

相關頁面

在 CodeBuddy Code 中使用 Claude:自訂端點設定|AI in IDE