GitHub - shirozuki/claude-cli · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

shirozuki

claude-cli

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

master

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>14 Commits<br>14 Commits

tests

tests

.gitignore

.gitignore

LICENSE

LICENSE

README.md

README.md

claude-cli.sh

claude-cli.sh

View all files

Repository files navigation

claude-cli

A lightweight shell wrapper that runs Claude Code inside a Docker container, keeping your host system clean while persisting your Claude configuration across sessions.

Requirements

Docker with Buildx plugin

dmenu — mode selection prompt (not required when using -f)

fzf — directory picker; also used for mode selection with -f

Current user must be a member of the docker group

Installation

git clone https://github.com/shirozuki/claude-cli<br>chmod +x claude-cli/claude-cli.sh<br>ln -s "$PWD/claude-cli/claude-cli.sh" ~/.local/bin/claude-cli

Usage

claude-cli [-b] [-c] [-f] [-h] [DIR...]

Option<br>Description

-b<br>Build (or rebuild) the claude-cli:latest Docker image

-c<br>Remove all claude-cli containers; optionally remove the image

-f<br>Use fzf instead of dmenu for the mode selection prompt

-h<br>Show help

Running without any option or argument launches a dmenu prompt to choose a mode. Pass -f to use fzf instead — useful on setups without dmenu or when you prefer a terminal picker.

Passing directories as arguments

You can skip the menu and pickers entirely by passing directories directly on the command line:

claude-cli ~/projects/app # single-dir mode<br>claude-cli ~/projects/app ~/shared # multi-dir mode (first arg is the working dir)

One argument runs single-dir mode with that directory.

Two or more arguments run multi-dir mode, mounting every directory and using the first as the working directory.

Relative paths are resolved against the current working directory, so claude-cli . mounts $PWD. When directories are passed this way, dmenu and fzf are not required.

Modes

no-dir

Launches Claude without mounting any project directories. Useful for general questions, quick tasks, or exploring Claude's capabilities without exposing local files.

current-dir

Mounts the current working directory $PWD directly.

single-dir

Opens an fzf picker to select one directory from your home tree (up to 3 levels deep). The selected directory is mounted and set as the working directory inside the container.

multi-dir

Opens fzf in multi-select mode to pick several directories (use Tab to select), then asks you to designate one of them as the working directory. All selected directories are mounted simultaneously — useful when working across multiple repos or sharing common config directories.

Configuration persistence

Claude's configuration (~/.claude/ and ~/.claude.json) is bind-mounted into the container on every run, so your account, settings, and session history survive container restarts.

The mount source is resolved in this order:

$XDG_CONFIG_HOME/claude/ — if $XDG_CONFIG_HOME is set

$HOME/ — fallback

Configuration variables

The following environment variables can be set to override defaults without editing the script:

Variable<br>Default<br>Description

CLAUDE_IMAGE<br>claude-cli:latest<br>Docker image name to use

NOTIFY_ERROR_ICON<br>$XDG_CONFIG_HOME/dunst/critical.png<br>Icon used in desktop error notifications

CLAUDE_CLI_FLAGS<br>(none)<br>Extra flags passed through to the claude binary inside the container

CLAUDE_CLI_DOCKERFILE<br>(see below)<br>Path to a custom Dockerfile used to build the image (highest precedence).

Examples:

CLAUDE_IMAGE=my-claude:dev claude-cli

# Pass flags through to Claude Code itself<br>CLAUDE_CLI_FLAGS="--resume $session_id --dangerously-skip-permissions" claude-cli

# Build the image from a custom Dockerfile<br>CLAUDE_CLI_DOCKERFILE=~/my-claude.dockerfile claude-cli -b

CLAUDE_CLI_FLAGS is word-split, so each space-separated token becomes a<br>separate argument. Quote arguments that contain spaces is not supported — pass<br>only flags whose values have no spaces.

How it works

On...