CCVM - Claude Code Version Manager

Easily install and switch between multiple Claude Code versions. Similar to nvm for Node.js.

Installation

curl -fsSL https://raw.githubusercontent.com/ra-kesh/ccvm/main/install.sh | bash

Then restart your terminal or run:

source ~/.ccvm/ccvm.sh

Usage

# List installed versions
ccvm list

# Install a specific version
ccvm install 2.0.52
ccvm install latest

# Switch between versions
ccvm use 2.0.64

# Show current version
ccvm current

# Remove a version
ccvm remove 2.0.50

# Upgrade ccvm itself
ccvm upgrade

How it works

CCVM works with the native Claude Code installation:

• Versions are stored in ~/.local/share/claude/versions/
• The active version is symlinked at ~/.local/bin/claude
• Switching versions updates the symlink instantly

Commands

Command	Description
ccvm install [version]	Install a Claude Code version (default: latest)
ccvm use <version>	Switch to a specific version
ccvm list	List all installed versions
ccvm current	Show currently active version
ccvm remove <version>	Remove an installed version
ccvm upgrade	Upgrade CCVM to latest version
ccvm help	Show help message

Examples

# Install multiple versions
ccvm install 2.0.52
ccvm install 2.0.64
ccvm install 2.0.75

# List what's installed
$ ccvm list
Installed versions:
  2.0.52 (160M)
  2.0.64 (156M) ← current
  2.0.75 (174M)

# Switch versions
$ ccvm use 2.0.75
Now using Claude Code 2.0.75
2.0.75 (Claude Code)

Uninstall

To remove CCVM:

rm -rf ~/.ccvm
# Remove the source line from ~/.zshrc or ~/.bashrc

Requirements

• macOS or Linux
• Bash or Zsh
• curl

License

MIT