Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nano-gpt.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Grok CLI

Use Grok CLI with NanoGPT to access Grok models and 50+ other models through a single API key.
Get started with NanoGPT for pay-as-you-go pricing with no monthly fees.
NanoGPT provides an OpenAI-compatible endpoint that works with the Grok CLI. This lets you:
  • Use Grok CLI with your NanoGPT credits
  • Access Grok models without a separate xAI account
  • Use any other NanoGPT model through the same CLI

​
Step 1: Install Grok CLI

Prerequisites: Node.js 18 or newer 
# Install Grok CLI
npm install -g @vibe-kit/grok-cli

# Verify installation
grok --version
Note: If you encounter permission issues during installation, try using sudo (macOS/Linux) or running the command prompt as an administrator (Windows) to re-execute the installation command.

​
Step 2: Configure NanoGPT

1

Get API Key

  • Go to NanoGPT API
  • Create an account or log in
  • Copy your API key
2

Set Required Environment Variables

Grok CLI reads these environment variables:
VariableValueDescription
GROK_BASE_URLhttps://nano-gpt.com/api/v1NanoGPT OpenAI-compatible endpoint
GROK_API_KEYsk-nano-YOUR-API-KEYYour NanoGPT API key
export GROK_BASE_URL="https://nano-gpt.com/api/v1"
export GROK_API_KEY="sk-nano-YOUR-API-KEY"
Replace sk-nano-YOUR-API-KEY with your actual API key. Open a new terminal for changes to take effect if you set persistent variables.
3

Optional: Make It Persistent

Add the variables to your shell profile (for example, ~/.zshrc or ~/.bashrc):
echo 'export GROK_BASE_URL="https://nano-gpt.com/api/v1"' >> ~/.zshrc
echo 'export GROK_API_KEY="sk-nano-YOUR-API-KEY"' >> ~/.zshrc
source ~/.zshrc

​
Step 3: Start Using Grok CLI

Launch Grok CLI with a specific model: 
grok --model grok-3
Since you are connected to NanoGPT, you can use any available model: 
# Grok models
grok --model grok-3
grok --model grok-3-fast
grok --model grok-3-mini

# Other providers through NanoGPT
grok --model openai/gpt-5.2
grok --model anthropic/claude-opus-4.5
grok --model google/gemini-3-flash-preview
Model names are listed on our pricing page.

​
Available Grok Models

ModelDescription
grok-3xAI flagship model
grok-3-fastFaster, more cost-effective version
grok-3-miniLightweight version

​
Known Limitations

Grok CLI has limited compatibility with thinking or reasoning models. When you use a thinking model, the full reasoning content may be shown in the output. If you want first-party CLI support for NanoGPT, consider Claude Code or Codex CLI.

​
Troubleshooting

IssueSolution
401 UnauthorizedCheck your API key is correct and has credits
GROK_BASE_URL not setEnsure the environment variable is exported
Model not foundVerify the model name at nano-gpt.com/pricing
Command not found: grokRun npm install -g @vibe-kit/grok-cli again
Thinking content flooding outputUse a non-thinking model variant

​
FAQ

​
Is Grok CLI official xAI software?

No. Grok CLI is a third-party package. NanoGPT works with it by providing an OpenAI-compatible endpoint.

​
Can I access Grok models from other clients?

Yes. You can use Grok models from Claude Code, Cursor, or any OpenAI-compatible client by setting the base URL to NanoGPT.

​
API Details (Reference)

SettingValue
Base URLhttps://nano-gpt.com/api/v1
Chat Completions EndpointPOST /chat/completions
Models EndpointGET /models
Auth HeaderAuthorization: Bearer sk-nano-...

​
Example cURL (verify connection)

curl -X POST "https://nano-gpt.com/api/v1/chat/completions" \
  -H "Authorization: Bearer sk-nano-YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-3-fast",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'