AI Developer Tools
claude-thermos
An open-source utility that keeps your Claude Code prompt cache warm to avoid costly re-encodings when subagents run longer than five minutes.
claude-thermos
What is claude-thermos?
claude-thermos is an open-source tool that runs as a local reverse proxy to monitor Claude Code sessions and automatically sends minimal warm requests to prevent the prompt cache from expiring during subagent idle periods.
claude-thermos vs Similar AI Tools
| Pricing Model | Free | Free | Free | Free |
| Free Credits | ||||
| Key Features |
|
|
|
|
| Pros |
|
|
|
|
| Cons |
|
|
|
|
| Best For |
|
|
|
|
How to use claude-thermos?
- 1Ensure Python 3.11+ and the 'claude' CLI are installed and on your PATH.
- 2Run Claude Code through claude-thermos using uvx: 'uvx claude-thermos' (instead of 'claude').
- 3Pass any Claude arguments as usual: 'uvx claude-thermos -p "fix the bug"'.
- 4Optionally tune behavior with flags: --idle, --interval, --max-cycles, --subagent-window.
- 5To disable warming for a run, set environment variable CLAUDE_WARMER_DISABLE=1.
claude-thermos Key Features
- Automatic cache warming during subagent idle periods
- Adjustable idle time, interval, and max cycles
- Event logging and session summaries with cost savings
- Seamless integration with existing Claude Code usage
claude-thermos Use Cases
- Reducing costs in long Claude Code sessions with multiple subagents
- Avoiding prompt cache expiry when the main agent is blocked on subagents
- Monitoring and optimizing API usage for Claude Code deployments
claude-thermos Pricing & Free Credits
claude-thermos currently operates on a Free model.
This tool is completely free to use
claude-thermos Pros & Cons
Pros
- Reduces API costs by keeping cache warm
- Easy to set up with uvx
- Provides detailed logs and savings estimates
- Open-source and customizable
Cons
- Requires Python 3.11+
- Only works with Claude Code CLI
- Additional local proxy setup may add complexity
What is claude-thermos best for?
- Developers using Claude Code for complex tasks with many subagents
- Teams looking to optimize API spending on Claude Code sessions