Coding Agent सेटअप

Grok CLI और Grok Build: इंस्टॉलेशन और API सेटअप

आधिकारिक Grok Build और Community Grok CLI का अंतर समझें, दोनों क्लाइंट इंस्टॉल करें और BetterToken API Key से Community CLI कॉन्फ़िगर करें।

“Grok CLI” दो अलग tools के लिए इस्तेमाल हो सकता है:

Grok Build — xAI का official coding agent;
Community Grok CLI — xAI से असंबद्ध open-source project।

macOS पर GPT मॉडल के साथ परीक्षण में Community Grok CLI 1.1.7 ने टेक्स्ट अनुरोधों पर OK लौटाया, लेकिन फ़ाइल पढ़ने का मामला सफलतापूर्वक पूरा नहीं हुआ। Grok Build 1.0.67 ने api_backend = "chat_completions" के साथ टेक्स्ट अनुरोध और फ़ाइल पढ़ने वाले tool calls पूरे किए; इसका Responses stream client parsing में विफल हुआ (Grok Build देखें)। दोनों कॉन्फ़िगरेशन में BetterToken API Key, Base URL और Model ID उपयोग होते हैं।

Grok CLI और Grok Build में अंतर

तुलना	आधिकारिक Grok Build	Community Grok CLI
Maintainer	xAI	`superagent-ai/grok-cli`, xAI से असंबद्ध
किसके लिए	xAI का आधिकारिक coding agent चाहने वाले	कस्टम Base URL से मॉडल कॉल करने वाले
Authentication	Browser login या `XAI_API_KEY`	`GROK_API_KEY`
Custom Base URL	`~/.grok/config.toml` में	`GROK_BASE_URL` से
Model	Config alias	`GROK_MODEL`
BetterToken से model call	टेक्स्ट और फ़ाइल पढ़ने वाले tool calls सफल (1.0.67, `chat_completions`)	टेक्स्ट पर `OK` लौटा; फ़ाइल पढ़ने का मामला विफल (1.1.7)
Command	`grok`	`grok`

यह गाइड BetterToken से किए गए केवल टेक्स्ट और कोड मॉडल अनुरोधों को कवर करती है। इसमें X Search, speech transcription, image generation या video generation जैसी xAI-specific APIs शामिल नहीं हैं।

Community Grok CLI को BetterToken के साथ इस्तेमाल करें

ये commands macOS, Linux और WSL के लिए हैं। Community client का native Windows setup verify नहीं किया गया है।

इंस्टॉल करें

curl -fsSL https://raw.githubusercontent.com/superagent-ai/grok-cli/main/install.sh | bash
grok --version

Bun पहले से install हो तो:

bun add -g grok-dev

BetterToken configure करें

export GROK_BASE_URL="https://bettertoken.ai/v1"
export GROK_API_KEY="YOUR_API_KEY"
export GROK_MODEL="YOUR_MODEL_ID"

YOUR_MODEL_ID को model plaza की पूरी Model ID से बदलें और अपनी BetterToken API Key इस्तेमाल करें।

Connection verify करें

grok -p "Reply with only: OK"

Model response मिलने पर ही API Key, Base URL और Model ID की पुष्टि होती है। Environment variables बदलने के बाद client restart करें।

Community Grok CLI 1.1.7 ने तीनों टेक्स्ट प्रयासों में OK लौटाया, लेकिन क्लाइंट ने stream validation errors बताए: stream के अंत में delta.role: null को अस्वीकार किया और tool-call continuation chunks में schema errors भी बताए। फ़ाइल पढ़ने का मामला सफलतापूर्वक पूरा नहीं हुआ। इस परीक्षण के दायरे में इस client का उपयोग केवल टेक्स्ट अनुरोधों के लिए करें; फ़ाइल पढ़ने वाले tool calls सफल नहीं हुए।

Official Grok Build

Grok Build xAI का official terminal coding agent है।

macOS / Linux / WSL

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

Windows PowerShell

irm https://x.ai/cli/install.ps1 | iex
grok --version

पहली बार Grok Build browser खोलता है। Browser के बिना:

export XAI_API_KEY="YOUR_XAI_API_KEY"
grok

Grok Build में BetterToken configure करें

[model.bettertoken]
model = "YOUR_MODEL_ID"
base_url = "https://bettertoken.ai/v1"
name = "BetterToken"
env_key = "BETTERTOKEN_API_KEY"
api_backend = "chat_completions"

[models]
default = "bettertoken"

BETTERTOKEN_API_KEY example का variable name है। Grok Build env_key में दिया variable पढ़ता है।

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
grok inspect
grok -p "Reply with only: OK" -m bettertoken

सहायक मॉडल अनुरोध

दोनों clients अपने चुने हुए मॉडलों को अतिरिक्त अनुरोध भेज सकते हैं, जैसे Community Grok CLI में grok-4.20-non-reasoning और Grok Build में grok-4.6। परीक्षण में BetterToken ने इन सहायक मॉडलों के लिए No available channel के साथ 503 model_not_found लौटाया, जबकि मुख्य मॉडल अनुरोध सफल रहा। यदि मुख्य अनुरोध पूरा हो जाए तो इन सहायक-मॉडल त्रुटियों को अनदेखा कर सकते हैं; इनका अर्थ यह नहीं कि आपका चुना हुआ Model ID विफल हुआ।

`grok` command conflict से बचें

macOS / Linux / WSL

type -a grok
grok --version

Windows PowerShell

Get-Command grok -All
grok --version

सामान्य त्रुटियां

समस्या	जांच
गलत client खुलता है	हर `grok` command का path और version जांचें।
Grok Build में `unknown variant response.metadata` त्रुटि आती है	BetterToken मॉडल के लिए `api_backend = "chat_completions"` सेट करें और `grok inspect` फिर चलाएं।
आधिकारिक Grok Build browser खोलता है	यह Grok Build का default login flow है। xAI इस्तेमाल करते समय आगे बढ़ें; BetterToken के लिए custom model कॉन्फ़िगर करें।
`401` या `Unauthorized`	Grok Build custom model `env_key` से दिया variable पढ़ता है; Community CLI `GROK_API_KEY` पढ़ता है। केवल मौजूदा client वाला variable सेट करें।
`model not found`	Model plaza से पूरी Model ID copy करके restart करें।
Request xAI पर जाता है	Community client के लिए `GROK_BASE_URL` जांचें। Grok Build में `grok inspect` चलाकर `base_url` और सक्रिय model alias की पुष्टि करें।
xAI-specific सुविधा काम नहीं करती	BetterToken यहां बताए गए model requests ही संभालता है। X Search, speech और media सुविधाओं के लिए आधिकारिक xAI API इस्तेमाल करें।