Skip to content

Cursor: Claude and Codex configuration

Use Cursor's custom OpenAI-compatible model fields for either CloudService model family.

Cursor support is experimental. Cursor does not publish a stable external configuration contract for every custom-model feature. A Cursor update can rename settings, reset a custom model, or route some editor-only features through Cursor's own service.

Automatic configuration

bash
npm install -g cloudservice@latest
cloudservice

Select Cursor. The CLI makes a backup before updating the local Cursor profile, includes every model returned for the key (including a Claude-only catalog through Cursor's OpenAI-compatible route), and asks you to restart Cursor. Run cloudservice doctor after every Cursor upgrade. If verification fails, use the manual fields below; do not repeatedly patch an unknown Cursor version.

Manual configuration for Codex models in Cursor

Open Cursor Settings → Models, add a custom OpenAI-compatible model, and enter:

  • API-credit base URL: https://api.yourdomain.example/v1
  • OpenAI token-pack base URL: https://api.yourdomain.example/token/v1
  • API key: the full key that belongs to that URL
  • Model: one exact Codex model ID below
  • codex-auto-review
  • gpt-5.3-codex
  • gpt-5.4
  • gpt-5.4-mini
  • gpt-5.5
  • gpt-5.6-luna
  • gpt-5.6-sol
  • gpt-5.6-terra

Cursor's custom provider uses its OpenAI-compatible chat path; it is not the native Codex Responses CLI. Features that depend on Cursor's own model contracts may remain unavailable even when chat and agent requests succeed.

Manual configuration for Claude models in Cursor

Use the same custom OpenAI-compatible form, not Cursor's built-in Anthropic account login:

  • API-credit base URL: https://api.yourdomain.example/v1
  • Claude token-pack base URL: https://api.yourdomain.example/token/v1
  • API key: the full key that belongs to that URL
  • Model: one exact Claude model ID below
  • fable-5
  • claude-haiku-4-5-20251001
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-sonnet-5

This is Claude through Cursor's OpenAI-compatible adapter. It is not the native Anthropic Messages setup used by Claude Code.

Verify without a large request

Create a new empty chat, select the custom CloudService model, disable repository context, and send Reply with K only. A single-letter answer confirms the key, URL, and selected model. Then test one read-only agent action before trusting write or terminal operations.

Key and feature boundaries

Do not reuse a key on the other billing URL, paste it into a workspace file, or share Cursor's local profile. CloudService can validate the upstream model request, but it cannot guarantee Cursor-owned autocomplete, background indexing, or proprietary editor features.