claude-box
| Crates.io | claude-box |
| lib.rs | claude-box |
| version | 0.1.3 |
| created_at | 2025-12-26 04:34:28.453021+00 |
| updated_at | 2025-12-28 06:43:56.039364+00 |
| description | A multi-platform Claude Code sandbox manager |
| homepage | |
| repository | https://github.com/movecx/claude-box |
| max_upload_size | |
| id | 2005260 |
| size | 484,986 |
Chris Hammel (movecx)
documentation
README
claude-box 
A sandbox manager for Claude Code. Run multiple isolated Claude Code instances with separate configurations, credentials, and conversation history.
Features
- Isolated Environments - Each environment has its own config directory, API keys, and history
- Visual Distinction - Configurable colored borders help identify which environment you're in
- Provider Support - Use Anthropic directly or configure alternative providers (Z.ai, Minimax, custom anthropic endpoints)
- Cross-Platform - Works on Windows, macOS, and Linux
Installation
Quick Install
macOS / Linux:
curl -sSfL https://raw.githubusercontent.com/movecx/claude-box/master/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/movecx/claude-box/master/install.ps1 | iex
From Source
cargo install claude-box
Requirements
- Claude Code must be installed and available in PATH
Usage
# Open default environment
claude-box
# Open a specific environment
claude-box work
# Configure environments
claude-box config
Configuration TUI
Run claude-box config to open the configuration interface where you can:
- Create new environments
- Set border colors and names
- Configure API providers
- Set a default environment
- Delete environments
How It Works
claude-box sets the CLAUDE_CONFIG_DIR environment variable to redirect Claude Code's configuration to an isolated directory per environment. Each environment maintains its own:
- API credentials
- Conversation history
- Settings and preferences
- Project memory
Data Locations
| Platform | Config | Environment Data |
|---|---|---|
| Linux | ~/.config/claude-box/ |
~/.local/share/claude-box/environments/ |
| macOS | ~/Library/Application Support/claude-box/ |
~/Library/Application Support/claude-box/environments/ |
| Windows | %APPDATA%\claude-box\ |
%LOCALAPPDATA%\claude-box\environments\ |