Back to FAQ
Usage

How do I remove an instance?

From the CLI:

Terminal window
claude-multi remove deepseek

Or use the alias:

Terminal window
claude-multi rm deepseek

From the TUI, select Remove instance and pick which one.

What gets removed

The remove command does two things:

  1. Removes the instance from claude-multi’s registry (~/.claude-multi/config.json)
  2. Deletes the wrapper script (e.g. ~/.local/bin/claude-deepseek)

It does not delete the config directory (~/.claude-multi/deepseek/). This is intentional, your conversation history lives there, and you might want to keep it.

Deleting the config directory

After removing the instance, you’ll see a hint:

To remove config files, run: rm -rf ~/.claude-multi/deepseek

Run that if you’re sure you don’t need the history. Skip it if you might want to recreate the instance later with the same conversation context.

Removing in scripts or CI

Use --force to skip the confirmation prompt:

Terminal window
claude-multi remove deepseek --force

More info