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

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) message = client.messages.create( model="claude-opus-5", max_tokens=1024, messages=[ {"role": "user", "content": "Write a fizzbuzz in Python."} ], ) print(message.content)

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) with client.messages.stream( model="claude-opus-5", max_tokens=1024, messages=[ {"role": "user", "content": "Tell me a short story."} ], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) print()

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) response = client.chat.completions.create( model="gpt-5.4", messages=[ {"role": "user", "content": "Hello from CKEY"} ], ) print(response.choices[0].message.content)

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) stream = client.chat.completions.create( model="gpt-5.4", stream=True, messages=[ {"role": "user", "content": "Write a short poem."} ], ) for chunk in stream: delta = chunk.choices[0].delta.content or "" if delta: print(delta, end="", flush=True) print()

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const message = await client.messages.create({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Write a fizzbuzz in Python." }], }); console.log(message.content);

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const stream = client.messages .stream({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Tell me a short story." }], }) .on("text", (text) => { process.stdout.write(text); }); await stream.finalMessage(); process.stdout.write("\n");

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const response = await client.chat.completions.create({ model: "gpt-5.4", messages: [{ role: "user", content: "Hello from CKEY" }], }); console.log(response.choices[0]?.message?.content);

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const stream = await client.chat.completions.create({ model: "gpt-5.4", stream: true, messages: [{ role: "user", content: "Write a short poem." }], }); for await (const chunk of stream) { const delta = chunk.choices[0]?.delta?.content ?? ""; if (delta) { process.stdout.write(delta); } } process.stdout.write("\n");

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model":"claude-opus-5", "max_tokens":1024, "messages":[ {"role":"user","content":"Write a fizzbuzz in Python."} ] }'

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --no-buffer \ -d '{ "model":"claude-opus-5", "max_tokens":1024, "stream":true, "messages":[ {"role":"user","content":"Tell me a short story."} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"gpt-5.4", "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ --no-buffer \ -d '{ "model":"gpt-5.4", "stream":true, "messages":[ {"role":"user","content":"Write a short poem."} ] }'

curl "https://api.xah.io/v1beta/models/gemini-2.5-flash-lite:generateContent" \ -H "Content-Type: application/json" \ -H "x-goog-api-key: sk-YOUR_API_KEY" \ -d '{ "contents":[ {"role":"user","parts":[{"text":"Write a fizzbuzz in Python."}]} ] }'

curl https://api.xah.io/api/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"glm-5.2", "stream":false, "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/api/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"glm-5.2", "prompt":"Hello from CKEY", "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: deepseek-v4-flash-0731
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: deepseek-v4-flash-0731
Route: chat/completions

Modelli consigliati

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

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
gpt-5.4
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-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-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

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: deepseek-v4-flash-0731
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 = "deepseek-v4-flash-0731"
model_reasoning_effort = "high"
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-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

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: deepseek-v4-flash-0731
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": "deepseek-v4-flash-0731",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "deepseek-v4-flash-0731",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Modelli consigliati

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

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"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                },
                "gpt-5.5": {
                    "name": "gpt-5.5"
                },
                "claude-haiku-4.5": {
                    "name": "claude-haiku-4.5"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-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
gpt-5.4
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-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-5",
                        "name": "claude-opus-5"
                    },
                    {
                        "id": "deepseek-v4-flash",
                        "name": "deepseek-v4-flash"
                    },
                    {
                        "id": "gpt-5.5",
                        "name": "gpt-5.5"
                    },
                    {
                        "id": "claude-haiku-4.5",
                        "name": "claude-haiku-4.5"
                    },
                    {
                        "id": "claude-opus-4.6",
                        "name": "claude-opus-4.6"
                    }
                ]
            }
        }
    }
}

Modelli consigliati

ckey/gpt-5.4
ckey/claude-opus-5
ckey/deepseek-v4-flash
ckey/gpt-5.5
ckey/claude-haiku-4.5
ckey/claude-opus-4.6

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

SDK

Request Anthropic API

Streaming Anthropic API

Request OpenAI-compatible

Streaming OpenAI-compatible

Request Anthropic API

Streaming Anthropic API

Request OpenAI-compatible

Streaming OpenAI-compatible

Request Anthropic API

Streaming Anthropic API

Request OpenAI-compatible

Streaming OpenAI-compatible

Request Gemini (Google)

Request Ollama

Ollama Generate (/api/generate)

Invia un'immagine locale come base64

Invia un'immagine tramite URL

Base URL

Modello

API Key

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