Third-party clients

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

SettingValue
ProviderOpenAI
API KeyCopy it from API Keys
Override OpenAI Base URLhttps://api.icodeeasy.cc/v1
Recommended modelgpt-5.6-sol

If the primary domain is slow, use https://jp.icodeeasy.cc/v1 or https://sg.icodeeasy.cc/v1.

Steps

  1. Open Cursor Settings → Models → API Keys.
  2. Enter your key under OpenAI API Key and keep the provider enabled.
  3. Enable Override OpenAI Base URL and enter https://api.icodeeasy.cc/v1.
  4. Search for gpt-5.6-sol and click Add Custom Model.
  5. Select gpt-5.6-sol in Chat or Agent and send a short test message.

Refresh Model List refreshes 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/messages endpoint 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

SymptomFix
The model is missing after refreshUse Add Custom Model and enter gpt-5.6-sol manually
404 or /v1/v1 in the pathUse only https://api.icodeeasy.cc/v1, not the full /chat/completions endpoint
Chat works but Tab is unchangedExpected: Cursor Tab does not use BYOK
Claude models from a custom API do not workCursor 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.