Introduction

What is ccpool?

ccpool is a serverless command-line utility designed to help teams and households coordinate usage of a shared Claude subscription. By managing a shared ledger, it ensures equitable access across Claude’s rolling 5-hour and weekly usage windows.

Claude enforces rate limits across two distinct periods:

• 5-hour rolling window — a high-frequency token quota that refreshes dynamically
• Weekly window — a long-term cap that resets weekly

Without coordination, a single user’s high-volume task can exhaust the entire team’s quota. ccpool provides the tracking and pacing necessary to keep the subscription usable for everyone.

Key Features

Automatic Request Pacing

Users prompt Claude as normal while ccpool handles the scheduling behind the scenes. It tracks and schedules requests dynamically to ensure no single member hogs the team’s limits.

Active Quota Reallocation

To prevent wasted capacity, ccpool monitors team activity. If a member remains inactive, their allocated tokens are automatically redistributed to active team members one hour before the current usage window resets.

Flexible CLI Integration

• Minimal Setup — Install and initialize the CLI in under five minutes with zero ongoing maintenance.
• Serverless Synchronization — Sync ledger states across the team using standard cloud storage folders (such as Dropbox, iCloud, or a shared Git repository) as well as cloud database backends.
• Consumption Analytics — Review detailed daily and weekly usage reports, complete with estimated cost breakdown metrics.

How it works

ccpool maintains a shared usage ledger (local or synced) and exposes a simple CLI to:

• Check how much quota remains in the current window
• See each member’s share of recent usage
• Get notified when it’s safe to use Claude again

Design philosophy

No servers required by default. No accounts. Just a file, a CLI, and a shared folder (or a git repo).