=======

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

AI Providers

8 providers, each with its own C bridge. Switch with one config key. Streaming, thinking, tool use — per-provider feature matrix below.

Overview

scorpiox code connects to AI backends through provider-specific C bridges. Each provider is a standalone translation layer — it converts the internal message format to the provider's API, handles auth, streaming, and error recovery. Set SX_PROVIDER in scorpiox-env.txt to switch. All providers share the same tool interface.

Provider Details

Scorpiox Router scorpiox

API Endpointhttps://scorpiox.net:5175

Auth MethodAnthropic-style headers via router

Source Filesx_provider_scorpiox.c

Models

opussonnethaiku

Features

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_backend

Config Keys

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 Endpointhttps://api.anthropic.com/v1/messages?beta=true

Auth MethodOAuth Bearer token (auto-fetched)

Source Filesx_provider_claude_code.c

Models

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

Features

streamingthinkingtool_usetraffic_loggingretry_with_backoffproxy_supporttoken_auto_refreshinterleaved_thinking

Config Keys

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 Endpointhttps://chatgpt.com/backend-api/codex/responses

Auth MethodOAuth Bearer token (auto-fetched)

Source Filesx_provider_codex.c

Models

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

Features

streamingthinkingtool_usefunction_callingtraffic_loggingretry_with_backoffsse_parsingtoken_auto_refresh

Config Keys

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 EndpointConfigurable via OPENAI_BASE_URL

Auth MethodBearer token (optional, for local servers)

Source Filesx_provider_openai.c

Models

Configurable via OPENAI_MODEL

Features

tool_usethinkingtraffic_loggingretry_with_backoffhttp_relay_support

Config Keys

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 Endpointhttps://api.anthropic.com/v1/messages

Auth Methodx-api-key header (official, antigravity, zai, custom)

Source Filesx_provider_anthropic.c

Models

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

Features

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_auth_providermodel_name_mapping

Config Keys

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 Endpointhttps://aiplatform.googleapis.com/v1/publishers/google/models

Auth MethodAPI key via VERTEX_API_KEY

Source Filesx_provider_gemini_vertex.c

Models

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

Features

streamingthinkingtool_usetraffic_loggingretry_with_backoff

Config Keys

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 Endpointhttps://cloudcode-pa.googleapis.com/v1internal:streamGenerateContent

Auth MethodOAuth Bearer token (auto-fetched)

Source Filesx_provider_google_gemini.c

Models

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

Features

streamingsse_parsingthinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Config Keys

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 Endpointhttps://cloudcode-pa.googleapis.com/v1internal:generateContent

Auth MethodOAuth Bearer token (auto-fetched)

Source Filesx_provider_google_claude.c

Models

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

Features

thinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Config Keys

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.

Feature Matrix

Features	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	✓	✓	✓	✓	✓	✓	✓	✓

Configuration

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

Switching Providers

# 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

Authentication

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