aicentosCodebuff
在 Codebuff 命令列代理中接入 aicentos 的 OpenAI 相容端點
最後更新於:
Codebuff 是一個執行在終端機裡的 AI 編碼代理，會按任務調度多個子代理來讀取程式碼、制定計畫並修改檔案。預設情況下它連接官方託管服務；如果手上的版本支援覆蓋 OpenAI 相容端點，就可以透過環境變數把請求指向 aicentos。
先確認你的版本是否支援自訂端點
Codebuff 官方主推託管模式：登入後使用官方額度，或透過 CODEBUFF_API_KEY 使用官方 API。自訂 Base URL 並非所有版本都提供，請先確認：
- 執行
codebuff --help，看是否有--base-url、--provider之類的選項。 - 確認版本是否讀取
OPENAI_BASE_URL（部分版本為CODEBUFF_BASE_URL）來覆蓋端點。 - 如果兩者都不支援，說明目前版本只能走官方服務，無法直接接 aicentos。
準備工作
如果確認版本支援自訂端點，先在控制台「API Key」頁面為 Codebuff 建立一個專用 Key（建議命名 codebuff-cli）。
- 控制台：https://aicentos.com
- 建立 Key：https://aicentos.com/keys
- 錢包儲值：https://aicentos.com/wallet
同時確認本機已安裝 Node.js，並已全域安裝 Codebuff：
npm install -g codebuff需要填寫的設定
| 欄位 | 值 |
|---|---|
| Base URL | https://aicentos.com/v1 |
| API Key | 控制台建立的 Key |
| 模型 | 控制台「模型廣場」中的模型名稱 |
設定步驟
- 把端點與金鑰寫入 shell 設定（
~/.zshrc或~/.bashrc）：
export OPENAI_API_KEY="sk-你的aicentos密钥"
export OPENAI_BASE_URL="https://aicentos.com/v1"- 重新載入設定：
source ~/.zshrc。 - 進入專案目錄，直接執行
codebuff。 - 如果版本支援
--model參數，可在啟動時顯式指定模型；否則在互動介面裡用模型選擇命令切換。
部分版本把設定寫在使用者設定目錄下的 JSON 檔案中（憑證類檔案預設權限為 600，不要提交到版本庫）。若你的版本使用設定檔而非環境變數，請按 codebuff --help 或官方文件給出的欄位名填寫同樣的 Base URL 與 Key。
測試
啟動後先用一句簡單提示詞輕量測試，例如讓它讀一個檔案並總結內容，確認能正常回傳結果再正式使用。
注意事項
- 自訂端點屬於進階用法，欄位名在不同版本間可能不一致；請以本機
codebuff --help輸出為準。 OPENAI_BASE_URL只填到https://aicentos.com/v1，不要補成完整的/v1/chat/completions。- Codebuff 會把程式碼片段和終端機輸出作為上下文傳送，使用前請確認這符合你所在團隊的資料合規要求。
- 報錯時依序檢查：環境變數是否在目前終端機生效、模型名稱是否與控制台一致、帳戶餘額是否充足（https://aicentos.com/wallet）。
- 更多說明見文件站：https://docs.aicentos.com