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

# OpenAI Codex Integration

> Configure OpenAI Codex with Nordlys's advanced AI model Nordlys model for intelligent model selection

Configure OpenAI Codex to use Nordlys's Mixture of Models — our Mixture of Models automatically selects the best specialist while maintaining the same AI-powered coding experience.

<Tip>
  **Get the best AI specialist for every prompt** with Nordlys Mixture of Models. Works as a drop-in replacement for OpenAI Codex API.
</Tip>

## 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 Installer" icon="download">
    <CodeGroup>
      ```bash macOS/Linux theme={null}
      curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/codex.sh | bash
      ```

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

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

    The installer will handle configuration and environment setup automatically.
  </Step>

  <Step title="Verify Installation" icon="check">
    ```bash theme={null}
    codex --version
    echo $NORDLYS_API_KEY
    ```
  </Step>

  <Step title="Start Coding" icon="play">
    ```bash theme={null}
    codex -m nordlys/hypernova
    ```

    <img src="https://mintcdn.com/adaptive-c37cc850/4PFWOWLlNYD-r7o4/images/guides/dev-tools/codex/codex-step-3.png?fit=max&auto=format&n=4PFWOWLlNYD-r7o4&q=85&s=09f076f3563f08838075143f400bad74" alt="Codex CLI running with Nordlys" width="4400" height="2406" data-path="images/guides/dev-tools/codex/codex-step-3.png" />
  </Step>
</Steps>

## Alternative Setup Methods

<CodeGroup>
  ```bash Environment Variables theme={null}
  export NORDLYS_API_KEY='your-api-key-here'
  curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/codex.sh | bash
  ```

  ```powershell Environment Variables (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/codex.ps1 | iex
  ```

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

  ```toml Manual Configuration theme={null}
  # Edit ~/.codex/config.toml
  model = "nordlys/hypernova"
  model_provider = "nordlys"

  [model_providers.nordlys]
  name = "Nordlys"
  base_url = "https://api.nordlyslabs.com/v1"
  env_key = "NORDLYS_API_KEY"
  wire_api = "responses"
  ```

  ```bash Interactive Install theme={null}
  curl -o codex.sh https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/codex.sh
  chmod +x codex.sh
  ./codex.sh
  ```
</CodeGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Installation Issues" icon="download">
    * Check installation method availability (npm, brew, cargo, curl)
    * Verify system dependencies are installed
    * Try the interactive installation method for better error handling
  </Accordion>

  <Accordion title="Configuration Errors" icon="gear">
    * Verify API key at [nordlyslabs.com/api-platform/orgs](https://www.nordlyslabs.com/api-platform/orgs)
    * Check that `NORDLYS_API_KEY` environment variable is set
    * Restart terminal or run `source ~/.bashrc` after installation
  </Accordion>
</AccordionGroup>

## Next Steps

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

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

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

  <Card title="Get Support" href="/troubleshooting" icon="life-ring" cta="Get Help">
    Troubleshooting guides and support resources
  </Card>
</CardGroup>

***

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