Grok CLI

Grok CLI 是一個命令列工具，使用 OpenAI 相容介面，可以直接將自訂 API 位址作為其後端服務接入。

準備工作复制锚点链接

需要先安裝 Node.js 18+ 和 npm。

推薦從 Node.js 官方下載頁安裝：https://nodejs.org/en/download

• macOS/Windows：下載並安裝 LTS 版本
• Linux：依發行版方式安裝

macOS 使用者也可以使用 Homebrew：

brew install node

安裝完成後確認：

node -v
npm -v

安裝 Grok CLI复制锚点链接

使用 npm 全域安裝：

npm install -g @vibe-kit/grok-cli

安裝完成後驗證：

grok --version

設定接入复制锚点链接

Grok CLI 提供三種設定方式，優先順序為：命令列參數 > 環境變數 > 設定檔。

方式一：環境變數（推薦）复制锚点链接

設定以下環境變數：

export GROK_BASE_URL="https://aicentos.com/v1"
export GROK_API_KEY="your_api_key_here"

臨時測試直接在目前 shell 執行 export 即可。永久生效需將上述語句加入 ~/.zshrc 或 ~/.bashrc，然後執行 source ~/.zshrc 使其生效。

方式二：設定檔复制锚点链接

編輯 ~/.grok/user-settings.json：

{
  "apiKey": "your_api_key_here",
  "baseURL": "https://aicentos.com/v1",
  "defaultModel": "gpt-4o"
}

方式三：命令列參數复制锚点链接

啟動時透過參數指定：

grok --base-url https://aicentos.com/v1

啟動使用复制锚点链接

設定完成後，直接執行：

grok

啟動後在 Grok CLI 中發起對話，如果能正常收到回覆，表示接入成功。

驗證與排查复制锚点链接

如果遇到驗證錯誤，請檢查：

• GROK_API_KEY 是否正確
• GROK_BASE_URL / baseURL 是否指向正確的服務位址（需要帶 /v1 後綴）

確認設定無誤後重新啟動即可。

注意事項复制锚点链接

• Grok CLI 使用 OpenAI 相容介面，設定簡單直接
• 三種設定方式可以靈活選擇，推薦使用環境變數方式
• API 位址必須包含 /v1 後綴
• 支援自訂預設模型

相關連結复制锚点链接

• 官方文件：https://docs.aicentos.com/clients/grok-cli.html