Troubleshooting Auth

Start here when connection or credential state is the main problem.

Useful Commands

  • grok whoami
  • grok login
  • grok wait
  • /connect

Common Cases

  • not connected: no usable xAI key was found
  • invalid: the key exists but failed validation
  • rate-limited: one or more stored xAI accounts are temporarily blocked

Best Next Step

  • use /connect for guided repair
  • use grok login when you want a simple CLI key prompt
  • use grok wait only after Grok Code has actually recorded rate-limit state

Was this page helpful? Report issues on GitHub.