Come configurare l'API LLM per Cursor, Claude Code, Codex

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "max_tokens": 256 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/messages \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -d '{ "model": "MODEL", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A red fox in snow", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Turn the reference into a watercolor illustration", "image_url": "https://example.com/reference.png", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/audio/speech \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Hello from CKEY", "voice": "alloy", "response_format": "mp3" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/videos/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A gentle camera move across a mountain", "seconds": 8 } # Poll: GET https://api.xah.io/v1/videos/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v2/video_generation \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "content": [{"type": "text", "text": "A gentle camera move across a mountain"}], "duration": 6, "ratio": "16:9" } # Poll: GET https://api.xah.io/v2/query/video_generation/JOB_ID # Cancel: DELETE https://api.xah.io/v2/video_generation/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/embeddings \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": ["first text", "second text"] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/rerank \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "documents": ["doc A", "doc B"], "top_n": 2 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/moderations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Text to classify" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/search \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "max_results": 5 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1beta/models/MODEL:generateContent \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "contents": [{"role": "user", "parts": [{"text": "Hello"}]}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/chat \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/generate \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "stream": false }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor dovrebbe usare la modalità OpenAI-compatible con API key personalizzata e base URL personalizzata.

Valori richiesti

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modello: gpt-5.4
Route: chat/completions
Requisito del piano: Richiede un piano Cursor che supporti endpoint API personalizzati.

Passaggi consigliati

1Apri le Impostazioni di Cursor e vai alla sezione AI / Models / API Keys.
2Attiva l'opzione custom OpenAI key o custom provider se la tua versione di Cursor usa nomi diversi.
3Incolla l'API key e la Base URL mostrate qui sotto.
4Scegli il modello suggerito oppure un altro modello attualmente attivo.

Blocco pronto da copiare

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Modelli consigliati

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Note

Cursor usa il flusso OpenAI-compatible, quindi la Base URL deve includere `/v1`.
Se un modello non funziona in Cursor, passa a un altro modello OpenAI-compatible attivo.
Dopo il salvataggio, invia un prompt breve per confermare che la route `chat/completions` funziona.

Anthropic-compatible messages root URL

Claude Code

Claude Code va configurato tramite le variabili d'ambiente Anthropic, ma la Base URL deve restare sul dominio root.

Installazione di Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
Dopo l'installazione, esegui `claude` per verificare. Le impostazioni vengono salvate in `~/.claude/settings.json`.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\\.claude\\settings.json`

Valori richiesti

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io
Modello: claude-opus-5
Route: messages
Max token: 1024

Note

`ANTHROPIC_BASE_URL` non deve includere `/v1`.
Preferisci un modello che supporti la route `messages`.
Se Claude Code ti chiede di autorizzare prima, completa quel login una volta e riavvia con le variabili d'ambiente indicate qui sotto.
Le request che passano dalla route `messages` devono includere il campo `max_tokens`.

Sessione terminale temporanea

export ANTHROPIC_BASE_URL="https://api.xah.io"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
claude --bare

Sessione PowerShell temporanea

$env:ANTHROPIC_BASE_URL = "https://api.xah.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
claude --bare

Impostazioni permanenti

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.xah.io",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

Modelli consigliati

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

OpenAI-compatible VS Code /v1

Estensioni VS Code

La maggior parte delle estensioni VS Code funziona meglio in modalità OpenAI-compatible con una base URL personalizzata.

Valori richiesti

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modello: claude-opus-5
Route: messages or chat/completions
Max token: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-5
    provider: anthropic
    model: claude-opus-5
    apiBase: https://api.xah.io/v1
    apiKey: sk-YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

Cline

Usa il provider OpenAI-compatible, la Base URL con `/v1` e l'API key dal Console.

Roo Code

Usa il provider OpenAI-compatible, la Base URL con `/v1` e l'API key dal Console.

Kilo Code

Usa il provider OpenAI-compatible, la Base URL con `/v1` e l'API key dal Console.

Modelli consigliati

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Note

Usa il provider OpenAI-compatible, la Base URL con `/v1` e l'API key dal Console.
Cursor usa il flusso OpenAI-compatible, quindi la Base URL deve includere `/v1`.
Dopo il salvataggio, invia un prompt breve per confermare che la route `chat/completions` funziona.
Le request che passano dalla route `messages` devono includere il campo `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

L'estensione Codex per VS Code supporta l'API OpenAI-compatible con base URL e API key personalizzate.

Installazione di Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
Dopo l'installazione, esegui `codex` per verificare. Codex legge l'auth da `~/.codex/auth.json` e la config da `~/.codex/config.toml`.
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\\.codex\\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\\.codex\\auth.json`)

Valori richiesti

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modello: gpt-5.4
Route: chat/completions

Passaggi consigliati

1Installa l'estensione Codex dal VS Code Marketplace.
2Apri le Impostazioni di VS Code e cerca la configurazione di Codex.
3Inserisci l'API Key e la Base URL nella sezione di configurazione di Codex.
4Seleziona un modello dall'elenco dei modelli attivi.

Contenuto di `~/.codex/config.toml`

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
personality = "pragmatic"

openai_base_url = "https://api.xah.io/v1"

Contenuto di `~/.codex/auth.json`

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

Modelli consigliati

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Note

Codex usa endpoint OpenAI-compatible, quindi la Base URL deve includere /v1.
Dopo la configurazione, ricarica VS Code per applicare le modifiche.
Testa aprendo un file di codice e provando a chattare con Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid è un assistente CLI che consente di configurare modelli personalizzati tramite un file `settings.json`.

Installazione di Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Dopo l'installazione, esegui `droid` per verificare.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\\.factory\\settings.json`

Valori richiesti

Provider: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modello: gpt-5.4
Route: chat/completions

Note

Ogni voce in `customModels` richiede un `id` univoco e un `index` incrementale (0, 1, 2...).
Imposta il campo `provider` su `openai` per far usare a Droid il flusso OpenAI-compatible.
Puoi aggiungere altri modelli duplicando l'oggetto all'interno dell'array e cambiando `model` + `id`.

Contenuto di `~/.factory/settings.json`

{
    "customModels": [
        {
            "model": "gpt-5.4",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "gpt-5.4",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Modelli consigliati

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Anthropic-compatible JSONC /v1

OpenCode

OpenCode può puntare il provider Anthropic al tuo endpoint e usare la stessa API key.

Installazione di OpenCode

Installa via npm: npm install -g opencode-ai
Dopo l'installazione, esegui `opencode` per verificare. La config si trova in `~/.config/opencode/opencode.json` (o `.jsonc`).

Percorso della config

Windows: `%USERPROFILE%\\.config\\opencode\\opencode.json`
Linux / macOS: `~/.config/opencode/opencode.json`

Valori richiesti

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modello: claude-opus-5
Route: messages
Max token: 1024

Blocco pronto da copiare

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "ckey": {
            "npm": "@ai-sdk/openai-compatible",
            "options": {
                "baseURL": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY"
            },
            "models": {
                "claude-opus-5": {
                    "name": "claude-opus-5"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-4.6"
                },
                "claude-opus-4.7": {
                    "name": "claude-opus-4.7"
                },
                "claude-opus-4.8": {
                    "name": "claude-opus-4.8"
                },
                "claude-opus-5-5": {
                    "name": "claude-opus-5-5"
                },
                "claude-sonnet-4.6": {
                    "name": "claude-sonnet-4.6"
                }
            }
        }
    },
    "model": "ckey/claude-opus-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-5"
        }
    }
}

Modelli consigliati

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

Note

OpenCode dovrebbe puntare all'endpoint con `/v1`.
Preferisci un modello Claude attivo se il tuo workflow usa strumenti in stile Anthropic.
Se cambi modello altrove nella config, mantieni la stessa base URL e la stessa API key indicate qui sotto.
Le request che passano dalla route `messages` devono includere il campo `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw può usare un provider OpenAI-compatible tramite il file `openclaw.json` con l'alias provider `ckey`.

Percorso della config

Root del progetto: `./openclaw.json`
Windows: `%USERPROFILE%\\.openclaw\\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Valori richiesti

Provider: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modello: ckey/gpt-5.4
Route: chat/completions

Blocco pronto da copiare

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ckey/gpt-5.4"
            }
        }
    },
    "models": {
        "providers": {
            "ckey": {
                "baseUrl": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4"
                    },
                    {
                        "id": "claude-opus-4.6",
                        "name": "claude-opus-4.6"
                    },
                    {
                        "id": "claude-opus-4.7",
                        "name": "claude-opus-4.7"
                    },
                    {
                        "id": "claude-opus-4.8",
                        "name": "claude-opus-4.8"
                    },
                    {
                        "id": "claude-sonnet-4.6",
                        "name": "claude-sonnet-4.6"
                    },
                    {
                        "id": "deepseek-4.1-flash-ckey",
                        "name": "deepseek-4.1-flash-ckey"
                    }
                ]
            }
        }
    }
}

Modelli consigliati

ckey/gpt-5.4
ckey/claude-opus-4.6
ckey/claude-opus-4.7
ckey/claude-opus-4.8
ckey/claude-sonnet-4.6
ckey/deepseek-4.1-flash-ckey

Note

OpenClaw dovrebbe usare un `baseUrl` con `/v1`.
Mantieni `api` impostato su `openai-completions` per seguire il flusso OpenAI-compatible.
Puoi aggiungere o rimuovere modelli dalla lista, ma mantieni l'alias `ckey/` e i valori dell'API key allineati all'esempio.

Configura ogni client nel modo giusto

Prima di configurare

Regole per la Base URL

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

Cursor

Valori richiesti

Passaggi consigliati

Blocco pronto da copiare

Modelli consigliati

Note

Claude Code

Installazione di Claude Code

Valori richiesti

Note

Sessione terminale temporanea

Sessione PowerShell temporanea

Impostazioni permanenti

Modelli consigliati

Estensioni VS Code

Valori richiesti

Continue

Cline

Roo Code

Kilo Code

Modelli consigliati

Note

Codex CLI

Installazione di Codex CLI

Valori richiesti

Passaggi consigliati

Contenuto di `~/.codex/config.toml`

Contenuto di `~/.codex/auth.json`

Modelli consigliati

Note

Factory Droid

Installazione di Droid CLI

Valori richiesti

Note

Contenuto di `~/.factory/settings.json`

Modelli consigliati

OpenCode

Installazione di OpenCode

Percorso della config

Valori richiesti

Blocco pronto da copiare

Modelli consigliati

Note

OpenClaw

Percorso della config

Valori richiesti

Blocco pronto da copiare

Modelli consigliati

Note