https://github.com/thetokencompany/claude-compression-proxy
Compression proxy for Claude Code enabling up to 60% savings on Claude quota
https://github.com/thetokencompany/claude-compression-proxy
api claude claude-code compression docker fastapi llm proxy quota
Last synced: 29 days ago
JSON representation
Compression proxy for Claude Code enabling up to 60% savings on Claude quota
- Host: GitHub
- URL: https://github.com/thetokencompany/claude-compression-proxy
- Owner: TheTokenCompany
- Created: 2026-01-12T06:46:46.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-01-12T08:27:50.000Z (about 1 month ago)
- Last Synced: 2026-01-12T18:08:41.367Z (about 1 month ago)
- Topics: api, claude, claude-code, compression, docker, fastapi, llm, proxy, quota
- Language: Python
- Homepage: https://thetokencompany.com
- Size: 14.6 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Claude Compression Proxy
Save tokens and money by compressing Claude Code API requests using [The Token Company](https://thetokencompany.com) API.
Code understanding works extremely well with medium compression aggressiveness (0.1 - 0.6) improving Claude Code subscription quota up to 66 %.
https://github.com/user-attachments/assets/1a0f5d76-59cd-4e03-a107-222729518f7b
## Setup (3 steps)
**1. Install**
Clone the repository and run
```bash
./install.sh
```
**2. Add your API key to `~/.zshrc` or `~/.bashrc`**
Get compression API key from [The Token Company](https://thetokencompany.com)
```bash
export TTC_KEY="your_token_company_api_key"
export PATH="$HOME/.local/bin:$PATH"
```
**3. Reload your shell**
```bash
source ~/.zshrc
```
Done! Now use `claude-c` instead of `claude`.
## Usage
```bash
# Use Claude with compression
claude-c
# Adjust compression level (0-1, higher = more compression)
claude-c -0.8
```
## Requirements
- Docker ([Get Docker](https://docs.docker.com/get-docker/))
- Claude Code ([Get Claude Code](https://github.com/anthropics/claude-code))
- Token Company API key ([Sign up](https://thetokencompany.com))
## How It Works
```
Claude Code → Claude Compressor (localhost:8877) → Anthropic API
↓
Compress via The Token Company API
```
The `claude-c` wrapper automatically starts the Docker container and routes your requests through the compression proxy.
## Troubleshooting
**Container won't start?**
```bash
docker rm -f claude-compressor
./install.sh
```
**Check if it's working:**
```bash
tail -f ~/claude-compressor.log
```
**Reset everything:**
```bash
docker rm -f claude-compressor
docker rmi claude-compressor:latest
./install.sh
```
## License
MIT