Installation version 0.153.4
API protocol Responses API
Credentials Dedicated app key
Setup Isolated configuration From install to first prompt Run the installation command Select your system and model. Connect downloads a private runtime and the app’s pinned release.
Connect your account in the browser Check the device code and approve a dedicated API key. The installer receives it through an encrypted, single-use connection.
Open your configured app Use the launcher path printed in your terminal with run codex-cli. API key, base URL and model are already set.
Install & connect One command installs the app. Approve in your browser to configure the key, endpoint and model.
CLI Desktop configuration
macOS Linux Windows
ModelBaseten: Joey 1 Particle AI: Particle-1 LiquidAI: d1.1 LiquidAI: d1-ultra Latest LiquidAI: d1 Latest Amazon: Titan Multimodal Embeddings G1 Amazon: Titan Embeddings G1 - Text Amazon: Titan Text Embeddings V2 OpenAI: GPT-6.1 Terra Pro OpenAI: GPT-6.1 Terra Pro (batch) OpenAI: GPT-6.1 Terra OpenAI: GPT-6.1 Terra (batch) MoonshotAI: Kimi K3.1 Pro Recursive: Flint (free) Baseten: Mammoth 1 Baseten: Elephant 1 Nace.AI: Drex Max NVIDIA: Nemotron 3.5 Embed 1B (free) NVIDIA: Nemotron 3.5 Embed 8B (free) MiniMax: MiniMax M3.1 Flash DeepSeek: DeepSeek V4.1 Flash 1017 Elorian: Glimpse Perplexity: Decider Flash V1.2 Perplexity: Decider V1.2 XingChen: Xing4.0 29B A4B (free) Perplexity: Decider Flash Latest Reflection: Beam 1.0 501B A23B Inception: Mercury 3 PrismML: Ternary Bonsai 2 9B Respan: Span-02 LiquidAI: d1-ultra Moondream: Moondream 3 Preview Moondream: Moondream 3.1 Meta: Muse Spark Open NVIDIA: Nemotron 3.5 Super VL NVIDIA: Nemotron 3.5 Super VL (free) Pareto 26.10 TypeSafe: Jev 1.14 Perplexity: Decider Latest Pareto Latest Pareto 26.9 LiquidAI: LFM2.5-24B-A2B Google: Gemini 4 Argon Google: Gemini 4 Argon (batch) ScaleDown: Summarize ScaleDown: Extract ScaleDown: Classify-1 Nace.AI: Drex v2.0 Meta: Muse Wonder Microsoft: Microsoft-Decision-1 Nace.AI: Drex v1.5 Cloudflare: Clef Omni StepFun: Step 5 Preview Upstage: Solar Decide Flash Anthropic: Claude Haiku 5.5 Anthropic: Claude Haiku 5.5 (batch) OpenAI: GPT-6 Luna Decisions Mistral: Mistral Large 4 inclusionAI: Ling 3.1 Flash LiquidAI: d1 Cloudflare: Clef Flash Cloudflare: Clef Together: Tev1 4B Experimental Inception: Mercury Decide VoyageAI by MongoDB: rerank-3-lite VoyageAI by MongoDB: rerank-3 OpenAI: GPT-6.1 Sol Pro OpenAI: GPT-6.1 Sol Pro (batch) OpenAI: GPT-6.1 Sol OpenAI: GPT-6.1 Sol (batch) Anthropic: Claude Sonnet 5.5 Anthropic: Claude Sonnet 5.5 (batch) Upstage: Solar Decide Respan: Span-01 Respan: Span-01 Lite Respan: Span-01 Lite (free) Jared Palmer: Kev 4B Perceptron: Perceptron Mk1.5 Fireworks: Ember-1 Z.ai: GLM 5.3 Prime Qwen: Qwen3.8 Max Prime AionLabs: Aion 3.5 Mini AionLabs: Aion 3.5 Upstage: Solar Mini 4 Cohere: Command A+ OpenAI: GPT-6 Luna Pro OpenAI: GPT-6 Luna Pro (batch) OpenAI: GPT-6 Luna OpenAI: GPT-6 Luna (batch) OpenAI: GPT-6 Sol Pro OpenAI: GPT-6 Sol Pro (batch) OpenAI: GPT-6 Sol OpenAI: GPT-6 Sol (batch) Anthropic: Claude Opus 5.5 Anthropic: Claude Opus 5.5 (batch) Xiaomi: MiMo-V2.6-Pro-UltraSpeed Xiaomi: MiMo-V2.6-Flash Xiaomi: MiMo-V2.6-Pro SpaceXAI: Grok 4.7 Qwen: Qwen3.8 Omni Flash PrismML: Ternary Bonsai 2 27B Z.ai: GLM 5.3 FlashX TypeSafe: Jev Latest TypeSafe: Jev 1.13 DeepSeek: DeepSeek Pro Latest DeepSeek: DeepSeek Flash Latest Inference.net: Schematron V2 Turbo Inference.net: Schematron V2 Small OpenAI: GPT Astra Latest OpenAI: GPT Sol Latest OpenAI: GPT Terra Latest OpenAI: GPT Luna Latest Sakana: Fugu Ultra v2 Sakana: Fugu Max inclusionAI: Ling 3.0 Flash VL DeepSeek: DeepSeek V4.1 Flash DeepSeek: DeepSeek V4.1 Flash (batch) Inception: Mercury 2.5 Nex AGI: Nex-N2.5-Mini Nex AGI: Nex-N2.5-Pro OpenAI: GPT-6 Astra OpenAI: GPT-6 Astra (batch) OpenAI: GPT-6 Astra Pro OpenAI: GPT-6 Astra Pro (batch) Qwen: Qwen3.8 Max (0902) Meta: Muse Spark 1.3 Contributor Meta: Muse Spark 1.3 Google: Gemini 3.8 Flash Google: Gemini 3.8 Flash (batch) Anthropic: Claude Fable 5.1 Anthropic: Claude Fable 5.1 (batch) IBM: Granite 4.2 8B Tencent: Hy4 preview Z.ai: GLM Flash Latest Qwen: Qwen3.8 Flash Z.ai: GLM 5.3 Flash Z.ai: GLM 5.3 Flash (batch) Meta: Muse Spark 1.2 Contributor DeepSeek: DeepSeek V4 Flash Vision Exp Tencent: Hy-MT2-1.8B Tencent: Hy-MT2-30B-A3B Z.ai: GLM Latest Tencent: Hy-MT2-7B Z.ai: GLM 5.3 Z.ai: GLM 5.3 (batch) LiquidAI: LFM2.5-Embedding-350M (free) Qwen: Qwen3.8 27B Dots Studio: Dots3-Note Preview (free) Google: Gemini 3.7 Flash Google: Gemini 3.7 Flash (batch) VoyageAI by MongoDB: voyage-code-4 Qwen3 Reranker 8B ByteDance Seed: Seed 2.1 Turbo Qwen: Qwen3.8 2.4T A95B ByteDance Seed: Seed-2.0-Code DeepSeek: DeepSeek V4 Pro 0813 SpaceXAI: Grok 4.6 LiquidAI: LFM2.5-2.6B LiquidAI: LFM2.5-2.6B (free) NVIDIA: Nemotron 3.5 Lightning NVIDIA: Nemotron 3.5 Lightning (free) Sakana: Sakana Namazu Upstage: Solar Pro 4 Meta: Muse Glimmer 30B Meta: Muse Spark 1.2 DeepSeek: DeepSeek V4 Flash Latest DeepSeek: DeepSeek V4 Flash 0731 Thinking Machines: Inkling Small Thinking Machines: Inkling Small (free) Qwen: Qwen3.7 Flash VoyageAI by MongoDB: rerank-2.5-lite VoyageAI by MongoDB: rerank-2.5 VoyageAI by MongoDB: voyage-multimodal-3.5 VoyageAI by MongoDB: voyage-4-lite VoyageAI by MongoDB: voyage-4 VoyageAI by MongoDB: voyage-4-large Anthropic: Claude Opus 5 Anthropic: Claude Opus 5 (batch) inclusionAI: Ling 3.0 Flash Google: Gemini 3.6 Flash Google: Gemini 3.6 Flash (batch) Google: Gemini 3.5 Flash Lite Google: Gemini 3.5 Flash Lite (batch) Meituan: LongCat 2.0 Thinking Machines: Inkling Thinking Machines: Inkling (free) MoonshotAI: Kimi K3 MoonshotAI: Kimi K3 (batch) Meta: Muse Spark 1.1 NVIDIA: Nemotron 3 Embed 1B (free) OpenAI: GPT-5.6 Luna Pro OpenAI: GPT-5.6 Luna Pro (batch) OpenAI: GPT-5.6 Luna OpenAI: GPT-5.6 Luna (batch) OpenAI: GPT-5.6 Terra Pro OpenAI: GPT-5.6 Terra Pro (batch) OpenAI: GPT-5.6 Terra OpenAI: GPT-5.6 Terra (batch) OpenAI: GPT-5.6 Sol Pro OpenAI: GPT-5.6 Sol Pro (batch) OpenAI: GPT-5.6 Sol OpenAI: GPT-5.6 Sol (batch) SpaceXAI: Grok 4.5 xAI: Grok Latest AionLabs: Aion-3.0-Mini AionLabs: Aion-3.0 Tencent: Hy3 Anthropic: Claude Sonnet 5 Anthropic: Claude Sonnet 5 (batch) Sakana: Fugu Ultra Cohere: North Mini Code (free) Z.ai: GLM 5.2 MoonshotAI: Kimi K2.7 Code NVIDIA: Llama Nemotron Rerank VL 1B V2 (free) Anthropic: Claude Fable Latest Anthropic: Claude Fable 5 Anthropic: Claude Fable 5 (batch) NVIDIA: Nemotron 3.5 Content Safety NVIDIA: Nemotron 3.5 Content Safety (free) NVIDIA: Nemotron 3 Ultra NVIDIA: Nemotron 3 Ultra (free) Qwen: Qwen3.7 Plus Qwen: Qwen3.7 Plus (batch) MiniMax: MiniMax M3 StepFun: Step 3.7 Flash Anthropic: Claude Opus 4.8 Anthropic: Claude Opus 4.8 (batch) Qwen: Qwen3.7 Max SpaceXAI: Grok Build 0.1 Google: Gemini Embedding 2 Google: Gemini Embedding 2 (batch) Google: Gemini 3.5 Flash Google: Gemini 3.5 Flash (batch) Perceptron: Perceptron Mk1 Google: Gemini 3.1 Flash Lite Google: Gemini 3.1 Flash Lite (batch) OpenAI: GPT Chat Latest SpaceXAI: Grok 4.3 SpaceXAI: Grok 4.3 (batch) Mistral: Mistral Medium 3.5 Mistral: Mistral Medium 3.5 (batch) NVIDIA: Nemotron 3 Nano Omni (free) Anthropic: Claude Haiku Latest OpenAI: GPT Mini Latest Google: Gemini Pro Latest MoonshotAI: Kimi Latest Google: Gemini Flash Latest Anthropic: Claude Sonnet Latest Qwen: Qwen3.5 Plus 2026-04-20 Qwen: Qwen3.6 Flash Qwen: Qwen3.6 35B A3B Qwen: Qwen3.6 27B OpenAI: GPT-5.5 Pro OpenAI: GPT-5.5 Pro (batch) OpenAI: GPT-5.5 OpenAI: GPT-5.5 (batch) DeepSeek: DeepSeek V4 Pro 0423 DeepSeek: DeepSeek V4 Flash 0423 Tencent: Hy3 preview Xiaomi: MiMo-V2.5-Pro Xiaomi: MiMo-V2.5 Anthropic: Claude Opus Latest MoonshotAI: Kimi K2.6 Google: Gemini Embedding 2 Preview Anthropic: Claude Opus 4.7 Anthropic: Claude Opus 4.7 (batch) Z.ai: GLM 5.1 Cohere: Rerank 4 Pro Cohere: Rerank 4 Fast Cohere: Rerank v3.5 Google: Gemma 4 26B A4B Google: Gemma 4 26B A4B (free) Google: Gemma 4 31B Google: Gemma 4 31B (free) Qwen: Qwen3.6 Plus Z.ai: GLM 5V Turbo SpaceXAI: Grok 4.20 Multi-Agent SpaceXAI: Grok 4.20 Reka Edge MiniMax: MiniMax M2.7 OpenAI: GPT-5.4 Nano OpenAI: GPT-5.4 Nano (batch) OpenAI: GPT-5.4 Mini OpenAI: GPT-5.4 Mini (batch) Mistral: Mistral Small 4 Perplexity: Embed V1 4B Perplexity: Embed V1 0.6B Z.ai: GLM 5 Turbo NVIDIA: Nemotron 3 Super ByteDance Seed: Seed-2.0-Lite Qwen: Qwen3.5-9B OpenAI: GPT-5.4 Pro OpenAI: GPT-5.4 Pro (batch) OpenAI: GPT-5.4 OpenAI: GPT-5.4 (batch) Inception: Mercury 2 Google: Gemini 3.1 Flash Lite Preview ByteDance Seed: Seed-2.0-Mini Qwen: Qwen3.5-35B-A3B Qwen: Qwen3.5-27B Qwen: Qwen3.5-122B-A10B Qwen: Qwen3.5-Flash Google: Gemini 3.1 Pro Preview Custom Tools NVIDIA: Llama Nemotron Embed VL 1B V2 (free) OpenAI: GPT-5.3-Codex AionLabs: Aion-2.0 Google: Gemini 3.1 Pro Preview Google: Gemini 3.1 Pro Preview (batch) Anthropic: Claude Sonnet 4.6 Anthropic: Claude Sonnet 4.6 (batch) Qwen: Qwen3.5 Plus 2026-02-15 Qwen: Qwen3.5 397B A17B MiniMax: MiniMax M2.5 Z.ai: GLM 5 Anthropic: Claude Opus 4.6 Anthropic: Claude Opus 4.6 (batch) Qwen: Qwen3 Coder Next StepFun: Step 3.5 Flash MoonshotAI: Kimi K2.5 MiniMax: MiniMax M2-her Writer: Palmyra X5 Z.ai: GLM 4.7 Flash OpenAI: GPT-5.2-Codex ByteDance Seed: Seed 1.6 Flash ByteDance Seed: Seed 1.6 MiniMax: MiniMax M2.1 Z.ai: GLM 4.7 Google: Gemini 3 Flash Preview Google: Gemini 3 Flash Preview (batch) NVIDIA: Nemotron 3 Nano 30B A3B OpenAI: GPT-5.2 Chat OpenAI: GPT-5.2 Pro OpenAI: GPT-5.2 Pro (batch) OpenAI: GPT-5.2 OpenAI: GPT-5.2 (batch) Mistral: Devstral 2 2512 Relace: Relace Search Z.ai: GLM 4.6V OpenAI: GPT-5.1-Codex-Max Amazon: Nova 2 Lite Mistral: Ministral 3 14B 2512 Mistral: Ministral 3 8B 2512 Mistral: Ministral 3 3B 2512 Mistral: Mistral Large 3 2512 DeepSeek: DeepSeek V3.2 Anthropic: Claude Opus 4.5 Anthropic: Claude Opus 4.5 (batch) Thenlper: GTE-Base Thenlper: GTE-Large Intfloat: E5-Large-v2 Intfloat: E5-Base-v2 Intfloat: Multilingual-E5-Large Sentence Transformers: paraphrase-MiniLM-L6-v2 Sentence Transformers: all-MiniLM-L12-v2 BAAI: bge-base-en-v1.5 Sentence Transformers: multi-qa-mpnet-base-dot-v1 BAAI: bge-large-en-v1.5 BAAI: bge-m3 Sentence Transformers: all-mpnet-base-v2 Sentence Transformers: all-MiniLM-L6-v2 OpenAI: GPT-5.1 OpenAI: GPT-5.1 (batch) OpenAI: GPT-5.1-Codex OpenAI: GPT-5.1-Codex-Mini MoonshotAI: Kimi K2 Thinking Amazon: Nova Premier 1.0 Mistral: Mistral Embed 2312 Google: Gemini Embedding 001 OpenAI: Text Embedding Ada 002 OpenAI: Text Embedding Ada 002 (batch) Mistral: Codestral Embed 2505 OpenAI: Text Embedding 3 Large OpenAI: Text Embedding 3 Large (batch) OpenAI: Text Embedding 3 Small OpenAI: Text Embedding 3 Small (batch) Perplexity: Sonar Pro Search Mistral: Voxtral Small 24B 2507 OpenAI: gpt-oss-safeguard-20b Qwen: Qwen3 Embedding 8B Qwen: Qwen3 Embedding 4B MiniMax: MiniMax M2 Anthropic: Claude Haiku 4.5 Anthropic: Claude Haiku 4.5 (batch) Qwen: Qwen3 VL 8B Instruct Qwen: Qwen3 VL 30B A3B Thinking Qwen: Qwen3 VL 30B A3B Instruct OpenAI: GPT-5 Pro OpenAI: GPT-5 Pro (batch) Z.ai: GLM 4.6 Anthropic: Claude Sonnet 4.5 Anthropic: Claude Sonnet 4.5 (batch) DeepSeek: DeepSeek V3.2 Exp TheDrummer: Cydonia 24B V4.1 Relace: Relace Apply 3 Qwen: Qwen3 VL 235B A22B Instruct DeepSeek: DeepSeek V3.1 Terminus Qwen: Qwen3 Coder Flash Qwen: Qwen3 Next 80B A3B Instruct MoonshotAI: Kimi K2 0905 Nous: Hermes 4 405B DeepSeek: DeepSeek V3.1 Mistral: Mistral Medium 3.1 Z.ai: GLM 4.5V OpenAI: GPT-5 OpenAI: GPT-5 (batch) OpenAI: GPT-5 Mini OpenAI: GPT-5 Mini (batch) OpenAI: GPT-5 Nano OpenAI: GPT-5 Nano (batch) OpenAI: gpt-oss-120b OpenAI: gpt-oss-120b (batch) OpenAI: gpt-oss-20b OpenAI: gpt-oss-20b (batch) Anthropic: Claude Opus 4.1 Anthropic: Claude Opus 4.1 (batch) Mistral: Codestral 2508 Qwen: Qwen3 Coder 30B A3B Instruct Qwen: Qwen3 30B A3B Instruct 2507 Z.ai: GLM 4.5 Z.ai: GLM 4.5 Air Qwen: Qwen3 235B A22B Thinking 2507 Qwen: Qwen3 Coder 480B A35B ByteDance: UI-TARS 7B Google: Gemini 2.5 Flash Lite Qwen: Qwen3 235B A22B Instruct 2507 MoonshotAI: Kimi K2 0711 Venice: Uncensored Tencent: Hunyuan A13B Instruct Morph: Morph V3 Large Morph: Morph V3 Fast Mistral: Mistral Small 3.2 24B MiniMax: MiniMax M1 Google: Gemini 2.5 Flash Google: Gemini 2.5 Pro OpenAI: o3 Pro Google: Gemini 2.5 Pro Preview 06-05 DeepSeek: R1 0528 Mistral: Mistral Medium 3 Meta: Llama Guard 4 12B Qwen: Qwen3 30B A3B Qwen: Qwen3 14B Qwen: Qwen3 32B OpenAI: o3 OpenAI: o3 (batch) OpenAI: o4 Mini (batch) OpenAI: GPT-4.1 OpenAI: GPT-4.1 (batch) OpenAI: GPT-4.1 Mini OpenAI: GPT-4.1 Mini (batch) OpenAI: GPT-4.1 Nano OpenAI: GPT-4.1 Nano (batch) Meta: Llama 4 Maverick Meta: Llama 4 Scout DeepSeek: DeepSeek V3 0324 Mistral: Mistral Small 3.1 24B Google: Gemma 3 4B Google: Gemma 3 12B Cohere: Command A Reka Flash 3 Google: Gemma 3 27B TheDrummer: Skyfall 36B V2 Perplexity: Sonar Reasoning Pro Perplexity: Sonar Pro Perplexity: Sonar Deep Research Mistral: Saba AionLabs: Aion-RP 1.0 (8B) Qwen: Qwen2.5 VL 72B Instruct Qwen: Qwen-Plus OpenAI: o3 Mini (batch) Mistral: Mistral Small 3 Perplexity: Sonar MiniMax: MiniMax-01 Microsoft: Phi 4 DeepSeek: DeepSeek V3 Cohere: Command R7B (12-2024) Meta: Llama 3.3 70B Instruct Amazon: Nova Lite 1.0 Amazon: Nova Micro 1.0 Amazon: Nova Pro 1.0 OpenAI: GPT-4o (2024-11-20) Mistral Large 2407 Qwen2.5 Coder 32B Instruct TheDrummer: UnslopNemo 12B Magnum v4 72B Qwen: Qwen2.5 7B Instruct Meta: Llama 3.2 1B Instruct Meta: Llama 3.2 3B Instruct Qwen2.5 72B Instruct Cohere: Command R (08-2024) Cohere: Command R+ (08-2024) Sao10K: Llama 3.1 Euryale 70B v2.2 Nous: Hermes 3 70B Instruct Nous: Hermes 3 405B Instruct Sao10K: Llama 3 8B Lunaris OpenAI: GPT-4o (2024-08-06) Meta: Llama 3.1 70B Instruct Meta: Llama 3.1 8B Instruct Mistral: Mistral Nemo OpenAI: GPT-4o-mini OpenAI: GPT-4o-mini (2024-07-18) OpenAI: GPT-4o-mini (batch) Google: Gemma 2 27B OpenAI: GPT-4o OpenAI: GPT-4o (2024-05-13) OpenAI: GPT-4o (batch) Mistral: Mixtral 8x22B Instruct OpenAI: GPT-4 Turbo (batch) Mistral Large OpenAI: GPT-3.5 Turbo (older v0613) OpenAI: GPT-3.5 Turbo 16k Mancer: Weaver (alpha) ReMM SLERP 13B MythoMax 13B OpenAI: GPT-4 TypeSafe: Jev Router NVIDIA: Switchyard Nemotron 3 5 Rerank 8b Free Choose a listed model or paste an exact model ID. Browse models curl -fsSL https://clssai.com/install.sh | sh -s -- install codex-cli --model 'openai/gpt-5.4-nano' Copy install commandCLI: macOS, Linux, Windows. Desktop configuration: macOS or Windows with Codex installed.
Already installed? What will change? CLI apps get a private runtime and configuration under ~/.local/share/clssai-connect. Use the printed launcher path to start the configured app. Your global CLI settings stay intact.
Desktop setup merges the CLSSAI provider into ~/.codex/config.toml and saves a backup. Restore with clssai restore codex-desktop using the printed launcher path.
A dedicated API key is created only after browser approval. Manage it in API keys . How Connect works