Shannon reads configuration from environment variables (which always take precedence over saved config files). Set them in your shell with export, or in a .env file in source-build mode.
| Variable | Description |
|---|
ANTHROPIC_API_KEY | Anthropic API key. Recommended provider for most users. |
CLAUDE_CODE_OAUTH_TOKEN | OAuth token to authenticate instead of ANTHROPIC_API_KEY. |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Maximum output tokens (e.g. 64000). |
CLAUDE_ADAPTIVE_THINKING | Set to false to disable adaptive thinking (enabled automatically on Opus 4.6/4.7/4.8). |
Point each tier at a specific model. Values depend on the provider (plain model IDs for Anthropic, Bedrock IDs for Bedrock, Vertex IDs for Vertex).
| Variable | Tier | Used for |
|---|
ANTHROPIC_SMALL_MODEL | small | Summarization |
ANTHROPIC_MEDIUM_MODEL | medium | Security analysis |
ANTHROPIC_LARGE_MODEL | large | Deep reasoning |
Defaults when unset (direct Anthropic): small claude-haiku-4-5-20251001, medium claude-sonnet-4-6, large claude-opus-4-8. Bedrock and Vertex require these to be set explicitly with provider-specific model IDs.
| Variable | Description |
|---|
CLAUDE_CODE_USE_BEDROCK | Set to 1 to use Bedrock. |
AWS_REGION | AWS region, e.g. us-east-1. |
AWS_BEARER_TOKEN_BEDROCK | Bedrock bearer token. |
| Variable | Description |
|---|
CLAUDE_CODE_USE_VERTEX | Set to 1 to use Vertex AI. |
CLOUD_ML_REGION | Region, e.g. us-east5, or global. |
ANTHROPIC_VERTEX_PROJECT_ID | GCP project ID. |
GOOGLE_APPLICATION_CREDENTIALS | Path to the service account JSON key file. |
| Variable | Description |
|---|
ANTHROPIC_BASE_URL | Anthropic-compatible endpoint URL. |
ANTHROPIC_AUTH_TOKEN | Auth token for the custom endpoint. |
| Variable | Description |
|---|
SHANNON_FORWARD_HOSTS | Set to false to disable forwarding /etc/hosts custom hostnames into the worker. |
See AI Providers for full setup sequences and Platforms & Networking for networking details.