Cursor Setup
Cursor can use I Code Easy through its OpenAI-compatible configuration for Chat and Agent. Configure Codex models as described below. Cursor Tab, Background Agents, and other Cursor-native features do not switch to your API key.
Use Codex models
Quick settings
| Setting | Value |
|---|---|
| Provider | OpenAI |
| API Key | Copy it from API Keys |
| Override OpenAI Base URL | https://api.icodeeasy.cc/v1 |
| Recommended model | gpt-5.6-sol |
If the primary domain is slow, use https://jp.icodeeasy.cc/v1 or https://sg.icodeeasy.cc/v1.
Steps
- Open
Cursor Settings → Models → API Keys. - Enter your key under
OpenAI API Keyand keep the provider enabled. - Enable
Override OpenAI Base URLand enterhttps://api.icodeeasy.cc/v1. - Search for
gpt-5.6-soland clickAdd Custom Model. - Select
gpt-5.6-solin Chat or Agent and send a short test message.
Refresh Model Listrefreshes Cursor's built-in catalog; it does not read a custom API service's/v1/models. Add I Code Easy models manually and use the exact model ID.
Use Claude models
Cursor does not currently expose a custom Anthropic Base URL, so an I Code Easy Anthropic-compatible /v1/messages endpoint cannot be configured in Cursor.
Do not try to work around this by adding a Claude model ID under the OpenAI provider. That setup sends an OpenAI-compatible Chat Completions request rather than a native Anthropic Messages request and is not a supported Claude configuration.
Compatibility notes
- Cursor currently exposes only an OpenAI Base URL override. It cannot route a third-party Anthropic-compatible
/v1/messagesendpoint through a separate Anthropic Base URL. - Cursor Tab always uses Cursor's own models.
- Agent may issue tool calls and several requests in a short period. If Chat works but Agent fails, verify the base connection in Chat first, then check model capability and quota.
- BYOK requests still pass through Cursor's backend for final prompt construction. Cursor says keys are not stored, but its Zero Data Retention policy does not apply to BYOK.
Troubleshooting
| Symptom | Fix |
|---|---|
| The model is missing after refresh | Use Add Custom Model and enter gpt-5.6-sol manually |
404 or /v1/v1 in the path | Use only https://api.icodeeasy.cc/v1, not the full /chat/completions endpoint |
| Chat works but Tab is unchanged | Expected: Cursor Tab does not use BYOK |
| Claude models from a custom API do not work | Cursor has no third-party Anthropic Base URL; use the Codex model setup above |
Official references
Verified against Cursor official help and staff guidance on 2026-07-16.
Related guides
VS Code Setup
Install and configure Codex or Claude extensions in VS Code, use secure credentials and custom API addresses, and resolve login prompts.
Codex Setup
Install Codex CLI, store the API key in auth.json, configure the I Code Easy provider and Base URL, and start a first Codex session.
Claude Code / Desktop Setup
Install Claude Code or Claude Desktop, store credentials safely, configure the I Code Easy API address, and verify a first session.