如何在 Claude Code 中使用 CoBuddy(透過 Novita AI)

如何在 Claude Code 中使用 CoBuddy(透過 Novita AI)

CoBuddy 是百度在 Novita AI 上提供的程式碼專用模型,支援函式呼叫、推理、128K 上下文視窗,以及適合開發者工作流程的低端到端延遲。由於 CoBuddy 只提供 OpenAI 相容的 chat/completions 端點,而非 Anthropic 相容端點,因此在 Claude Code 中設定時,需要將 ANTHROPIC_BASE_URL 指向 Novita AI 的 OpenAI 相容路徑。本指南會逐步帶您從取得 API 金鑰到開啟第一個工作階段。

CoBuddy 是什麼?

CoBuddy 是百度開發的程式碼生成模型,可透過 Novita AI 的 LLM API 使用。它專為軟體開發任務設計:生成程式碼、重構、編寫測試、規劃實作以及支援代理工作流程。

規格 詳細資料
模型 ID baidu/cobuddy
上下文視窗 131,072 個 Token(128K)
最大輸出 65,536 個 Token
輸入價格 $2.80 / 1M Token
輸出價格 $11.30 / 1M Token
快取讀取 $0.70 / 1M Token
功能 函式呼叫、推理
端點 僅 OpenAI 相容 chat/completions

端點的差異對於 Claude Code 設定至關重要。CoBuddy 不支援 Anthropic 相容端點,因此設定時需使用 Novita AI 的 OpenAI 相容基礎 URL(https://api.novita.ai/v3/openai),而非 anthropic 路徑。

為什麼要在 Claude Code 中使用 CoBuddy?

Claude Code 是一個代理式 CLI,讓您能用自然語言委派編碼任務——檔案編輯、終端機指令、程式碼庫分析以及多步驟工作流程。預設情況下它使用 Claude 模型,但 ANTHROPIC_BASE_URL 環境變數可讓您將請求路由至不同的提供者和模型。

透過 Novita AI 換用 CoBuddy 可為您帶來:

  • 編碼專門化。 CoBuddy 專為軟體任務而非一般對話而建構。它直接針對程式碼生成、審查和代理工作流程進行最佳化。
  • 與 Claude Sonnet 的成本差異。 Claude Sonnet 4.5 的費用為 $3.00/M 輸入 Token、$15.00/M 輸出 Token。Novita AI 上的 CoBuddy 則為 $2.80/M 輸入 Token 與 $11.30/M 輸出 Token——在大用量下能節省可觀成本,快取讀取僅 $0.70/M。
  • 高吞吐量與低端到端延遲。 Novita AI 的 CoBuddy 部署針對持續吞吐量進行調校,這對於需要多次增量請求的長時間代理工作階段非常重要。
  • 128K 上下文視窗。 足夠的空間讓您在單一提示中傳入大量程式碼片段、測試輸出和實作筆記。

對於已經在使用 Claude Code、想要評估編碼優先的替代方案但不想改變工作流程工具團隊來說,CoBuddy 是一個實用的起點。

步驟 1:取得您的 Novita AI API 金鑰

建立 Novita AI 帳戶——新帳戶可獲得免費試用額度。登入後,前往 Key Management 並點擊 Create New Key。請立即複製金鑰,因為它只會顯示一次。

步驟 2:安裝 Claude Code

Claude Code 需要 Node.js 18 或更高版本。請確認您的版本:

node --version

如果 Node.js 缺失或低於 v18,請從 nodejs.org 安裝。

全域安裝 Claude Code:

npm install -g @anthropic-ai/claude-code

確認安裝成功:

claude --version

步驟 3:設定環境變數

CoBuddy 僅支援 OpenAI 相容端點。將 ANTHROPIC_BASE_URL 設為 Novita AI 的 OpenAI 相容路徑,以便 Claude Code 將請求轉發至該處。

macOS 與 Linux

export ANTHROPIC_BASE_URL="https://api.novita.ai/v3/openai"
export ANTHROPIC_AUTH_TOKEN="<您的 Novita API 金鑰>"
export ANTHROPIC_MODEL="baidu/cobuddy"
export ANTHROPIC_SMALL_FAST_MODEL="baidu/cobuddy"

Windows(命令提示字元)

set ANTHROPIC_BASE_URL=https://api.novita.ai/v3/openai
set ANTHROPIC_AUTH_TOKEN=<您的 Novita API 金鑰>
set ANTHROPIC_MODEL=baidu/cobuddy
set ANTHROPIC_SMALL_FAST_MODEL=baidu/cobuddy

Windows(PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/v3/openai"
$env:ANTHROPIC_AUTH_TOKEN = "<您的 Novita API 金鑰>"
$env:ANTHROPIC_MODEL = "baidu/cobuddy"
$env:ANTHROPIC_SMALL_FAST_MODEL = "baidu/cobuddy"

每個變數的作用:

  • ANTHROPIC_BASE_URL — 將 Claude Code 的請求重導至 Novita AI 的 OpenAI 相容端點,而非 Anthropic 的伺服器
  • ANTHROPIC_AUTH_TOKEN — 用於驗證的 Novita AI API 金鑰
  • ANTHROPIC_MODEL — 用於主要(複雜)任務的模型
  • ANTHROPIC_SMALL_FAST_MODEL — 用於背景及輕量任務的模型

若要在 macOS/Linux 上跨終端機工作階段保持這些設定,請將 export 行加入您的 ~/.zshrc~/.bashrc

步驟 4:啟動 Claude Code

切換到您的專案目錄並啟動 Claude Code:

cd /path/to/your/project
claude .

. 告訴 Claude Code 在目前目錄下運作。您將會看到一個互動式提示,您可以用自然語言描述任務。

執行 /model 確認目前使用的模型,或執行 /doctor 診斷設定問題。

CoBuddy 規格與定價

以下是 Novita AI 上的 CoBuddy 與 Claude Sonnet 4.5 的完整比較:

CoBuddy(Novita AI) Claude Sonnet 4.5
輸入(每 1M Token) $2.80 $3.00
輸出(每 1M Token) $11.30 $15.00
快取讀取(每 1M Token) $0.70 $0.30
上下文視窗 131,072 個 Token 200,000 個 Token
最大輸出 65,536 個 Token 64,000 個 Token
函式呼叫
推理
Anthropic 端點 原生

主要的取捨:CoBuddy 的輸出 Token 價格低於 Sonnet 4.5,且對於重複使用上下文的大量代理工作階段,快取讀取在絕對成本上更便宜。Claude Sonnet 4.5 具有更大的上下文視窗,且是 Claude Code 的原生模型。當您想要一個專注於編碼且輸出成本較低的模型時,選擇 CoBuddy;當您需要完整的 200K 上下文或更廣泛的推理任務時,則繼續使用 Sonnet。

實用的編碼工作流程技巧

讓提示保持任務明確

CoBuddy 針對軟體任務進行調校。描述具體工程成果的提示——例如「為這個函式加入輸入驗證」、「為結帳流程編寫一個單元測試」、「重構這個模組以消除循環依賴」——能獲得比開放式探索提示更好的結果。

有意識地使用 128K 上下文視窗

在 128K Token 的空間內,您可以一次傳入相關的程式碼片段、測試輸出、風格指南和 API 合約。不過,請保持提示的結構化:說明任務、提供精選上下文、列出限制條件,然後要求有明確範圍的輸出。長上下文不代表可以取代清晰的指令。

驗證函式呼叫的輸出

CoBuddy 支援函式呼叫,Claude Code 會使用它來進行工具呼叫。對於修改檔案或執行指令的任務,請在批准前審查擬採取的動作。在 Claude Code 中使用 /review 來檢查變更內容後再套用。

大量使用快取的工作階段受益於 CoBuddy 的定價

在快取讀取 Token 價格為 $0.70/M 的情況下,包含大型系統提示或重複上下文的工作階段會隨著時間明顯降低成本。如果您執行長時間的代理工作階段,反覆參考相同的程式碼庫上下文,快取讀取會不斷累積——而 CoBuddy 的快取讀取價格極具競爭力。

在實際任務上評估後再決定採用

評估 CoBuddy 是否適合您團隊的最佳方式,就是在您實際的待辦事項上執行它:一個錯誤工單、一項測試生成任務、一個小型重構。根據這些特定任務的輸出品質與您目前的模型進行比較,而不是依賴通用的基準測試。

常見問題

Novita AI 上 CoBuddy 的模型 ID 是什麼?

ANTHROPIC_MODEL 環境變數以及任何直接的 API 請求主體中,請使用 baidu/cobuddy

為什麼要使用 https://api.novita.ai/v3/openai 而不是 anthropic 端點?

CoBuddy 僅支援 OpenAI 相容的 chat/completions 端點。將 ANTHROPIC_BASE_URL 設為 Novita AI 的 OpenAI 相容路徑(https://api.novita.ai/v3/openai),會告訴 Claude Code 將請求路由至該端點。Anthropic 相容路徑(https://api.novita.ai/anthropic)適用於原生實作 Anthropic Messages API 的模型——而 CoBuddy 並不適用。

CoBuddy 在 Novita AI 上的費用是多少?

截至 2026 年 6 月:輸入 $2.80/M Token、輸出 $11.30/M Token、快取讀取 $0.70/M Token。請在生產規劃前至 CoBuddy 模型頁面 確認最新定價。

CoBuddy 支援函式呼叫嗎?

是的。CoBuddy 支援函式呼叫與推理,這兩者都是 Claude Code 代理迴圈所需的。

我可以在 Cursor 或其他工具中使用 CoBuddy 嗎?

可以。任何接受自訂 OpenAI 相容基礎 URL 的工具,都可以透過 Novita AI 使用 CoBuddy。將基礎 URL 設為 https://api.novita.ai/v3/openai,模型設為 baidu/cobuddy

Novita AI 是一個 AI 雲端平台,為開發者提供簡單的 API 輕鬆部署 AI 模型,同時也提供經濟實惠且可靠的 GPU 雲端運算服務,用於建置與擴充應用程式。

推薦文章