Frequently asked questions.
Straight answers with links to the docs, blog posts, source code, and the relevant TUI screens you can try right now.
Getting Started
-
What is claude-multi and why should I use it?
claude-multi is an open-source CLI that runs multiple Claude Code instances side-by-side, each with its own AI provider, config directory, and history.
-
How do I install claude-multi?
Install with any JS runtime, bun, npm, pnpm, or Deno, then run claude-multi to launch the interactive TUI.
Providers
-
Which AI providers are supported?
claude-multi ships 8 templates covering GLM, MiniMax, DeepSeek, Xiaomi MiMo, Moonshot Kimi, and Alibaba Qwen, each with pre-configured endpoints and model mappings.
-
Can I use it with local models like Ollama?
Any provider that exposes an Anthropic-compatible REST API works, including local setups like Ollama with the right adapter.
Usage
-
How do I create a new instance for a provider?
Use the interactive TUI or the CLI add command to spin up an isolated Claude Code instance with a provider template in two commands.
-
Can I run multiple instances at the same time?
Yes, that's the whole point. Launch claude-glm and claude-deepseek in separate terminals and they run independently with no conflicts.
-
How do I remove an instance?
Use claude-multi remove <name> or the TUI Remove option. The config directory is kept on disk so you can decide whether to delete it.
Plugins & MCP
-
How does plugin and skill syncing work?
When auto-sync is enabled, plugins and skills directories in each instance are symlinked to ~/.claude, update once, every instance sees it.
-
How do I manage MCP servers across instances?
claude-multi can list, copy, and verify MCP server configs across all your instances from the TUI or CLI.