Home / Providers

Provider guides

Choose a provider and follow its complete setup block. Each becomes its own shell command with isolated local proxy state and Claude Code history; provider credential storage depends on the route.

Overview

Presets encode provider defaults; dialect names become shell commands. The recommended command name is a convention — each provider can have multiple independently named dialects.

Provider Presets Authentication Command
OpenAI Codexcodex-sol, codexChatGPT OAuthcc-codex
Z.ai GLMglmZAI_API_KEYcc-glm
Moonshot KimikimiKimi OAuthcc-kimi
Google GeminigeminiGoogle OAuth (Antigravity)cc-gemini
xAIgrok, grok-build, composerxAI OAuthcc-grok
MiniMaxminimaxMINIMAX_API_KEYcc-minimax
DeepSeekdeepseekDEEPSEEK_API_KEYcc-deepseek
Cursorcursor-composer, etc.Cursor API keycc-cursor
GitHub Copilotcopilot-auto, etc.Copilot logincc-copilot
Anthropic ClaudeclaudeAnthropic OAuthcc-claude

OpenAI Codex

codex-sol · codex

Use codex-sol for GPT-5.6 Sol as both the main and subagent model:

GPT-5.6 Sol preset
cc-dialect create cc-codex --preset codex-sol
cc-dialect auth cc-codex codex
cc-dialect shim install cc-codex
cc-codex

Use --preset codex instead to make GPT-5.6 the main model while retaining Sol, Terra, and Luna for the opus, sonnet, and haiku menu entries. Both routes authenticate through ChatGPT OAuth.

Z.ai GLM

glm

GLM uses Z.ai's Anthropic-compatible API and current GLM-5.2 flagship:

GLM-5.2 setup
export ZAI_API_KEY="your_zai_api_key"
cc-dialect create cc-glm --preset glm
cc-dialect shim install cc-glm
cc-glm

Maps opusglm-5.2, sonnetglm-5-turbo, haikuglm-4.5-air. GLM-5.2 accepts high or max effort.

Moonshot Kimi

kimi

Kimi authenticates through Moonshot's OAuth flow:

Kimi K3 setup
cc-dialect create cc-kimi --preset kimi
cc-dialect auth cc-kimi kimi
cc-dialect shim install cc-kimi
cc-kimi

The rolling kimi preset uses Kimi K3 as its main model. Keep effort at auto — K3 uses max by default. sonnet and haiku select Kimi K2.7 Code Highspeed and Kimi K2.6.

Google Gemini

gemini

Gemini uses Google OAuth through CLIProxyAPI's Antigravity provider:

Gemini Pro Agent setup
cc-dialect create cc-gemini --preset gemini
cc-dialect auth cc-gemini antigravity
cc-dialect shim install cc-gemini
cc-gemini

Uses gemini-pro-agent as main and opus model, with Gemini 3.5 Flash variants for lower tiers.

xAI Grok, Grok Build, and Composer

grok · grok-build · composer

xAI authentication is shared, but each model family gets its own preset and can have its own dialect:

Multiple xAI routes
# Grok 4.5
cc-dialect create cc-grok --preset grok
cc-dialect auth cc-grok xai
cc-dialect shim install cc-grok

# Grok Build
cc-dialect create cc-grok-build --preset grok-build
cc-dialect auth cc-grok-build xai
cc-dialect shim install cc-grok-build

# Composer 2.5 Fast (via xAI Grok Build)
cc-dialect create cc-composer --preset composer
cc-dialect auth cc-composer xai
cc-dialect shim install cc-composer

cc-grok   # or cc-grok-build / cc-composer

composer uses Cursor Composer 2.5 Fast as exposed by xAI Grok Build — not a Grok foundation model.

MiniMax

minimax
MiniMax M2.7 setup
export MINIMAX_API_KEY="your_minimax_api_key"
cc-dialect create cc-minimax --preset minimax
cc-dialect shim install cc-minimax
cc-minimax

Maps every Claude Code model alias to MiniMax-M2.7.

DeepSeek

deepseek
DeepSeek v4 setup
export DEEPSEEK_API_KEY="your_deepseek_api_key"
cc-dialect create cc-deepseek --preset deepseek
cc-dialect shim install cc-deepseek
cc-deepseek

Main, subagent, and opusdeepseek-v4-pro; sonnet and haikudeepseek-v4-flash.

Cursor

cursor-composer · cursor-grok · cursor-auto

Cursor dialects use a local OpenAI-compatible bridge backed by the official @cursor/sdk:

Composer 2.5 setup
cc-dialect cursor install
export CURSOR_API_KEY="your_cursor_api_key"

cc-dialect create cc-cursor --preset cursor-composer
cc-dialect shim install cc-cursor
cc-cursor

# Check bridge status
cc-dialect cursor status
cc-dialect models cc-cursor

Available presets:

  • cursor-composer — Composer 2.5 with Fast/Standard menu mappings
  • cursor-composer-fast — explicitly forces Composer 2.5 Fast
  • cursor-grok — Cursor Grok 4.5
  • cursor-auto — Cursor's auto selection
ℹ SDK bridge details

Each Cursor dialect reserves two localhost ports: one for the embedded proxy and one for the SDK bridge. Tools are forwarded with cc_tool_ schema aliases to prevent Composer from calling Cursor-native schemas. Claude Code permission prompts remain in control.

GitHub Copilot

copilot-auto · copilot-mai · copilot-codex

Install and authenticate the Copilot SDK once:

cc-dialect copilot install
cc-dialect copilot login
cc-dialect copilot status
cc-dialect copilot models

Create a general Copilot dialect:

Copilot auto setup
cc-dialect create cc-copilot --preset copilot-auto
cc-dialect shim install cc-copilot
cc-copilot

Available presets: copilot-auto, copilot-mai (MAI-Code-1-Flash), copilot-codex, copilot-claude, copilot-gemini.

Anthropic Claude

claude

The claude preset routes Claude Code through the embedded proxy with a separate Anthropic OAuth login:

Isolated Claude OAuth setup
cc-dialect create cc-claude --preset claude
cc-dialect auth cc-claude claude
cc-dialect shim install cc-claude
cc-claude

Unlike a native shortcut, cc-claude has private settings, credentials, and history. Maps main and opus to Claude Fable 5, with Sonnet 4.6 and Haiku 4.5 for lower tiers.