Raised: $0
0% of monthly goal Help us cross the finish line!
Goal: $12,000
Raised: $0 Goal: $12,000
0% of monthly goal Help us cross the finish line!
Sponsor DDEV

If you find this add-on useful, please star it on GitHub — stars show appreciation and help maintainers know their work matters.

add-on registry tests last commit release

DDEV Pi Claude Code

Overview

This DDEV add-on integrates pi-claude-code into your DDEV project’s ddev-pi environment, allowing you to use your Claude subscription directly within the Pi Coding Agent.

Dependencies

This add-on extends mxr576/ddev-pi. ddev-pi will be installed automatically if not already present.

Installation

ddev add-on get mxr576/ddev-pi-claude-code
ddev restart && ddev start --profiles=pi

After installation, make sure to commit the .ddev directory to version control.

Authentication

Authenticate the Claude Code CLI inside the pi service:

ddev pi-claude-login

Follow the browser prompt to log in with your Anthropic/Claude account. Credentials are persisted across container restarts in .ddev/pi/claude.

Usage

Command Description
ddev pi-claude-login Authenticate Claude Code CLI in the pi container
ddev pi Launch interactive Pi Coding Agent session with pi-claude-code enabled

Configuration & Version Pinning

You can specify or pin the @anthropic-ai/claude-code version using the PI_CLAUDE_CODE_VERSION environment variable in .ddev/.env.pi:

ddev dotenv set .ddev/.env.pi --pi-claude-code-version="2.1.322"
ddev restart && ddev start --profiles=pi

All customization options:

Variable Flag Default Description
PI_CLAUDE_CODE_VERSION --pi-claude-code-version latest Version of @anthropic-ai/claude-code npm package to install

Credits

Contributed and maintained by @mxr576

If you find this add-on useful, please star it on GitHub — stars show appreciation and help maintainers know their work matters.