メインコンテンツへスキップ
更新日: 2026-06-23
Cursor is a practical way to bring Crazyrouter into your day-to-day coding workflow for chat, code explanation, refactoring suggestions, and general editing help.

​
Overview

With Cursor’s BYOK (Bring Your Own Key) flow, you can route part of your chat-model traffic through Crazyrouter and pay against your own token instead of bundling everything into Cursor usage.
  • recommended path: OpenAI-compatible mode
  • Crazyrouter base URL: https://api.crazyrouter.com/v1
  • auth format: sk-... token
  • best first-use features: Chat, Ask, and normal editing conversations
According to Cursor’s official documentation, custom API keys only work with standard chat models. Features that depend on specialized models, such as Tab Completion, continue using Cursor’s built-in models. That limitation comes from Cursor, not from Crazyrouter.

​
Best For

  • developers who want to use Crazyrouter tokens inside Cursor
  • teams that want better control over model choice, cost, and quota
  • users who want Cursor chat routed through Crazyrouter
  • setups where IDE, CLI, and automation tokens should be tracked separately

​
Protocol Used

Recommended protocol: OpenAI-compatible API When connecting Cursor to Crazyrouter, use this OpenAI-compatible base URL:
Do not use:
  • https://api.crazyrouter.com
  • https://api.crazyrouter.com/v1/chat/completions

​
Prerequisites

Recommended starter allowlist:
  • gpt-5.5
  • claude-opus-4-8
  • gemini-3.1-pro
If you also plan to configure Claude Code, Codex, or Cline, do not share the same token with Cursor. Separate tokens make quota control and debugging much easier.

​
Quick Start

1

Create a Cursor-specific token

In Crazyrouter, create a new token and name it something obvious like cursor. Start with a small allowlist such as gpt-5.5 and claude-opus-4-8.
2

Open Cursor settings

Open Cursor and go to Cursor Settings → Models.
3

Fill the OpenAI connection fields

In the OpenAI-related section, enter:
  • OpenAI API Key: your sk-...
  • Override OpenAI Base URL: https://api.crazyrouter.com/v1
If your Cursor build does not show Override OpenAI Base URL, your current version does not fully expose the custom OpenAI-compatible endpoint path yet. In that case, upgrade Cursor first or wait for improved support on the Cursor side.
4

Verify the key and pick a model

Click Verify. After it succeeds, enable one model for the first validation. gpt-5.5 is the safest starting point.
5

Run the first test

Open the chat panel and send a simple request such as Reply with only OK. If that succeeds, Crazyrouter is connected.
Recommended rollout order: get gpt-5.5 working first, then test claude-opus-4-8 and gemini-3.1-pro.

​
Token Setup Best Practices

​
Verification Checklist

  • Verify succeeds in Cursor Settings → Models
  • Override OpenAI Base URL is set to https://api.crazyrouter.com/v1
  • at least one Crazyrouter-backed model is selected
  • the first chat request succeeds
  • the matching request appears in Crazyrouter logs
  • token quota and model allowlist match your intended setup
  • you understand that Tab Completion and similar features may still bypass Crazyrouter

​
Common Errors And Fixes

​
Performance And Cost Tips

  • start with only gpt-5.5
  • use gpt-5.5 for the baseline coding and chat workflow
  • add claude-opus-4-8 or gemini-3.1-pro only after the baseline path is stable
  • split Cursor, Claude Code, and Codex traffic across different tokens
  • if usage looks suspiciously high, inspect Crazyrouter logs and check whether long multi-turn context is driving costs

​
FAQ

​
Which base URL should I enter in Cursor?

Use https://api.crazyrouter.com/v1.

​
Why do some Cursor features still not go through Crazyrouter?

Because Cursor officially limits custom API keys to standard chat models. Specialized features such as Tab Completion continue using Cursor-managed models.

​
Which model should I use first?

Start with gpt-5.5. It is the latest OpenAI-compatible baseline already verified in production.

​
Can I use Claude or other non-OpenAI models directly?

You can try them, but first complete a clean OpenAI-compatible baseline setup. Whether a custom model works cleanly in your current Cursor version depends on Cursor’s compatibility implementation.

​
Chat works, but model selection keeps getting weird. What should I do?

Restart Cursor, verify again, and fall back to gpt-5.5 as the known-good baseline before expanding the config.
If your main goal is a stable coding workflow through Crazyrouter, Claude Code, Codex, and Cline are often more direct and controllable than Cursor’s custom endpoint path. Cursor is best treated as a chat-first and general editing integration.