# Codebuff

來源: https://docs.aicentos.com/zh-TW/clients/codebuff

Language: zh-TW

> 在 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](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

同時確認本機已安裝 Node.js，並已全域安裝 Codebuff：

```bash
npm install -g codebuff
```

## 需要填寫的設定

| 欄位       | 值                         |
| -------- | ------------------------- |
| Base URL | `https://aicentos.com/v1` |
| API Key  | 控制台建立的 Key                |
| 模型       | 控制台「模型廣場」中的模型名稱           |

## 設定步驟

* 把端點與金鑰寫入 shell 設定（`~/.zshrc` 或 `~/.bashrc`）：

```bash
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://aicentos.com/wallet）。)
* 更多說明見文件站：[https://docs.aicentos.com](https://docs.aicentos.com)