=======

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

Provedores de IA

8 provedores, cada um com seu bridge em C. Troque com uma chave de config. Streaming, thinking, tool use — matriz de features por provedor abaixo.

Visão geral

scorpiox code conecta-se a backends de IA via bridges C por provedor. Cada provedor é uma camada de tradução independente. Defina SX_PROVIDER em scorpiox-env.txt para trocar.

Detalhes do provedor

Scorpiox Router scorpiox

Endpoint APIhttps://scorpiox.net:5175

Método de autenticaçãoAnthropic-style headers via router

Arquivo fontesx_provider_scorpiox.c

Modelos

opussonnethaiku

Funcionalidades

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_backend

Chaves de configuração

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

Método de autenticaçãoOAuth Bearer token (auto-fetched)

Arquivo fontesx_provider_claude_code.c

Modelos

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

Funcionalidades

streamingthinkingtool_usetraffic_loggingretry_with_backoffproxy_supporttoken_auto_refreshinterleaved_thinking

Chaves de configuração

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

Método de autenticaçãoOAuth Bearer token (auto-fetched)

Arquivo fontesx_provider_codex.c

Modelos

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

Funcionalidades

streamingthinkingtool_usefunction_callingtraffic_loggingretry_with_backoffsse_parsingtoken_auto_refresh

Chaves de configuração

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

Método de autenticaçãoBearer token (optional, for local servers)

Arquivo fontesx_provider_openai.c

Modelos

Configurable via OPENAI_MODEL

Funcionalidades

tool_usethinkingtraffic_loggingretry_with_backoffhttp_relay_support

Chaves de configuração

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

Método de autenticaçãox-api-key header (official, antigravity, zai, custom)

Arquivo fontesx_provider_anthropic.c

Modelos

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

Funcionalidades

streamingthinkingtool_usetraffic_loggingretry_with_backoffmulti_auth_providermodel_name_mapping

Chaves de configuração

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

Método de autenticaçãoAPI key via VERTEX_API_KEY

Arquivo fontesx_provider_gemini_vertex.c

Modelos

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

Funcionalidades

streamingthinkingtool_usetraffic_loggingretry_with_backoff

Chaves de configuração

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

Método de autenticaçãoOAuth Bearer token (auto-fetched)

Arquivo fontesx_provider_google_gemini.c

Modelos

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

Funcionalidades

streamingsse_parsingthinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Chaves de configuração

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

Método de autenticaçãoOAuth Bearer token (auto-fetched)

Arquivo fontesx_provider_google_claude.c

Modelos

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

Funcionalidades

thinkingtool_usetraffic_loggingretry_with_backoffmulti_endpoint_failovertoken_auto_refresh

Chaves de configuração

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.

Matriz de funcionalidades

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

Configuração

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

Trocar provedor

# 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

Autenticação

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