Claudex

Usa Claude Code con qualsiasi fornitore AI — Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Ollama, Azure, Groq, Mistral e oltre 20 altri.

Inizia Vedi su GitHub

Funzionalita

Proxy di traduzione

Traduzione automatica del protocollo Anthropic-OpenAI. Usa Claude Code con oltre 20 fornitori tra cui Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Azure OpenAI, Groq, Mistral, Together AI, Perplexity, Cerebras e qualsiasi endpoint compatibile con OpenAI.

Circuit Breaker

Circuit breaker per profilo con failover automatico verso fornitori di backup. Soglie di errore configurabili, timeout di recupero e retry OAuth 401 con aggiornamento del token.

Routing intelligente

Routing automatico basato sugli intenti tramite classificatore locale. Mappa automaticamente attivita di codice, analisi, creativita, ricerca e matematica al profilo del fornitore ottimale.

Motore di contesto

Compressione delle conversazioni, condivisione del contesto tra profili e RAG locale con embedding. Migliora le tue interazioni AI con un contesto piu ricco.

Dashboard TUI

Dashboard in tempo reale nel terminale che mostra lo stato dei profili, le metriche delle richieste, i log e le funzionalita di avvio rapido. Navigazione completa da tastiera.

Aggiornamento automatico

Un solo comando per verificare e installare l’ultima versione direttamente da GitHub Releases. Resta aggiornato senza sforzo.

Abbonamenti OAuth

Usa abbonamenti esistenti di Claude, ChatGPT, Google, Qwen, Kimi, GitHub Copilot o GitLab Duo. Supporta browser PKCE, device code flow e catena di credenziali da CLI nativi.

Set di configurazione

Installa e gestisci pacchetti riutilizzabili di regole CLAUDE.md, skill e server MCP tramite claudex sets add. Manifesti versionati con rilevamento dei conflitti.

Hyperlink nel terminale

Hyperlink cliccabili OSC 8 nell’output del terminale. Rilevamento automatico del supporto del terminale (iTerm, WezTerm, Kitty, Ghostty, VS Code, Windows Terminal) con modalita proxy PTY.

Mappatura slot modello

Mappa il selettore /model di Claude Code (haiku, sonnet, opus) a qualsiasi modello del fornitore tramite [profiles.models]. Configurazione modelli per profilo con override tramite variabili d’ambiente.

Modalita non interattiva

Esecuzione one-shot con claudex run <profile> "prompt" --print. Ideale per pipeline CI/CD e automazione con script.

Compatibilita nomi tool

Troncamento automatico dei nomi dei tool superiori a 64 caratteri per compatibilita OpenAI, con ripristino trasparente bidirezionale nelle risposte.

Fornitori supportati

Categoria	Fornitori
Direct Anthropic	Anthropic, MiniMax
OpenAI Compatible	Grok (xAI), OpenAI, DeepSeek, Kimi/Moonshot, GLM (Zhipu), OpenRouter, Groq, Mistral, Together AI, Perplexity, Cerebras
Piattaforme cloud	Azure OpenAI, Google Vertex AI
Abbonamenti OAuth	Claude Max/Pro, ChatGPT Plus/Pro (Codex), Google Gemini, GitHub Copilot, GitLab Duo, Qwen, Kimi
Modelli locali	Ollama, vLLM, LM Studio, llama.cpp
Tramite LiteLLM	AWS Bedrock e qualsiasi fornitore supportato da LiteLLM

Installazione rapida

curl -fsSL https://raw.githubusercontent.com/StringKe/claudex/main/install.sh | bash

Come funziona

claudex run grok
    │
    ├── Start proxy → 127.0.0.1:13456
    │
    └── exec claude with:
        ANTHROPIC_BASE_URL=http://127.0.0.1:13456/proxy/grok
        ANTHROPIC_AUTH_TOKEN=<session-token>
        ANTHROPIC_MODEL=grok-3-beta

Il proxy traduce in modo trasparente tra i protocolli Anthropic e OpenAI, cosi Claude Code funziona senza problemi con qualsiasi fornitore supportato. Quando si utilizzano profili OAuth, viene impostato ANTHROPIC_AUTH_TOKEN (non ANTHROPIC_API_KEY) per evitare conflitti con il meccanismo di login dell’abbonamento nativo di Claude Code.