Claudex
MCP server with persistent memory + FTS5 search for Claude Code conversation history. Index your ~/.claude/projects/, expose 10 MCP tools, browse via web UI. MIT-licensed.
Last verified:
What is Claudex?
Claudex is a multi-instance Claude Code manager and translation proxy that enables developers to use Claude Code with any AI provider. It bridges Claude Code and OpenAI Codex CLI sessions, seamlessly sharing context and maintaining state across tools without losing momentum. By watching transcript files in real-time, Claudex maintains a rolling context per project, ensuring that whichever tool you open next already understands your current task, plan, and recently touched files.
Key features include a translation proxy that automatically translates between Anthropic and OpenAI protocols, supporting 20+ providers including Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Azure OpenAI, Groq, Mistral, Together AI, Perplexity, Cerebras, and any OpenAI-compatible endpoint. The circuit breaker provides per-profile failover with automatic backup provider switching, configurable failure thresholds, and OAuth 401 retry with token refresh. Smart routing uses intent-based auto-routing via a local classifier to automatically map code, analysis, creative, search, and math tasks to the optimal provider profile.
The Context Engine offers conversation compression, cross-profile context sharing, and local RAG with embeddings to enhance AI interactions with richer context. A real-time TUI dashboard shows profile health, request metrics, logs, and quick-launch capabilities with full keyboard navigation. Claudex is open-source and designed for developers, QA engineers, and researchers who need to inspect, search, and manage Claude conversations across multiple projects and providers.
Additional features include OAuth subscriptions supporting Claude Max/Pro, ChatGPT Plus/Pro, Google Gemini, GitHub Copilot, GitLab Duo, and Qwen; configuration sets for installing reusable bundles of CLAUDE.md rules, skills, and MCP servers; terminal hyperlinks with OSC 8 clickable links; model slot mapping for per-profile model configuration; and non-interactive mode for CI/CD pipelines.
Claudex pricing
Pricing model: Freemium
Claudex is completely free and open-source. It is a local & private tool that runs on your machine with no subscription fees. Users can leverage their existing OAuth subscriptions from Claude Max/Pro, ChatGPT Plus/Pro (Codex), Google Gemini, GitHub Copilot, GitLab Duo, Qwen, and Kimi without additional costs from Claudex itself.
Claudex pros
- Supports 20+ AI providers including Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Azure, Groq, Mistral
- Automatic Anthropic-to-OpenAI protocol translation works seamlessly
- Preserves context when switching between Claude Code and OpenAI Codex CLI
- Per-profile circuit breaker with automatic failover to backup providers
- Intent-based smart routing maps tasks to optimal provider automatically
- Real-time TUI dashboard with keyboard navigation and profile health monitoring
- Local RAG with embeddings for enhanced context in AI interactions
- Uses existing subscriptions from Claude, ChatGPT, Google, GitHub Copilot, GitLab Duo
- Open-source and local & private with no cloud data sharing
- One-command self-update from GitHub Releases
- Non-interactive mode ideal for CI/CD pipelines and automation
- Terminal hyperlinks with OSC 8 clickable links in output
- Model slot mapping allows per-profile model configuration
- Configuration sets for reusable bundles of rules, skills, and MCP servers
- Conversation compression reduces token usage across profiles
- Auto-truncates tool names over 64 characters for OpenAI compatibility
Claudex cons
- Requires terminal knowledge for TUI dashboard usage
- Setup complexity with multiple provider configurations
- OAuth setup may be confusing for non-technical users
- Only works with Claude Code CLI, not web interface
- Local RAG embeddings require initial build time of 1-2 minutes
- Circuit breaker adds latency during failover scenarios
- Limited documentation compared to commercial alternatives
- Terminal hyperlinks only work with specific terminals (iTerm, WezTerm, Kitty, VS Code)
Frequently asked questions about Claudex
What is Claudex and what does it do?
Claudex is a multi-instance Claude Code manager and translation proxy that enables you to use Claude Code with any AI provider including Grok, ChatGPT, DeepSeek, Gemini, Kimi, GLM, Azure OpenAI, Groq, Mistral, and 20+ more. It bridges local sessions between Claude Code and OpenAI Codex CLI, seamlessly sharing context and maintaining state across tools without losing momentum. The proxy transparently translates between Anthropic and OpenAI protocols.
Is Claudex free to use?
Yes, Claudex is completely free and open-source. It is a local & private tool with no subscription fees. You can use your existing OAuth subscriptions from Claude, ChatGPT, Google, Qwen, Kimi, GitHub Copilot, or GitLab Duo through Claudex without paying additional costs.
Which AI providers does Claudex support?
Claudex supports 20+ providers across multiple categories: Direct Anthropic (Anthropic, MiniMax), OpenAI Compatible (Grok/xAI, OpenAI, DeepSeek, Kimi/Moonshot, GLM/Zhipu, OpenRouter, Groq, Mistral, Together AI, Perplexity, Cerebres), Cloud Platforms (Azure OpenAI, Google Vertex AI), OAuth Subscriptions (Claude Max/Pro, ChatGPT Plus/Pro, Google Gemini, GitHub Copilot, GitLab Duo, Qwen, Kimi), Local Models (Ollama, vLLM, LM Studio, llama.cpp), and via LiteLLM (AWS Bedrock and any LiteLLM-supported provider).
How does the circuit breaker feature work?
The circuit breaker provides per-profile failure protection with automatic failover to backup providers. It includes configurable failure thresholds and recovery timeouts. When a provider fails, it automatically switches to a backup. It also supports OAuth 401 retry with automatic token refresh, ensuring your workflow continues without manual intervention.
What is the smart routing feature?
Smart routing uses intent-based auto-routing via a local classifier to automatically map different task types to the optimal provider profile. It automatically routes code tasks, analysis tasks, creative tasks, search tasks, and math tasks to the provider best suited for each type, optimizing performance and cost without manual selection.
How do I install Claudex?
Claudex can be installed via the quick install method from GitHub. After installation, you can use the self-update feature with one command to check and install the latest version directly from GitHub Releases. The tool runs locally on your machine and requires setting ANTHROPIC_AUTH_TOKEN (not ANTHROPIC_API_KEY) for OAuth profiles to avoid conflicts with Claude's own subscription login.
What is the TUI dashboard?
The TUI dashboard is a real-time terminal interface for monitoring and managing profiles. It displays the profile list with name, model, provider type, and health status; color-coded health indicators (green=healthy, yellow=degraded, red=circuit breaker open); a metrics panel showing per-profile request count, success rate, and average latency; and a real-time scrolling log panel. It supports full keyboard navigation with shortcuts like j/k for movement, Enter to launch Claude Code, t to test connectivity, a to add profiles, d to delete, p to toggle proxy, / for search, and q to quit.
How does context sharing work across projects?
Claudex watches transcript files in real-time and maintains a rolling context per project. The Context Engine provides conversation compression, cross-profile context sharing, and local RAG with embeddings. This ensures that whichever tool you open next already understands your current task, plan, and recently touched files, eliminating the need to re-explain your work when switching between Claude Code and OpenAI Codex CLI.
Can I use Claudex for CI/CD automation?
Yes, Claudex supports non-interactive mode with the command 'claudex run <profile> "prompt" --print' which is ideal for CI/CD pipelines and scripted automation. This one-shot execution mode allows you to integrate Claudex into automated workflows without requiring interactive terminal input.
What are configuration sets?
Configuration sets are reusable bundles of CLAUDE.md rules, skills, and MCP servers that you can install and manage via 'claudex sets add'. They include versioned manifests with conflict detection, allowing you to easily share and deploy standardized configurations across projects or team members. This feature streamlines setup and ensures consistency across different development environments.