Skip to main content

​
Prerequisites

  • Docker must be installed and running on your machine
  • An Anthropic API key or Claude subscription for Claude Code

​
Install Clawker

brew install schmitthub/tap/clawker

​
Initialize Clawker

clawker init
This creates ~/.local/clawker/ with logs, settings, and project registry. It also prompts you to build a default fallback image.

​
Start a Project

cd your-project
clawker project init    # Creates clawker.yaml, .clawkerignore, registers project
clawker build           # Builds your project's Docker image

​
Run Your First Agent

clawker run -it --agent dev @
The @ shortcut resolves to your project’s image (clawker-<project>:latest). This creates and attaches to a new Claude Code agent running in an isolated container.
1

Interact with Claude Code

You’re now inside a containerized Claude Code session. Work as you normally would — your code is mounted, credentials forwarded, and the firewall is active.
2

Detach without stopping

Press Ctrl+P, then Ctrl+Q to detach from the container while keeping it running.
3

Re-attach later

clawker attach --agent dev
4

Stop the agent

Exit Claude Code with /exit, or from another terminal:
clawker stop --agent dev

​
What’s Next

Configuration

Customize your clawker.yaml for your project’s needs

CLI Reference

Explore the full command reference