<<<<<<< HEAD
=======
>>>>>>> a6f660b (nav: update feature page links)

AI-провайдеры

8 провайдеров, каждый со своим мостом на C. Переключение одним ключом. Стриминг, мышление, инструменты — матрица фич по провайдерам ниже.

Обзор

scorpiox code подключается к AI-бэкендам через провайдер-специфичные мосты на C. Каждый провайдер — автономный слой трансляции. Установите SX_PROVIDER в scorpiox-env.txt для переключения.

Детали провайдеров

Scorpiox Router scorpiox
API-эндпоинтhttps://scorpiox.net:5175
Метод аутентификацииAnthropic-style headers via router
Исходный файлsx_provider_scorpiox.c

Модели

opussonnethaiku

Функции

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_backend

Ключи конфигурации

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
API-эндпоинтhttps://api.anthropic.com/v1/messages?beta=true
Метод аутентификацииOAuth Bearer token (auto-fetched)
Исходный файлsx_provider_claude_code.c

Модели

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

Функции

streamingthinkingtool_usetraffic_loggingretry_with_backoffproxy_supporttoken_auto_refreshinterleaved_thinking

Ключи конфигурации

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
API-эндпоинтhttps://chatgpt.com/backend-api/codex/responses
Метод аутентификацииOAuth Bearer token (auto-fetched)
Исходный файлsx_provider_codex.c

Модели

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

Функции

streamingthinkingtool_usefunction_callingtraffic_loggingretry_with_backoffsse_parsingtoken_auto_refresh

Ключи конфигурации

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
API-эндпоинтConfigurable via OPENAI_BASE_URL
Метод аутентификацииBearer token (optional, for local servers)
Исходный файлsx_provider_openai.c

Модели

Configurable via OPENAI_MODEL

Функции

tool_usethinkingtraffic_loggingretry_with_backoffhttp_relay_support

Ключи конфигурации

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
API-эндпоинтhttps://api.anthropic.com/v1/messages
Метод аутентификацииx-api-key header (official, antigravity, zai, custom)
Исходный файлsx_provider_anthropic.c

Модели

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

Функции

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_auth_providermodel_name_mapping

Ключи конфигурации

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
API-эндпоинтhttps://aiplatform.googleapis.com/v1/publishers/google/models
Метод аутентификацииAPI key via VERTEX_API_KEY
Исходный файлsx_provider_gemini_vertex.c

Модели

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

Функции

streamingthinkingtool_usetraffic_loggingretry_with_backoff

Ключи конфигурации

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
API-эндпоинтhttps://cloudcode-pa.googleapis.com/v1internal:streamGenerateContent
Метод аутентификацииOAuth Bearer token (auto-fetched)
Исходный файлsx_provider_google_gemini.c

Модели

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

Функции

streamingsse_parsingthinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Ключи конфигурации

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
API-эндпоинтhttps://cloudcode-pa.googleapis.com/v1internal:generateContent
Метод аутентификацииOAuth Bearer token (auto-fetched)
Исходный файлsx_provider_google_claude.c

Модели

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

Функции

thinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Ключи конфигурации

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.

Матрица функций

Функцииscorpioxclaude_codecodexopenaianthropicgemini_vertexgoogle_geminigoogle_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

Конфигурация

# 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...

Смена провайдера

# 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

Аутентификация

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).