Skip to content
claude-multi

Documentation

What is claude-multi?

Section titled “What is claude-multi?”

claude-multi is a free, open-source CLI that runs multiple Claude Code instances on the same machine. Each instance points at a different AI provider (GLM, MiniMax, DeepSeek, Xiaomi MiMo, Moonshot Kimi, Alibaba Qwen, or Anthropic) with its own config directory, API key, and model settings.

No daemons. No background services. Every instance is a real directory you can inspect.

Quick start

Section titled “Quick start”
Terminal window
npm i -g claude-multi
claude-multi add glm --provider glm
claude-glm

That is it. claude-glm launches the official Claude Code binary with the GLM Coding Plan provider preconfigured.

Key concepts

Section titled “Key concepts”
  • Provider templates come with the right base URLs, model mappings, and defaults. Drop in your API key and go.
  • Instance isolation means each provider gets its own config directory under ~/.claude-multi/. No shared state, no conflicts.
  • Plugin sync symlinks skills and MCP servers from your primary install. Update once, every instance sees it.
  • Native passthrough means each alias is a thin wrapper around the official claude binary. Every flag and keybinding works unchanged.

Where to go next

Section titled “Where to go next”