A CLI tool for managing Claude Code plugins, profiles, and sandboxed environments.
# One-liner install (macOS/Linux)
curl -fsSL https://claudeup.github.io/install.sh | bash
# Or from source
go install github.com/claudeup/claudeup/v2/cmd/claudeup@latest# First-time setup - installs Claude CLI and applies a profile
claudeup setup
# Or setup with a specific profile
claudeup setup --profile frontendThat's it. You now have a working Claude Code installation with your chosen plugins and MCP servers.
Save and switch between different Claude configurations. Great for different projects or sharing setups across machines.
claudeup profile list # See available profiles
claudeup profile save my-setup # Save current config as a profile
claudeup profile apply backend # Switch to a different profileProfiles include plugins, MCP servers, marketplaces, and secrets. Learn more →
Share Claude configurations with your team via git:
# Team lead: Save profile to project
claudeup profile save team-config --scope project
git add .claudeup && git commit -m "Add team profile"
# Team member: Sync after clone/pull
claudeup profile syncProject profiles live in .claudeup/profiles/ and travel with your repository. Learn more →
Run Claude Code in an isolated Docker container for security.
claudeup sandbox # Ephemeral session
claudeup sandbox --profile untrusted # Persistent sandboxed environmentProtects your system from untrusted plugins while still letting Claude work on your projects. Learn more →
Fine-grained control over what's enabled:
claudeup status # Overview of your installation
claudeup plugin disable name # Disable a plugin
claudeup mcp disable plugin:server # Disable just an MCP serverclaudeup doctor # Diagnose issues
claudeup cleanup # Fix plugin path problems
claudeup outdated # Check for updates
claudeup update # Update claudeup CLI
claudeup upgrade # Update plugins and marketplaces| Command | Description |
|---|---|
claudeup update |
Update the claudeup CLI to the latest version |
claudeup upgrade |
Update marketplaces and plugins |
claudeup outdated |
Show available updates for CLI, marketplaces, and plugins |
For the complete command reference, see Full command reference →
| Variable | Description | Default |
|---|---|---|
CLAUDEUP_HOME |
Override claudeup's configuration directory | ~/.claudeup |
CLAUDE_CONFIG_DIR |
Override Claude Code's configuration directory | ~/.claude |
Use environment variables to run claudeup in isolation (useful for testing or CI):
export CLAUDEUP_HOME="/tmp/test-env/.claudeup"
export CLAUDE_CONFIG_DIR="/tmp/test-env/.claude"
claudeup profile apply base-tools- Profiles - Configuration profiles and secret management
- Team Workflows - Sharing configurations via git
- Sandbox - Running Claude in isolated containers
- Commands - Full command reference
- Troubleshooting - Common issues and fixes
git clone https://github.com/claudeup/claudeup.git
cd claudeup
go build -o bin/claudeup ./cmd/claudeup
cp bin/claudeup ~/.local/bin/claudeup
go test ./...
alias clup=claudeup
clup profile currentMIT