Two separate things need updating: the claude-multi tool itself, and the Claude Code binary it wraps.
Updating Claude Code
Check what you’re running vs. what’s latest:
Terminal window
claude-multiversion
This shows your installed version, the latest published version, and whether an update is available. To upgrade:
Terminal window
claude-multiupdate
This updates the @anthropic-ai/claude-code package that all your instances share.
Updating claude-multi
Use the same package manager you installed with:
Terminal window
# bun
bunupdate-gclaude-multi
# npm
npmupdate-gclaude-multi
# pnpm
pnpmupdate-gclaude-multi
# Deno
denoinstall-gnpm:claude-multi
What happens to instances during updates
Nothing. Updating Claude Code doesn’t touch your instance directories, they keep their settings, plugins, and conversation history. Since instances are just config directories + wrapper scripts, updates to either tool are non-destructive.
More info
src/version.ts: checkForUpdates() and updateClaudeCode() implementation