ClaudeGate

A gateway for Claude CLI that enables seamless switching between AI providers

ClaudeGate is a terminal utility that wraps Claude CLI, enabling you to switch between multiple AI providers (Anthropic, OpenRouter, DeepSeek, Z.AI, MiniMax, Kimi K2, and more) without modifying your Claude configuration. Select your provider, choose your models, and start coding.

Why ClaudeGate?

Claude CLI is powerful, but switching between different AI providers requires manually setting environment variables or editing config files. ClaudeGate solves this by providing:

• One-click provider switching — Interactive menu to select your AI backend
• Dynamic model selection — Fetch and select models directly from provider APIs
• Three-tier model mapping — Configure Haiku, Sonnet, and Opus alternatives
• Profile management — Save multiple configurations for different use cases
• Zero config pollution — Never modifies your ~/.claude/settings.json
• Full CLI passthrough — All Claude arguments work exactly as expected

Supported Providers

Get Started

Prerequisites

• Node.js >= 18.0.0
• Claude CLI installed and configured
• API keys for your desired providers

Installation

npm install -g claudegate

Quick Start

# Launch ClaudeGate - shows profile selector, then starts Claude
claudegate

# Or use the short alias
cc

# All Claude CLI arguments work as expected
claudegate -p "explain this code"
claudegate --resume
cc -p "help me debug this"

How It Works

┌─────────────────────────────────────────────────────────────┐
│                        CLAUDEGATE                           │
└─────────────────────────────────────────────────────────────┘

? Select active profile:
❯ ● work-anthropic (Anthropic) [current]
    zai-dev (Z.AI - GLM Models)
    openrouter-gpt4 (OpenRouter)
    deepseek-v3 (DeepSeek)
    minimax-m2 (MiniMax)
  ─────────────────────────────────────
    + Add new profile
    ⚙ Manage profiles

1. Select Profile — Choose which AI provider to use
2. Launch Claude — Claude CLI starts with the correct environment
3. Work normally — All your usual Claude workflows just work

Features

Dynamic Model Selection

ClaudeGate fetches available models live from provider APIs. When creating or editing a profile, you can select models for each tier:

? Select model for HAIKU (fast/cheap tasks):
  ○ Skip (use provider default)
  ○ deepseek-chat (Recommended)
  ○ deepseek-reasoner
  ○ Enter custom model ID...

? Select model for SONNET (balanced tasks):
  ○ Skip (use provider default)
  ○ deepseek-chat (Recommended)
  ○ deepseek-reasoner
  ○ Enter custom model ID...

? Select model for OPUS (complex reasoning):
  ○ Skip (use provider default)
  ○ deepseek-reasoner (Recommended)
  ○ deepseek-chat
  ○ Enter custom model ID...

Three-tier model mapping:

Models are saved with your profile—no need to reselect every time.

Profile Management

Adding a Profile

Select "+ Add new profile" from the menu:

1. Choose a provider (Z.AI, OpenRouter, DeepSeek, MiniMax, etc.)
2. Enter a profile name (e.g., work-deepseek)
3. Enter required credentials (API keys, endpoints)
4. Select models for Haiku, Sonnet, and Opus tiers
5. Profile is saved and ready to use

Managing Profiles

Select "⚙ Manage profiles" to:

Provider Setup

Configuration

Profiles are stored in ~/.claudegate/config.json:

{
  "version": "1.0.0",
  "activeProfileId": "abc-123",
  "profiles": [
    {
      "id": "abc-123",
      "name": "deepseek-dev",
      "providerId": "deepseek",
      "envVars": {
        "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com"
      },
      "selectedModels": {
        "haiku": { "id": "deepseek-chat", "name": "DeepSeek Chat V3" },
        "sonnet": { "id": "deepseek-chat", "name": "DeepSeek Chat V3" },
        "opus": { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
      }
    }
  ]
}

Environment Variables

ClaudeGate sets these environment variables based on your profile:

Security

• Config stored with 0600 permissions (owner read/write only)
• API keys stored locally, never transmitted except to configured providers
• Sensitive values masked during input

Troubleshooting

which claude  # Should show Claude CLI path

chmod 700 ~/.claudegate
chmod 600 ~/.claudegate/config.json

Uninstall

npm uninstall -g claudegate
rm -rf ~/.claudegate

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

This project uses Conventional Commits for automatic versioning.

Star History

License

MIT

Made with Claude Code