Claudex

Usa Claude Code con cualquier proveedor de IA — Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Ollama, Azure, Groq, Mistral y mas de 20 mas.

Empezar Ver en GitHub

Funcionalidades

Proxy de traduccion

Traduccion automatica del protocolo Anthropic a OpenAI. Usa Claude Code con mas de 20 proveedores incluyendo Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Azure OpenAI, Groq, Mistral, Together AI, Perplexity, Cerebras y cualquier endpoint compatible con OpenAI.

Circuit Breaker

Circuit breaker por perfil con failover automatico a proveedores de respaldo. Umbrales de fallo configurables, tiempos de recuperacion y reintento en 401 OAuth con refresco de token.

Enrutamiento inteligente

Enrutamiento automatico basado en intencion mediante clasificador local. Asigna automaticamente tareas de codigo, analisis, creativas, busqueda y matematicas al perfil de proveedor optimo.

Motor de contexto

Compresion de conversaciones, comparticion de contexto entre perfiles y RAG local con embeddings. Mejora tus interacciones con IA mediante un contexto mas rico.

Panel TUI

Panel en terminal en tiempo real mostrando salud de perfiles, metricas de solicitudes, logs y capacidades de lanzamiento rapido. Navegacion completa por teclado.

Actualizacion automatica

Un solo comando para verificar e instalar la ultima version directamente desde GitHub Releases. Mantente actualizado sin esfuerzo.

Suscripciones OAuth

Usa suscripciones existentes de Claude, ChatGPT, Google, Qwen, Kimi, GitHub Copilot o GitLab Duo. Soporta PKCE en navegador, flujo de codigo de dispositivo y cadena de credenciales desde CLIs nativos.

Conjuntos de configuracion

Instala y gestiona paquetes reutilizables de reglas CLAUDE.md, habilidades y servidores MCP con claudex sets add. Manifiestos versionados con deteccion de conflictos.

Hipervinculos en terminal

Hipervinculos clicables OSC 8 en la salida del terminal. Detecta automaticamente el soporte del terminal (iTerm, WezTerm, Kitty, Ghostty, VS Code, Windows Terminal) con modo proxy PTY.

Mapeo de slots de modelo

Mapea el selector /model de Claude Code (haiku, sonnet, opus) a cualquier modelo de proveedor via [profiles.models]. Configuracion de modelos por perfil con sobreescritura mediante variables de entorno.

Modo no interactivo

Ejecucion de un solo uso con claudex run <profile> "prompt" --print. Ideal para pipelines CI/CD y automatizacion mediante scripts.

Compatibilidad de nombres de herramientas

Trunca automaticamente nombres de herramientas que superan 64 caracteres para compatibilidad con OpenAI, con restauracion transparente en las respuestas.

Proveedores soportados

Categoria	Proveedores
Anthropic directo	Anthropic, MiniMax
Compatible con OpenAI	Grok (xAI), OpenAI, DeepSeek, Kimi/Moonshot, GLM (Zhipu), OpenRouter, Groq, Mistral, Together AI, Perplexity, Cerebras
Plataformas en la nube	Azure OpenAI, Google Vertex AI
Suscripciones OAuth	Claude Max/Pro, ChatGPT Plus/Pro (Codex), Google Gemini, GitHub Copilot, GitLab Duo, Qwen, Kimi
Modelos locales	Ollama, vLLM, LM Studio, llama.cpp
Via LiteLLM	AWS Bedrock y cualquier proveedor soportado por LiteLLM

Instalacion rapida

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

Como funciona

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

El proxy traduce de forma transparente entre los protocolos Anthropic y OpenAI, permitiendo que Claude Code funcione sin problemas con cualquier proveedor soportado. Al usar perfiles OAuth, se establece ANTHROPIC_AUTH_TOKEN (y no ANTHROPIC_API_KEY) para evitar conflictos con el mecanismo de inicio de sesion por suscripcion propio de Claude.