Skip to content
Enterprise Pricing Contact
Schedule a Technical Demo

AI Providers

Shannon works best with Claude models. Anthropic API keys are recommended for most users, and Shannon also supports AWS Bedrock, Google Vertex AI, and custom Anthropic-compatible endpoints.

Each provider can be configured through the interactive setup wizard (npx mode) or by supplying environment variables directly. In source-build mode, the same variables can live in a .env file. Pick a tab. Your choice is remembered across the site.

Model tiers

Section titled “Model tiers”

Shannon uses three model tiers, each configurable via environment variables (or the setup wizard):

  • small (ANTHROPIC_SMALL_MODEL): summarization
  • medium (ANTHROPIC_MEDIUM_MODEL): security analysis
  • large (ANTHROPIC_LARGE_MODEL): deep reasoning

Each tier can be pointed at any Claude model. If you set a tier to claude-fable-5, note that Fable’s safety classifiers route cybersecurity tasks to Opus 4.8, so those phases run on Opus 4.8 regardless.

Anthropic

Section titled “Anthropic”

Run the setup wizard:

Terminal window
npx @keygraph/shannon setup

Or export an API key directly:

Terminal window
export ANTHROPIC_API_KEY=your-api-key

AWS Bedrock

Section titled “AWS Bedrock”

Run npx @keygraph/shannon setup and select AWS Bedrock. The wizard prompts for region, bearer token, and model IDs. Or set the variables directly:

Terminal window
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_BEARER_TOKEN_BEDROCK=your-bearer-token
export ANTHROPIC_SMALL_MODEL=us.anthropic.claude-haiku-4-5-20251001-v1:0
export ANTHROPIC_MEDIUM_MODEL=us.anthropic.claude-sonnet-4-6
export ANTHROPIC_LARGE_MODEL=us.anthropic.claude-opus-4-8

Set ANTHROPIC_SMALL_MODEL, ANTHROPIC_MEDIUM_MODEL, and ANTHROPIC_LARGE_MODEL to Bedrock model IDs available in your region.

Google Vertex AI

Section titled “Google Vertex AI”

Create a service account with the roles/aiplatform.user role in the GCP Console, then download a JSON key file.

Run npx @keygraph/shannon setup and select Google Vertex AI. The wizard prompts for region, project ID, service account key file path, and model IDs. The key file is copied to ~/.shannon/google-sa-key.json. Or set the variables directly:

Terminal window
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/your-sa-key.json
export ANTHROPIC_SMALL_MODEL=claude-haiku-4-5@20251001
export ANTHROPIC_MEDIUM_MODEL=claude-sonnet-4-6
export ANTHROPIC_LARGE_MODEL=claude-opus-4-8

Set CLOUD_ML_REGION=global for global endpoints, or use a specific region like us-east5. Some models may not be available on global endpoints.

Custom base URL

Section titled “Custom base URL”

Shannon supports pointing the SDK at an Anthropic-compatible endpoint with ANTHROPIC_BASE_URL. For proxy-based routing, use an LLM proxy such as LiteLLM configured to expose an Anthropic-compatible endpoint.

The experimental claude-code-router integration has been removed. If you previously relied on it, migrate to an Anthropic-compatible proxy such as LiteLLM.

Run npx @keygraph/shannon setup and select Custom Base URL, or set the variables directly:

Terminal window
export ANTHROPIC_BASE_URL=https://your-proxy.example.com
export ANTHROPIC_AUTH_TOKEN=your-auth-token
export ANTHROPIC_SMALL_MODEL=claude-haiku-4-5-20251001
export ANTHROPIC_MEDIUM_MODEL=claude-sonnet-4-6
export ANTHROPIC_LARGE_MODEL=claude-opus-4-8