=======

>>>>>>> a6f660b (nav: update feature page links)

Provider AI

8 provider, ognuno con il proprio bridge C. Cambia con una chiave di config. Streaming, thinking, tool use — matrice delle funzionalità sotto.

Panoramica

scorpiox code si connette ai backend AI tramite bridge C specifici. Ogni provider è un layer di traduzione indipendente. Imposta SX_PROVIDER in scorpiox-env.txt per cambiare.

Dettagli provider

Scorpiox Router scorpiox

Endpoint APIhttps://scorpiox.net:5175

Metodo authAnthropic-style headers via router

File sorgentesx_provider_scorpiox.c

Modelli

opussonnethaiku

Funzionalità

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_backend

Chiavi di configurazione

ROUTER_URLAPI_BACKENDMODELSTREAMINGTHINKINGTHINKING_BUDGETTOOLS

Meta-provider that routes through scorpiox.net. API_BACKEND selects upstream: claude, gemini, gemini-internal, glm, llamacpp.

Claude Code claude_code

Endpoint APIhttps://api.anthropic.com/v1/messages?beta=true

Metodo authOAuth Bearer token (auto-fetched)

File sorgentesx_provider_claude_code.c

Modelli

claude-opus-4-6claude-sonnet-4-6claude-haiku-4-5-20251001

Funzionalità

streamingthinkingtool_usetraffic_loggingretry_with_backoffproxy_supporttoken_auto_refreshinterleaved_thinking

Chiavi di configurazione

CLAUDE_CODE_TOKEN_SOURCECLAUDE_CODE_REMOTE_URLCLAUDE_CODE_SSH_HOSTCLAUDE_CODE_SSH_PORTCLAUDE_CODE_SSH_USERCLAUDE_CODE_SSH_PASSCLAUDE_CODE_API_URLCLAUDE_CODE_PROXY_URLCLAUDE_CODE_PROXY_ENABLEDCLAUDE_CODE_PROXY_STRICTMODELSTREAMINGTHINKINGTHINKING_BUDGETTOOLSCLAUDE_MODEL_OPUS_ID_OVERRIDECLAUDE_MODEL_SONNET_ID_OVERRIDECLAUDE_MODEL_HAIKU_ID_OVERRIDE

Native Claude Code CLI emulation. User-Agent: claude-cli/2.0.51. Beta flags: claude-code-20250219, oauth-2025-04-20, interleaved-thinking-2025-05-14.

OpenAI Codex codex

Endpoint APIhttps://chatgpt.com/backend-api/codex/responses

Metodo authOAuth Bearer token (auto-fetched)

File sorgentesx_provider_codex.c

Modelli

gpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codexgpt-5.2codex-auto-review

Funzionalità

streamingthinkingtool_usefunction_callingtraffic_loggingretry_with_backoffsse_parsingtoken_auto_refresh

Chiavi di configurazione

CODEX_TOKEN_SOURCECODEX_REMOTE_URLCODEX_SSH_HOSTCODEX_SSH_PORTCODEX_SSH_USERCODEX_SSH_PASSMODELTOOLS

OpenAI Codex via chatgpt.com backend-api. Always streams internally. Maps opus/sonnet/haiku to gpt-5.5/gpt-5.4/gpt-5.4-mini.

OpenAI-Compatible openai

Endpoint APIConfigurable via OPENAI_BASE_URL

Metodo authBearer token (optional, for local servers)

File sorgentesx_provider_openai.c

Modelli

Configurable via OPENAI_MODEL

Funzionalità

tool_usethinkingtraffic_loggingretry_with_backoffhttp_relay_support

Chiavi di configurazione

OPENAI_API_KEYOPENAI_BASE_URLOPENAI_API_BASEOPENAI_MODELOPENAI_TIMEOUTOPENAI_TRAFFIC_DIROPENAI_TRAFFIC_SEQ

Generic OpenAI-compatible provider. Works with llama.cpp, Ollama, vLLM, etc. Translates Anthropic Messages API to OpenAI Chat Completions via scorpiox-openai binary.

Anthropic API anthropic

Endpoint APIhttps://api.anthropic.com/v1/messages

Metodo authx-api-key header (official, antigravity, zai, custom)

File sorgentesx_provider_anthropic.c

Modelli

claude-opus-4-6claude-sonnet-4-6claude-haiku-4-5-20251001

Funzionalità

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_auth_providermodel_name_mapping

Chiavi di configurazione

ANTHROPIC_API_KEYANTHROPIC_API_URLANTHROPIC_AUTH_PROVIDERANTHROPIC_ANTIGRAVITY_KEYANTHROPIC_ANTIGRAVITY_URLANTHROPIC_ZAI_KEYANTHROPIC_ZAI_URLMODELSTREAMINGTHINKINGTOOLS

Direct Anthropic API with x-api-key. Auth providers: official, antigravity (proxy with model mapping), zai (api.z.ai proxy), custom.

Gemini Vertex AI gemini_vertex

Endpoint APIhttps://aiplatform.googleapis.com/v1/publishers/google/models

Metodo authAPI key via VERTEX_API_KEY

File sorgentesx_provider_gemini_vertex.c

Modelli

gemini-3.1-pro-previewgemini-3.1-flash-lite-previewgemini-3-flash-previewgemini-2.5-progemini-2.5-flash

Funzionalità

streamingthinkingtool_usetraffic_loggingretry_with_backoff

Chiavi di configurazione

VERTEX_API_KEYVERTEX_MODELTRAFFIC_DIR

Google Gemini via Vertex AI with API key auth. Maps opus→gemini-3.1-pro-preview, sonnet→gemini-3-flash-preview, haiku→gemini-3.1-flash-lite-preview.

Google Gemini (Cloud Code) google_gemini

Endpoint APIhttps://cloudcode-pa.googleapis.com/v1internal:streamGenerateContent

Metodo authOAuth Bearer token (auto-fetched)

File sorgentesx_provider_google_gemini.c

Modelli

gemini-3.1-pro-previewgemini-3-flash-previewgemini-3.1-flash-lite-previewgemini-2.5-progemini-2.5-flash

Funzionalità

streamingsse_parsingthinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Chiavi di configurazione

GOOGLE_GEMINI_MODELGOOGLE_ACCOUNTGOOGLE_TOKEN_SOURCEGOOGLE_REMOTE_URLTCP_HOSTTCP_PORTTCP_API_KEY

Google Gemini via cloudcode-pa API with SSE streaming. Failover: cloudcode-pa.googleapis.com, daily-cloudcode-pa.googleapis.com.

Google Claude (Cloud Code) google_claude

Endpoint APIhttps://cloudcode-pa.googleapis.com/v1internal:generateContent

Metodo authOAuth Bearer token (auto-fetched)

File sorgentesx_provider_google_claude.c

Modelli

claude-sonnet-4-6claude-opus-4-6-thinking

Funzionalità

thinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Chiavi di configurazione

GOOGLE_CLAUDE_MODELGOOGLE_ACCOUNTGOOGLE_TOKEN_SOURCEGOOGLE_REMOTE_URLTCP_HOSTTCP_PORTTCP_API_KEY

Claude models via Google cloudcode-pa API. Non-streaming (requestType: claude). Failover endpoints supported.

Matrice funzionalità

Funzionalità	scorpiox	claude_code	codex	openai	anthropic	gemini_vertex	google_gemini	google_claude
function calling	—	—	✓	—	—	—	—	—
http relay support	—	—	—	✓	—	—	—	—
interleaved thinking	—	✓	—	—	—	—	—	—
model name mapping	—	—	—	—	✓	—	—	—
multi auth provider	—	—	—	—	✓	—	—	—
multi backend	✓	—	—	—	—	—	—	—
multi endpoint failover	—	—	—	—	—	—	✓	✓
proxy support	—	✓	—	—	—	—	—	—
retry with backoff	✓	✓	✓	✓	✓	✓	✓	✓
sse parsing	—	—	✓	—	—	—	✓	—
streaming	✓	✓	✓	—	✓	✓	✓	—
thinking	✓	✓	✓	✓	✓	✓	✓	✓
token auto refresh	—	✓	✓	—	—	—	✓	✓
tool use	✓	✓	✓	✓	✓	✓	✓	✓
traffic logging	✓	✓	✓	✓	✓	✓	✓	✓

Configurazione

# scorpiox-env.txt — provider selection
SX_PROVIDER=claude_code

# Model tier (mapped per-provider)
MODEL=opus

# Enable streaming + thinking
STREAMING=true
THINKING=true
THINKING_BUDGET=10000

# Provider-specific: Claude Code token source
CLAUDE_CODE_TOKEN_SOURCE=local
# Provider-specific: Anthropic API key
ANTHROPIC_API_KEY=sk-ant-...
# Provider-specific: OpenAI-compatible endpoint
OPENAI_BASE_URL=http://localhost:8080/v1
# Provider-specific: Vertex AI
VERTEX_API_KEY=AIza...

Cambiare provider

# Switch to Codex
SX_PROVIDER=codex

# Switch to local llama.cpp via OpenAI-compatible
SX_PROVIDER=openai
OPENAI_BASE_URL=http://localhost:8080/v1
OPENAI_MODEL=qwen2.5-coder-32b

# Switch to Gemini via Vertex AI
SX_PROVIDER=gemini_vertex
VERTEX_API_KEY=AIza...

# Switch to Google Gemini (Cloud Code)
SX_PROVIDER=google_gemini
GOOGLE_TOKEN_SOURCE=local

# Switch to Google Claude (Cloud Code)
SX_PROVIDER=google_claude
GOOGLE_TOKEN_SOURCE=local

Autenticazione

OAuth Token (Auto-Refresh)

Used by: claude_code, codex, google_gemini, google_claude. Tokens are fetched automatically via helper binaries (scorpiox-claudecode-fetchtoken, scorpiox-codex-fetchtoken). Token sources: local, remote (SSH), TCP.

API Key (Static)

Used by: anthropic (x-api-key), gemini_vertex (query param), openai (Bearer). Set the key in scorpiox-env.txt and it's passed through on every request.

Router Passthrough

Used by: scorpiox. Sends Anthropic-style headers to the scorpiox.net router, which selects the upstream backend via API_BACKEND (claude, gemini, gemini-internal, glm, llamacpp).