Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nordlyslabs.com/llms.txt

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

Configure Claude Code to use Nordlys’s Mixture of Models — our Mixture of Models automatically selects the best specialist while maintaining the same development experience.
Get the best AI specialist for every prompt with Nordlys Mixture of Models. Works as a drop-in replacement for the Claude API.

​
Get Your Nordlys API Key

Sign up here to create an account and generate your API key.

​
Quick Setup

Run Installer

curl -o claude-code.sh https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/claude-code.sh
chmod +x claude-code.sh
./claude-code.sh

Launch Claude Code

claude
Select “Yes” when prompted about using the API key.

Verify Setup

Ask “who are you?” to confirm Hypernova is active.
Claude Code working with Hypernova

​
Alternative Setup Methods

export ANTHROPIC_BASE_URL=https://api.nordlyslabs.com
export ANTHROPIC_AUTH_TOKEN=your-nordlys-api-key
export ANTHROPIC_MODEL=nordlys/hypernova
export ANTHROPIC_SMALL_FAST_MODEL=nordlys/hypernova
# Manual model overrides (override all for complete control)
export ANTHROPIC_DEFAULT_OPUS_MODEL=nordlys/hypernova  # Model for opus, or opusplan when Plan Mode is active
export ANTHROPIC_DEFAULT_SONNET_MODEL=nordlys/hypernova  # Model for sonnet, or opusplan when Plan Mode is not active
export ANTHROPIC_DEFAULT_HAIKU_MODEL=nordlys/hypernova  # Model for haiku, or background functionality
export CLAUDE_CODE_SUBAGENT_MODEL=nordlys/hypernova  # Model for subagents

​
Troubleshooting

  • Verify your API key at nordlyslabs.com/api-platform/orgs
  • Check that ANTHROPIC_BASE_URL is set to https://api.nordlyslabs.com/v1
  • Restart Claude Code after configuration changes
  • Regenerate your API key from the Nordlys dashboard
  • Ensure you’re using your Nordlys API key, not the original Claude API key
  • Check for extra spaces or characters in the configuration file

​
Next Steps

Monitor Usage & Savings

Track your cost savings and usage analytics in real-time

API Documentation

Learn about Nordlys’s API capabilities and advanced features

Framework Integration

Integrate Nordlys into your applications and workflows

Get Support

Troubleshooting guides and support resources
Was this page helpful? Contact us at [email protected] for feedback or assistance with your Claude Code integration.