Claudex

Claudex is a fork of the Claude Code source that adds a full OpenAI-compatible provider shim, NVIDIA AI (NIM) support, a smart multi-provider router, a Telegram gateway, and local inference via Ollama and Atomic Chat. Every Claude Code tool works — bash, file ops, grep, glob, agents, MCP, tasks — powered by whatever model you choose.

Author: Lakshmikanthan K — github.com/l3tchupkt

---

Install

npm install -g @letchu_pkt/claudex

claudex

On first run, if no provider is configured, Claudex will prompt you to set one up via /provider. No Anthropic account required.

---

Fastest Start

Pick a provider, set three env vars, run.

NVIDIA AI — free key, best models

export CLAUDE_CODE_USE_NVIDIA=1
export NVIDIA_API_KEY=nvapi-your-key
export NVIDIA_MODEL=moonshotai/kimi-k2-instruct
claudex

Free key at build.nvidia.com.

OpenAI

export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key
export OPENAI_MODEL=gpt-4o
claudex

Google Gemini — free key

export CLAUDE_CODE_USE_GEMINI=1
export GEMINI_API_KEY=your-key
export GEMINI_MODEL=gemini-2.0-flash
claudex

Free key at aistudio.google.com/apikey.

Ollama — fully local, no key

ollama pull llama3.1:8b
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=llama3.1:8b
claudex

---

Guides

Audience	Guide
New to terminals	Non-Technical Setup
Windows	Windows Quick Start
macOS / Linux	macOS / Linux Quick Start
Android (Termux)	Android Install
Source builds, profiles, diagnostics	Advanced Setup
Daily Ollama workflow	Playbook
Telegram bot	Telegram Gateway

---

Supported Providers

Provider	Env flag	Key var
NVIDIA AI (NIM)	CLAUDE_CODE_USE_NVIDIA=1	NVIDIA_API_KEY
OpenAI / any OpenAI-compatible	CLAUDE_CODE_USE_OPENAI=1	OPENAI_API_KEY
Google Gemini	CLAUDE_CODE_USE_GEMINI=1	GEMINI_API_KEY
GitHub Models	CLAUDE_CODE_USE_GITHUB=1	GITHUB_TOKEN
Amazon Bedrock	CLAUDE_CODE_USE_BEDROCK=1	AWS credentials
Google Vertex AI	CLAUDE_CODE_USE_VERTEX=1	GCP credentials
Microsoft Foundry	CLAUDE_CODE_USE_FOUNDRY=1	ANTHROPIC_FOUNDRY_API_KEY
Ollama (local)	CLAUDE_CODE_USE_OPENAI=1 + localhost URL	none
Atomic Chat (Apple Silicon)	CLAUDE_CODE_USE_OPENAI=1 + 127.0.0.1:1337	none
Anthropic (default)	none	ANTHROPIC_API_KEY

Any OpenAI-compatible endpoint works: DeepSeek, Groq, Mistral, Together AI, OpenRouter, LM Studio, Azure OpenAI, and more.

---

NVIDIA AI Models

Model	Best for
moonshotai/kimi-k2-instruct	Reasoning, coding (default)
nvidia/llama-3.1-nemotron-ultra-253b-v1	Flagship quality
meta/llama-3.3-70b-instruct	Balanced speed/quality
meta/llama-3.1-8b-instruct	Fast, lightweight
deepseek-ai/deepseek-r1	Deep reasoning
qwen/qwen3-235b-a22b	Large MoE
mistralai/mistral-large-2-instruct	Instruction following

---

Startup Themes

Set CLAUDEX_THEME to change the banner color scheme: