A pi extension that adds a /btw side-conversation channel, running a parallel sub-session with coding-tool access while the main agent keeps working.
earendil-works/pi-claude-code
A Pi extension that routes Pi's Claude model requests through the official Claude Code CLI so you can use a Claude Pro or Max subscription.
- Stars
- 327
- Forks
- 43
- Open issues
- 15
- Last commit
- 2 days ago
What is it?
pi-claude-code is an extension for Pi that lets you use a Claude Pro or Max subscription as a model provider. All Claude model requests are sent through the official Claude Code CLI running in non-interactive mode (claude -p).
Pi keeps control of conversation history, approvals, compaction and tool execution. Claude Code only handles the model call and never runs tools on its own. Authentication is delegated entirely to Claude Code, so the extension does not read or store your credentials.
The extension refuses to run if the environment sets an API key, proxy, or Bedrock, Vertex or Foundry override, to avoid silently changing how requests are billed. Usage counts against your normal subscription quota, and the project is marked experimental with an uncertain future given Anthropic's announced billing changes for claude -p.
Key features
- 01Routes Claude model requests from Pi through the Claude Code CLI.
- 02Uses existing Claude Code login; no separate credential storage.
- 03Pi retains conversation history, approvals, compaction and tool execution.
- 04Provides a /claude-code-status command to check installation and login.
- 05Supports custom Claude Code executable path and config directory via environment variables.
Use cases
- Using a Claude Pro or Max subscription inside the Pi coding agent.
- Keeping Pi's tool execution and approval flow while using Claude models.
- Avoiding a separate API key setup for Claude models in Pi.
Quick start
- 1
Install Claude Code CLI globally via npm
npm install -g @anthropic-ai/claude-code - 2
Log in to Claude Code with your subscription
claude auth login - 3
Install the extension into Pi
pi install https://github.com/earendil-works/pi-claude-code
Things to know
- The extension is experimental.
- Requests count against your Claude subscription quota, and Anthropic's future billing for claude -p usage is uncertain.
- Branching or changing settings mid-conversation starts a fresh process that replays the conversation, which can be slower and use more quota.
In collections
Topics
FAQ
- What is pi-claude-code?
- A Pi extension that routes Pi's Claude model requests through the official Claude Code CLI so you can use a Claude Pro or Max subscription. pi-claude-code is an extension for Pi that lets you use a Claude Pro or Max subscription as a model provider. All Claude model requests are sent through the official Claude Code CLI running in non-interactive mode (claude -p).
- Is pi-claude-code free to use? What license does it have?
- pi-claude-code is open source under the MIT license. Check the license terms before using it in commercial products.
- Is pi-claude-code still maintained?
- Actively maintained. The last commit to pi-claude-code was on Nov 5, 2026.
- What can I use pi-claude-code for?
- Using a Claude Pro or Max subscription inside the Pi coding agent. Keeping Pi's tool execution and approval flow while using Claude models. Avoiding a separate API key setup for Claude models in Pi.
- How do I install pi-claude-code?
- Install Claude Code CLI globally via npm: npm install -g @anthropic-ai/claude-code Log in to Claude Code with your subscription: claude auth login Install the extension into Pi: pi install https://github.com/earendil-works/pi-claude-code
- Where can I get pi-claude-code?
- The source code and installation instructions are on GitHub: https://github.com/earendil-works/pi-claude-code
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Durable, named agents for the Pi coding agent that run delegated tasks in the background, can be messaged, and survive restarts.
A self-hosted MCP server that lets ChatGPT, Claude and other MCP hosts read, edit and run code in your local projects.
A file-based planning skill for AI coding agents that keeps task plans on disk so they survive context resets, /clear, and crashes.
Local-first persistent memory for AI coding agents, storing decisions and lessons in SQLite and serving them over MCP to Claude Code, Cursor and other clients.
A port of Poteto's pstack Cursor skill stack, giving Claude Code, Codex, Copilot, Pi and other agent harnesses structured workflows for coding tasks.