> ## 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.

# Qwen Code Integration

> Configure Qwen Code with Nordlys's Mixture of Models model for lab-grade coding quality and lower cost

Configure Qwen Code to use Nordlys's Mixture of Models model for coding tasks.

<Tip>
  **Mixture of Models model** with prompt‑activated specialists. Works as a
  drop-in replacement for Qwen Code's API backend with lab-grade quality and
  cost control.
</Tip>

## Benefits of Using Qwen Code with Nordlys

When you integrate Qwen Code with Nordlys, you unlock powerful capabilities:

* **Mixture of Models Activation**: The right specialists activate per prompt
* **Cost Optimization**: Optimize API costs with lab‑tuned models
* **Consistent Quality**: Stable output quality across coding tasks
* **Drop-in Integration**: OpenAI-compatible settings with zero code changes
* **Usage Analytics**: Monitor model usage, costs, and performance in real-time

## Get Your Nordlys API Key

[Sign up here](https://www.nordlyslabs.com/api-platform/orgs) to create an account and generate your API key.

## Quick Setup

<Steps>
  <Step title="Run Automated Installer" icon="rocket">
    <CodeGroup>
      ```bash macOS/Linux theme={null}
      curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/qwen-code.sh | bash
      ```

      ```powershell Windows (PowerShell) theme={null}
      iwr -useb https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/qwen-code.ps1 | iex
      ```

      ```bat Windows (cmd) theme={null}
      curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/qwen-code.cmd -o qwen-code.cmd
      qwen-code.cmd
      ```
    </CodeGroup>

    The installer will automatically:

    * Install Qwen Code if not present (via npm)
    * Configure OpenAI-compatible environment variables for Nordlys
    * Add configuration to your shell profile (\~/.bashrc, \~/.zshrc, etc.)
    * Verify the installation
  </Step>

  <Step title="Verify Configuration" icon="check">
    ```bash theme={null}
    qwen --version
    echo $OPENAI_API_KEY
    echo $OPENAI_BASE_URL
    ```
  </Step>

  <Step title="Start Using" icon="play">
    ```bash theme={null}
    qwen
    ```
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/adaptive-c37cc850/4PFWOWLlNYD-r7o4/images/guides/dev-tools/qwen-code/qwen-code-step-3.png?fit=max&auto=format&n=4PFWOWLlNYD-r7o4&q=85&s=ecb203423b62e43a2f62079aa1dcb2ad" alt="Qwen Code configured with Nordlys" width="4400" height="2538" data-path="images/guides/dev-tools/qwen-code/qwen-code-step-3.png" />
</Frame>

## Manual Installation

If you prefer to set up Qwen Code manually or need more control over the installation process:

### Step 1: Install Qwen Code

```bash theme={null}
npm install -g @qwen-code/qwen-code@latest
```

<Note>
  Qwen Code requires Node.js 20 or higher. Check your version with `node --version`.
</Note>

### Step 2: Configure Environment Variables

Qwen Code uses OpenAI-compatible API configuration:

<CodeGroup>
  ```bash Bash/Zsh (~/.bashrc or ~/.zshrc) theme={null}
  # Qwen Code with Nordlys AI model API Configuration
  export OPENAI_API_KEY="your-nordlys-api-key-here"  # qwen-code
  export OPENAI_BASE_URL="https://api.nordlyslabs.com/v1"  # qwen-code
  export OPENAI_MODEL="nordlys/hypernova"  # qwen-code - for automatic Nordlys model
  ```

  ```fish Fish Shell (~/.config/fish/config.fish) theme={null}
  # Qwen Code with Nordlys AI model API Configuration
  set -x OPENAI_API_KEY "your-nordlys-api-key-here"  # qwen-code
  set -x OPENAI_BASE_URL "https://api.nordlyslabs.com/v1"  # qwen-code
  set -x OPENAI_MODEL "nordlys/hypernova"  # qwen-code - for automatic Nordlys model
  ```

  ```powershell Windows (PowerShell) theme={null}
  $env:OPENAI_API_KEY="your-nordlys-api-key-here"
  $env:OPENAI_BASE_URL="https://api.nordlyslabs.com/v1"
  $env:OPENAI_MODEL="nordlys/hypernova"
  setx OPENAI_API_KEY "your-nordlys-api-key-here"
  setx OPENAI_BASE_URL "https://api.nordlyslabs.com/v1"
  setx OPENAI_MODEL "nordlys/hypernova"
  ```
</CodeGroup>

### Step 3: Apply Configuration

```bash theme={null}
# For Bash/Zsh
source ~/.bashrc  # or ~/.zshrc

# For Fish
source ~/.config/fish/config.fish

# Or restart your terminal
```

### Step 4: Verify Installation

```bash theme={null}
qwen --version
qwen
```

## Alternative Setup Methods

<CodeGroup>
  ```bash Environment Variable Method theme={null}
  export NORDLYS_API_KEY='your-api-key-here'
  curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/qwen-code.sh | bash
  # The installer will automatically configure your shell
  ```

  ```powershell Environment Variable Method (PowerShell) theme={null}
  $env:NORDLYS_API_KEY="your-api-key-here"
  setx NORDLYS_API_KEY "your-api-key-here"
  iwr -useb https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/qwen-code.ps1 | iex
  ```

  ```bat Environment Variable Method (cmd) theme={null}
  set NORDLYS_API_KEY=your-api-key-here
  curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/qwen-code.cmd -o qwen-code.cmd
  qwen-code.cmd
  ```

  ```bash Interactive Installation theme={null}
  curl -o qwen-code.sh https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/qwen-code.sh
  chmod +x qwen-code.sh
  ./qwen-code.sh
  # Follow the interactive prompts
  ```

  ```bash Custom Model Configuration theme={null}
  export NORDLYS_API_KEY='your-api-key-here'
  export OPENAI_MODEL='nordlys/hypernova'  # Optional: specify default model
  curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/qwen-code.sh | bash
  ```

  ```powershell Custom Model Configuration (PowerShell) theme={null}
  $env:NORDLYS_API_KEY="your-api-key-here"
  $env:OPENAI_MODEL="nordlys/hypernova"
  setx NORDLYS_API_KEY "your-api-key-here"
  setx OPENAI_MODEL "nordlys/hypernova"
  iwr -useb https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/qwen-code.ps1 | iex
  ```

  ```bat Custom Model Configuration (cmd) theme={null}
  set NORDLYS_API_KEY=your-api-key-here
  set OPENAI_MODEL=nordlys/hypernova
  curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/qwen-code.cmd -o qwen-code.cmd
  qwen-code.cmd
  ```
</CodeGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Installation Issues" icon="wrench">
    **Problem**: Qwen Code installation fails

    **Solutions**:

    * Ensure Node.js 20+ is installed: `node --version`

    * Install Node.js if needed:

      ```bash theme={null}
      # Using nvm (recommended)
      curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
      nvm install 22
      ```

    * Check npm permissions: `npm config get prefix`

    * Try with sudo (not recommended): `sudo npm install -g @qwen-code/qwen-code`

    * Clear npm cache: `npm cache clean --force`
  </Accordion>

  <Accordion title="Authentication Errors" icon="key">
    **Problem**: "Unauthorized" or "Invalid API key" errors

    **Solutions**:

    1. Verify your API key at [nordlyslabs.com/api-platform/orgs](https://www.nordlyslabs.com/api-platform/orgs)

    2. Check environment variables are set:

       ```bash theme={null}
       echo $OPENAI_API_KEY
       echo $OPENAI_BASE_URL
       echo $OPENAI_MODEL
       ```

    3. Ensure variables are exported in your shell config:

       ```bash theme={null}
       # Bash/Zsh
       source ~/.bashrc  # or ~/.zshrc

       # Fish
       source ~/.config/fish/config.fish
       ```

    4. Restart your terminal if changes were made to shell config

    5. Verify the base URL is correct: `https://api.nordlyslabs.com/v1`

    6. Check for the `# qwen-code` comment to ensure correct environment variables
  </Accordion>

  <Accordion title="Connection Errors" icon="network-wired">
    **Problem**: Cannot connect to Nordlys API

    **Solutions**:

    * Check internet connectivity

    * Verify base URL is correct: `echo $OPENAI_BASE_URL`

    * Test API directly:

      ```bash theme={null}
      curl -X POST https://api.nordlyslabs.com/v1/chat/completions \
        -H "Authorization: Bearer $OPENAI_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "nordlys/hypernova",
          "messages": [{"role": "user", "content": "Hello"}]
        }'
      ```

    * Check if your network/firewall blocks the API endpoint

    * Try using a different network or VPN
  </Accordion>

  <Accordion title="Model ID Issues" icon="route">
    **Problem**: Requests fail due to a model ID error

    **Solutions**:

    1. Set the model ID explicitly:

       ```bash theme={null}
       export OPENAI_MODEL='nordlys/hypernova'
       ```

    2. Confirm the value is spelled exactly and matches the docs.
  </Accordion>

  <Accordion title="Performance Issues" icon="gauge-high">
    **Problem**: Slow response times or timeouts

    **Solutions**:

    * Verify rate limits aren't exceeded
    * Check your network connection
    * Reduce prompt size or request complexity
    * Retry with smaller batches if processing large files
  </Accordion>
</AccordionGroup>

## Uninstallation

If you need to remove Qwen Code or revert configuration:

<Steps>
  <Step title="Remove Qwen Code">
    ```bash theme={null}
    npm uninstall -g @qwen-code/qwen-code
    ```
  </Step>

  <Step title="Remove Environment Variables">
    Edit your shell config file and remove these lines:

    ```bash theme={null}
    # Qwen Code with Nordlys AI model API Configuration
    export OPENAI_API_KEY="..." # qwen-code
    export OPENAI_BASE_URL="..." # qwen-code
    export OPENAI_MODEL="..." # qwen-code
    ```
  </Step>

  <Step title="Reload Shell Configuration">
    ```bash theme={null}
    source ~/.bashrc # or ~/.zshrc or ~/.config/fish/config.fish
    ```
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Monitor Usage & Savings" href="https://www.nordlyslabs.com/api-platform/orgs" icon="chart-line">
    Track your cost savings and usage analytics in real-time
  </Card>

  <Card title="API Documentation" href="/api-reference/chat-completions" icon="book">
    Learn about Nordlys's API capabilities and advanced features
  </Card>

  <Card title="More CLI Tools" href="/developer-tools/claude-code" icon="terminal">
    Explore other CLI tools with Nordlys integration
  </Card>

  <Card title="Advanced Model selection" href="/features/nordlys/hypernova" icon="route">
    Learn about Nordlys Mixture of Models and load balancing
  </Card>
</CardGroup>

***

<Note>
  **Was this page helpful?** Contact us at
  [info@llmadaptive.uk](mailto:info@llmadaptive.uk) for feedback or assistance
  with your Qwen Code integration.
</Note>