Claudex

Use o Claude Code com qualquer provedor de IA — Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Ollama, Azure, Groq, Mistral e mais de 20 outros.

Comecar Ver no GitHub

Funcionalidades

Proxy de Traducao

Traducao automatica do protocolo Anthropic para OpenAI. Use o Claude Code com mais de 20 provedores incluindo Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Azure OpenAI, Groq, Mistral, Together AI, Perplexity, Cerebras e qualquer endpoint compativel com OpenAI.

Circuit Breaker

Circuit breaker por profile com failover automatico para provedores de backup. Limites de falha configuraveis, timeouts de recuperacao e retry OAuth 401 com refresh de token.

Roteamento Inteligente

Roteamento automatico baseado em intencao via classificador local. Mapeia automaticamente tarefas de codigo, analise, criacao, pesquisa e matematica para o profile de provedor ideal.

Motor de Contexto

Compressao de conversa, compartilhamento de contexto entre profiles e RAG local com embeddings. Aprimore suas interacoes de IA com contexto mais rico.

Dashboard TUI

Dashboard em tempo real no terminal mostrando saude dos profiles, metricas de requisicoes, logs e capacidade de lancamento rapido. Navegacao completa por teclado.

Auto-atualizacao

Um comando para verificar e instalar a versao mais recente diretamente do GitHub Releases. Mantenha-se atualizado sem esforco.

Assinaturas OAuth

Use assinaturas existentes do Claude, ChatGPT, Google, Qwen, Kimi, GitHub Copilot ou GitLab Duo. Suporta PKCE via navegador, device code flow e cadeia de credenciais de CLIs nativos.

Conjuntos de Configuracao

Instale e gerencie pacotes reutilizaveis de regras CLAUDE.md, skills e servidores MCP via claudex sets add. Manifestos versionados com deteccao de conflitos.

Hyperlinks no Terminal

Hyperlinks clicaveis OSC 8 na saida do terminal. Detecta automaticamente suporte do terminal (iTerm, WezTerm, Kitty, Ghostty, VS Code, Windows Terminal) com modo PTY proxy.

Mapeamento de Slots de Modelo

Mapeie o seletor /model do Claude Code (haiku, sonnet, opus) para qualquer modelo de provedor via [profiles.models]. Configuracao de modelo por profile com overrides por variavel de ambiente.

Modo Nao-Interativo

Execucao one-shot com claudex run <profile> "prompt" --print. Ideal para pipelines CI/CD e automacao via scripts.

Compatibilidade de Nomes de Ferramentas

Truncamento automatico de nomes de ferramentas com mais de 64 caracteres para compatibilidade com OpenAI, com restauracao transparente de ida e volta nas respostas.

Provedores Suportados

Categoria	Provedores
Anthropic Direto	Anthropic, MiniMax
Compativel com OpenAI	Grok (xAI), OpenAI, DeepSeek, Kimi/Moonshot, GLM (Zhipu), OpenRouter, Groq, Mistral, Together AI, Perplexity, Cerebras
Plataformas Cloud	Azure OpenAI, Google Vertex AI
Assinaturas OAuth	Claude Max/Pro, ChatGPT Plus/Pro (Codex), Google Gemini, GitHub Copilot, GitLab Duo, Qwen, Kimi
Modelos Locais	Ollama, vLLM, LM Studio, llama.cpp
Via LiteLLM	AWS Bedrock e qualquer provedor suportado pelo LiteLLM

Instalacao Rapida

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

Como Funciona

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

O proxy traduz de forma transparente entre os protocolos Anthropic e OpenAI, permitindo que o Claude Code funcione perfeitamente com qualquer provedor suportado. Ao usar profiles OAuth, ANTHROPIC_AUTH_TOKEN (e nao ANTHROPIC_API_KEY) e definido para evitar conflitos com o mecanismo de login por assinatura do proprio Claude.