claude-cli is a versatile shell wrapper designed to seamlessly run Claude Code within a Docker container. This approach effectively maintains the cleanliness of your host system while ensuring that your Claude configuration and user preferences are preserved across sessions.

Key Features

• Lightweight Docker Integration: Run Claude without cluttering the local system while managing dependencies through Docker.
• Multiple Mode Support: Choose from various operational modes to suit different task requirements:
  • no-dir: Ideal for general inquiries or exploring Claude's features without exposing local projects.
  • single-dir: Utilize a directory picker to mount a single directory from your home, perfect for focused tasks.
  • multi-dir: Select several directories simultaneously and set one as the working directory, enhancing efficiency when managing multiple repositories or shared configurations.
• Persistent Configuration: Automatically retains Claude’s configurations (~/.claude/ and ~/.claude.json) by bind-mounting them into the container, ensuring continuity in settings and session history.

Usage

To run claude-cli, use the command:

claude-cli [-b] [-c] [-h]

Options

Configuration Variables

Customize the behavior of claude-cli by modifying the following environment variables:

Example

CLAUDE_IMAGE=my-claude:dev claude-cli

This setup ensures a robust development environment while keeping the host system uncluttered and organized. By using claude-cli, developers can effectively leverage the capabilities of Claude Code through a simple, clean interface.