Cursor Integration

Cursor is an AI-powered IDE that supports OpenAI-compatible APIs. Connect it to the gateway for access to all providers.

Setup

1. Open Cursor Settings

Press Cmd + , (macOS) or Ctrl + , (Windows/Linux) and navigate to Models.

2. Enter API Key

In the OpenAI API Key field, enter your gateway virtual key or provider API key.

3. Override Base URL

Toggle Override OpenAI Base URL to ON and enter your gateway endpoint:

https://your-gateway.com/v1

4. Add Custom Models (Optional)

Type a model name in the Add or search model field using the provider/model-name format:

Virtual Keys

Use gateway virtual keys to enforce budgets, rate limits, and provider access controls for each user or team.

Model Selection

Cursor assigns models to different features:

• Chat: General conversation
• Agent: Multi-step tasks
• Inline Edit: Code editing
• Tab Completion: Autocomplete

After configuring the gateway, you can assign different models to each feature based on your needs.

Troubleshooting

Models Not Appearing

• Ensure the base URL is correct
• Check that the gateway is running
• Verify your API key is valid

Rate Limited

• The gateway will automatically fallback to other providers
• Check your virtual key's rate limits

401 Unauthorized

• Verify your virtual key is valid
• Ensure the base URL includes /v1

Next Steps

• Claude Code - Terminal AI coding
• Hermes Agent - CLI AI agent