How do I install claude-multi?

Pick whichever package manager you already use:

# bun
bun add -g claude-multi

# npm
npm install -g claude-multi

# pnpm
pnpm add -g claude-multi

# Deno
deno install -g npm:claude-multi

Then launch the interactive TUI:

claude-multi

Or create an instance directly:

claude-multi add deepseek --provider deepseek --api-key sk-your-key

This generates a wrapper script in your PATH (the exact location depends on your package manager, could be ~/.bun/bin/, ~/.local/bin/, or similar) that you can run like any other command.

Before you start

You’ll need Claude Code installed (npm install -g @anthropic-ai/claude-code), a supported runtime (Bun 1+, Node 18+, or Deno 1+), and an API key for at least one provider.

How the entry point works

The bin/claude-multi.js file is a polyglot, it works as both a shell script and a JavaScript module. When you run it, the shell portion checks for bun, then node, then deno, and re-executes itself under whichever one it finds. You never have to think about it.

Related questions

• How do I create a new instance?: step-by-step after install
• Which providers are supported?: pick the right one

More info

• /docs/getting-started/: full setup walkthrough
• /docs/providers/: pick a provider
• bin/claude-multi.js: the polyglot entry point
• src/util/runtime.ts: package manager detection
• src/wrapper.ts: wrapper script generation
• claude-multi on npm