Skip to main content

​
Introduction

Cursor is an AI-powered code editor. By integrating Mixroute Api, you can get powerful AI assistance while coding, including intelligent code generation, completion, explanation, and optimization. Mixroute Api is now compatible with Cursor’s Agent capabilities (Auto Apply / multi-file editing).

​
Quick Configuration

Important: Currently Cursor officially restricts third-party API Keys (including Mixroute Api) with the following conditions:
  • Must have Pro Plan (paid subscription), Free Plan cannot use third-party API Keys
  • Need VPN/proxy to connect to third-party API services
  • This is Cursor’s official policy limitation, not Mixroute Api’s

​
1. Open Settings

Click the gear icon ⚙️ in the top right, select Models option.

​
2. Configure API

  • OpenAI API Key: Enter your Mixroute Api key
  • Override OpenAI Base URL: Check and enter https://console.mixroute.io/v1
  • Click Verify to validate configuration
  • GPT series models need openai/ prefix, e.g., use openai/gpt-5.2 for gpt-5.2. Other channels use original model IDs.
  • Mixroute Api supports Cursor Agent (Auto Apply). To enable Agent, use Agent-compatible models.

​
3. Agent Mode Tips

  • Use Agent-compatible models (Claude, DeepSeek, Grok, GPT series with openai/ prefix)
  • Ensure Base URL is https://console.mixroute.io/v1
  • Verify auto-apply with a simple change in Cursor sidebar first time
  • If model doesn’t support Agent, use Chat mode with manual Apply
TypeRecommended Model IDFeatures
Programmingclaude-sonnet-4-20250514Claude 4 Sonnet, strongest coding
gpt-4.1Fast, strong overall
deepseek-v3Excellent Chinese coding, great value
Cost-effectivegpt-4.1-miniLightweight but capable
claude-3-haikuCheapest in Claude series
gemini-2.5-flashGoogle fast response model
Reasoningo4-miniBest reasoning for coding
o3-miniFor complex reasoning and algorithms

​
Add Custom Models

Add in Cursor settings: 
claude-sonnet-4-20250514
gpt-4.1
deepseek-v3
o4-mini
gemini-2.5-pro

​
Usage Modes

​
Chat Mode Workflow

  1. Generate code: Ctrl/Cmd + L to open chat, describe requirements
  2. Apply code: Copy code to target file, or use “Apply” button
  3. Iterate: Continue conversation for modifications

​
Alternatives Comparison

ToolAgent ModeProsCons
Cursor❌Elegant UI, great completionNo Agent mode
Cline (VS Code)✅Full Agent functionalityRequires VS Code
RooCode (VS Code)✅Multi-file editingNewer, evolving
Continue (VS Code)✅Open source, customizableComplex setup

​
Core Features

​
Smart Code Completion

  • Tab completion: Press Tab to accept AI suggestions
  • Multi-line completion: Function-level code generation
  • Context-aware: Precise suggestions based on project structure

​
AI Chat

  • Ctrl/Cmd + K: Open command palette
  • Ctrl/Cmd + L: Open sidebar chat
  • Code explanation: Select code and ask AI

​
Code Editing

  • Generate code: Describe requirements, AI auto-generates
  • Refactoring: Get code optimization suggestions
  • Fix errors: AI helps locate and fix errors

​
Keyboard Shortcuts

ShortcutFunction
Ctrl/Cmd + KOpen AI command palette
Ctrl/Cmd + LOpen AI chat sidebar
TabAccept code suggestion
EscCancel current suggestion

​
Tips

​
Provide Clear Context

// @context: React component for user authentication
// @requirements: Need OAuth2 login support
// @constraints: Compatible with NextJS 13+

​
Optimize Prompts

  • Poor: "Fix this function"
  • Good: "Fix floating-point precision issue in calculateTotal function, ensure amount calculation is accurate to two decimal places"

​
Troubleshooting

  • Check network connection
  • Confirm API URL is https://console.mixroute.io/v1
  • Verify API key is valid
  • Check account balance
  • Try switching to another model
  • Restart Cursor client
  • Provide more project context
  • Use more specific prompts
  • Switch to a better-performing model

​
Best Practices

​
Project-level Config

Create .cursor-settings.json in project root: 
{
  "model": "gpt-4.1",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "Use TypeScript strict mode",
    "Follow ESLint standards",
    "Add appropriate comments"
  ]
}

​
Code Review

Please review this code, focusing on:
1. Performance issues
2. Security vulnerabilities
3. Code standards
4. Best practices

​
About Agent Mode

For AI auto-editing multiple files and complex refactoring, consider:
  • Cline: VS Code plugin with full Agent functionality
  • RooCode: Emerging VS Code AI Agent plugin