Installation

Requirements

• Python 3.10 or newer (CI tests 3.10–3.13).
• macOS or Linux (Unix-based systems only — see ../index.md for why Windows isn't a target).
• The Claude Code CLI installed and authenticated (claude auth login, or an ANTHROPIC_API_KEY in the environment) — this package drives it, it doesn't replace it.

From PyPI (once published)

pipx install claudeloop

pipx is recommended over a bare pip install for CLI tools — it isolates the install into its own virtual environment so claudeloop's dependencies never collide with anything else on your system. A plain

pip install claudeloop

works too, inside whatever virtual environment you're already using.

From source (for development)

git clone https://github.com/adammatthewsteinberger/claudeloop.git
cd claudeloop
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,docs]"
pre-commit install

See ../contributing/development.md for the full contributor setup, including how to run every quality gate locally.

Verifying the install

claudeloop --version
claudeloop --help

If claudeloop isn't on your PATH after a pipx install, run pipx ensurepath and open a new shell.

Project status

claudeloop is pre-1.0. Milestones M1–M5 from the architecture plan are implemented, including run/resume, claudeloop api, and the CI drift gate that keeps the REST surface aligned with the installed anthropic SDK. See ../plans/architecture-and-roadmap.md.