Cursor
Integrate ARZASTORE AI API with Cursor — AI-powered code editor
Cursor Pro Required
Requirements
Software
- Cursor IDE (latest version)
- Cursor Pro or Business plan
ARZASTORE AI
- Consumer API Key (sk-xxx)
- Subscribed to models on the Marketplace
Configure Custom Model
- 01Open Cursor SettingsPress Ctrl+Shift+J (Windows/Linux) orCmd+Shift+J (macOS) → select <strong>Models</strong>
- 02Add New ModelClick + Add Model, , enter the model name (e.g. gpt-4o or claude-sonnet-4-20250514)
- 03Select Provider: OpenAIIn the provider dropdown, select OpenAI. . ARZASTORE AI API is OpenAI-protocol compatible, so all models use the OpenAI provider.
- 04Configure OpenAI API KeyGo to the OpenAI tab in Settings → paste the API Key: sk-your-api-key
- 05Configure Base URLIn the Override OpenAI Base URL section, enter the endpoint from the Marketplace:https://api.arzastore.com/v1
Press Ctrl+Shift+J (Windows/Linux) orCmd+Shift+J (macOS) → select <strong>Models</strong>
Click + Add Model, , enter the model name (e.g. gpt-4o or claude-sonnet-4-20250514)
In the provider dropdown, select OpenAI. . ARZASTORE AI API is OpenAI-protocol compatible, so all models use the OpenAI provider.
Go to the OpenAI tab in Settings → paste the API Key: sk-your-api-key
In the Override OpenAI Base URL section, enter the endpoint from the Marketplace:
Endpoint URL
Popular Models for Cursor
You can add multiple models and switch based on the task. Here are recommended models:
| Model | Speed | Suitable For | Note |
|---|---|---|---|
| gpt-4o | Fast | Chat, inline edit | General purpose, good price |
| gpt-4o-mini | Very Fast | Tab autocomplete | Cheapest, instant response |
| claude-sonnet-4-20250514 | Medium | Coding, refactor | Strong on code quality |
| gpt-4.1 | Medium | Composer, multi-file | Strong with complex projects |
| gemini-2.5-pro | Slow | Long context, large documents | Very large context window |
AI Shortcuts in Cursor
AI Chat
Open AI chat panel on the right
Inline Edit
Edit code directly at cursor position
Composer (Agent Mode)
Edit multiple files simultaneously with an AI agent
Tab Autocomplete
Accept AI code suggestions
* On macOS, replace Ctrl with Cmd.
.cursorrules File
Create a .cursorrules file in the project root to provide context and rules for the AI:
# .cursorrules - Ví dụ cho dự án React + TypeScript
## Tech Stack
- React 18 + TypeScript
- Ant Design components
- Tailwind CSS for styling
- React Router v7
## Coding Conventions
- Use functional components with hooks
- Prefer named exports
- Use TypeScript interfaces (not types) for props
- Follow existing patterns in the codebase
## File Structure
- Components in src/components/{Domain}/
- Pages in src/pages/
- API services in src/services/
- Utilities in src/utils/
## Important Notes
- Always use the existing design tokens (space-text, space-primary, etc.)
- Mobile responsive is required (use useMediaQuery hook)
- Vietnamese language for UI text
Similar to CLAUDE.md
Troubleshooting
Model not showing in the list
- - Check you clicked Save after adding the model
- - Restart Cursor IDE
- - Check the model name was entered correctly (case-sensitive)
"Request failed" error when chatting
- - Check the API Key is entered correctly in Settings → OpenAI
- - Check the Base URL ends with /v1
- - Ensure you have subscribed to the model on ARZASTORE AI Marketplace
- - Check account balance
Slow response or timeout
- - Try a lighter model (gpt-4o-mini instead of gpt-4o)
- - Check the provider is online on the Marketplace
- - Use fallback strategy to automatically switch providers on failure
- - Subscribe to another provider for the same model
Tips for Effective Cursor Use
- -Use Ctrl+L to chat, then use @file to reference specific files
- -Use Ctrl+I (Composer) for multi-file editing tasks — AI will create a diff for each file
- -Select code then press Ctrl+K for inline editing of the selected code
- -Choose a fast model (gpt-4o-mini) for tab autocomplete and a powerful model (claude-sonnet) for Composer
- -Write detailed .cursorrules to help the AI better understand your codebase