<<<<<<< HEAD
=======
>>>>>>> a6f660b (nav: update feature page links)
홈 › AI 프로바이더

AI 프로바이더

8개 프로바이더, 각각 C 브릿지 보유. 설정 키 하나로 전환. 스트리밍, 씽킹, 도구 사용 — 프로바이더별 기능 매트릭스는 아래.

개요

scorpiox code는 프로바이더별 C 브릿지를 통해 AI 백엔드에 연결됩니다. 각 프로바이더는 독립적인 변환 레이어입니다. scorpiox-env.txt의 SX_PROVIDER로 전환.

프로바이더 상세

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