Claude Code Integration

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

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

iwr https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/claude-code.ps1 -OutFile claude-code.ps1; Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass; .\claude-code.ps1

curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/claude-code.cmd -o claude-code.cmd
claude-code.cmd

Launch Claude Code

claude

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

Verify Setup

Ask “who are you?” to confirm Hypernova is active.

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

$env:ANTHROPIC_BASE_URL="https://api.nordlyslabs.com"
$env:ANTHROPIC_AUTH_TOKEN="your-nordlys-api-key"
$env:ANTHROPIC_MODEL="nordlys/hypernova"
$env:ANTHROPIC_SMALL_FAST_MODEL="nordlys/hypernova"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="nordlys/hypernova"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="nordlys/hypernova"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="nordlys/hypernova"
$env:CLAUDE_CODE_SUBAGENT_MODEL="nordlys/hypernova"
setx ANTHROPIC_AUTH_TOKEN "your-nordlys-api-key"

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-nordlys-api-key",
    "ANTHROPIC_BASE_URL": "https://api.nordlyslabs.com",
    "ANTHROPIC_MODEL": "nordlys/hypernova",
    "ANTHROPIC_SMALL_FAST_MODEL": "nordlys/hypernova",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "nordlys/hypernova",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "nordlys/hypernova",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "nordlys/hypernova",
    "CLAUDE_CODE_SUBAGENT_MODEL": "nordlys/hypernova"
  }
}

export NORDLYS_API_KEY='your-api-key'
curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/claude-code.sh | bash

$env:NORDLYS_API_KEY="your-api-key"
setx NORDLYS_API_KEY "your-api-key"
iwr https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/claude-code.ps1 -OutFile claude-code.ps1; Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass; .\claude-code.ps1

set NORDLYS_API_KEY=your-api-key
curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/claude-code.cmd -o claude-code.cmd
claude-code.cmd

Troubleshooting

Connection Issues

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

Authentication Errors

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.

Getting Started

Developer Tools

Framework Integrations

API Reference

Support

Claude Code Integration

Get Your Nordlys API Key

Quick Setup

Alternative Setup Methods

Troubleshooting

Next Steps

Monitor Usage & Savings

API Documentation

Framework Integration

Get Support

​Get Your Nordlys API Key

​Quick Setup

​Alternative Setup Methods

​Troubleshooting

​Next Steps

Monitor Usage & Savings

API Documentation

Framework Integration

Get Support

Get Your Nordlys API Key

Quick Setup

Alternative Setup Methods

Troubleshooting

Next Steps