Grok Build

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

準備工作复制锚点链接

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

  复制

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

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

需要填寫的設定复制锚点链接

設定步驟复制锚点链接

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

  复制

  export AICENTOS_API_KEY="your_api_key_here"

• 編輯 ~/.grok/config.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，用模型選擇器或命令切換：

  复制

  grok
  /model aicentos-grok

測試复制锚点链接

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

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 側計費，先到錢包頁確認餘額。