Environment Variables
Provider API Keys
Set these environment variables to authenticate with LLM providers. Crush will automatically detect them and show the corresponding providers in the model picker.
| Variable | Provider |
|---|---|
HYPER_API_KEY | Charm Hyper |
ANTHROPIC_API_KEY | Anthropic |
OPENAI_API_KEY | OpenAI |
VERCEL_API_KEY | Vercel AI Gateway |
GEMINI_API_KEY | Google Gemini |
SYNTHETIC_API_KEY | Synthetic |
ZAI_API_KEY | Z.ai |
MINIMAX_API_KEY | MiniMax |
HF_TOKEN | Hugging Face Inference |
CEREBRAS_API_KEY | Cerebras |
OPENROUTER_API_KEY | OpenRouter |
IONET_API_KEY | io.net |
ALIBABA_SINGAPORE_API_KEY | Alibaba (Singapore) |
GROQ_API_KEY | Groq |
AVIAN_API_KEY | Avian |
OPENCODE_API_KEY | OpenCode Zen & Go |
VERTEXAI_PROJECT | Google Cloud VertexAI (Gemini) |
VERTEXAI_LOCATION | Google Cloud VertexAI (Gemini) |
AWS_ACCESS_KEY_ID | Amazon Bedrock (Claude) |
AWS_SECRET_ACCESS_KEY | Amazon Bedrock (Claude) |
AWS_REGION | Amazon Bedrock (Claude) |
AWS_PROFILE | Amazon Bedrock (Custom Profile) |
AWS_BEARER_TOKEN_BEDROCK | Amazon Bedrock |
AZURE_OPENAI_API_ENDPOINT | Azure OpenAI models |
AZURE_OPENAI_API_KEY | Azure OpenAI models (optional when using Entra ID) |
AZURE_OPENAI_API_VERSION | Azure OpenAI models |
Crush Configuration
| Variable | Description |
|---|---|
CRUSH_GLOBAL_CONFIG | Override the global config file location (default: ~/.config/crush/crush.json) |
CRUSH_GLOBAL_DATA | Override the ephemeral data directory (default: ~/.local/share/crush/) |
CRUSH_DISABLE_METRICS | Set to 1 to opt out of usage metrics collection |
CRUSH_DISABLE_PROVIDER_AUTO_UPDATE | Set to 1 to disable automatic provider updates from Catwalk |
Privacy
| Variable | Description |
|---|---|
DO_NOT_TRACK | Set to 1 to opt out of metrics collection (industry standard) |