# Grok Build

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

Language: zh-TW

> 在 Grok Build 中接入 aicentos —— 透過 config.toml 自訂 model provider

Grok Build 是 xAI 的終端機編程 Agent，預設呼叫 xAI 官方介面，但它支援在 `~/.grok/config.toml` 中宣告任意 OpenAI 相容的 `[model.*]` 端點。把端點指向 aicentos，就能用同一個 Key 呼叫 grok 系列及其它廠商的模型。

## 準備工作

* 安裝 Grok Build（官方腳本）：

  ```bash
  curl -fsSL https://x.ai/cli/install.sh | bash
  ```

* 在 aicentos 控制台建立一個專用 Key（建議命名 `grok-build`）。

## 需要填寫的設定

| 欄位              | 值                                               |
| --------------- | ----------------------------------------------- |
| base\_url       | `https://aicentos.com/v1`                       |
| api\_backend    | `chat_completions`（預設值）                         |
| env\_key        | `AICENTOS_API_KEY`                              |
| model           | 控制台「模型廣場」中的模型 ID，如 `grok-4.7`、`claude-opus-4-8` |
| context\_window | 按所選模型填寫，如 `200000`                              |

## 設定步驟

* 把 Key 寫入 shell 環境變數（寫入 `~/.zshrc` 或 `~/.bashrc` 後 `source` 生效）：

  ```bash
  export AICENTOS_API_KEY="your_api_key_here"
  ```

* 編輯 `~/.grok/config.toml`，新增一個自訂模型：

  ```toml
  [models]
  default = "aicentos-grok"

  [model.aicentos-grok]
  base_url          = "https://aicentos.com/v1"
  env_key           = "AICENTOS_API_KEY"
  api_backend       = "chat_completions"
  context_window    = 200000
  max_completion_tokens = 8192
  description       = "aicentos gateway - grok-4.7"
  ```

  `[model.<name>]` 的 `<name>` 就是模型 ID；若要接入多個模型，例如 `grok-4.7` 與 `claude-opus-4-8`，分別再寫一段 `[model.grok-4.7]`、`[model.claude-opus-4-8]`。

* 啟動 Grok Build，用模型選擇器或命令切換：

  ```bash
  grok
  /model aicentos-grok
  ```

## 測試

先列一下模型是否被識別：

```bash
grok models
```

再發一句輕量提示詞（如 `grok -p "用一句話介紹當前目錄" -m aicentos-grok`）確認能正常回應。

## 注意事項

* Grok Build **沒有 `--base-url` 命令列參數**，自訂端點只能透過設定檔或環境變數指定。
* `api_backend` 預設即 `chat_completions`；若顯式寫成 `responses` 或 `messages`，需確認閘道支援對應端點，否則會失敗。
* 憑證解析順序為：模型設定裡的 `api_key` → `env_key` 指定的環境變數 → 已登入工作階段 token → 全域 `XAI_API_KEY`。這裡用 `env_key` 引用自己的變數名即可，不會串到 xAI 官方帳號。
* 新增模型若省略 `context_window`，Grok Build 預設按 200,000 處理；建議按所選模型顯式填寫。
* 接自訂端點後不再依賴訂閱 xAI，但被選中的模型仍由 aicentos 側計費，先到[錢包頁](https://aicentos.com/wallet)確認餘額。