Enable gzip or brotli compression — Claude Code

Uncompressed responses waste bandwidth and slow down Core Web Vitals. Brotli is the modern standard — enable it on Vercel, Netlify, or your CDN.

rocket_launch

Fixing this in Claude Code

Anthropic's official terminal coding agent

Claude Code can grep the whole codebase first, plan the change, then edit every affected file. Paste the prompt below into your Claude Code chat and the fix rolls out across the project in one pass.

Using a different tool? Pick your stack:

Lovable Cursor Bolt v0 Replit Windsurf Claude Code Base44

The prompt for Claude Code

Copy and paste this into your Claude Code chat exactly as-is.

Run Claude Code in the project root and make these exact changes, scanning the whole codebase first:

Enable compression

1. Enable gzip or Brotli compression on your web server / hosting.
2. For Vercel/Netlify this is automatic. For custom servers, configure nginx/Apache gzip.

Why this matters

HTML, CSS, and JavaScript compress extremely well — typically 70-80% smaller. That shaves hundreds of milliseconds off Time to First Byte and LCP, especially on mobile.

Every major host supports this out of the box (Vercel, Netlify, Cloudflare, Replit). Self-hosted? Enable it in nginx/Caddy/Apache config. Brotli is preferable; gzip is the universal fallback.

How to use this prompt in Claude Code

1. Open your Claude Code project.
2. Copy the prompt above with the copy button.
3. Paste into the Claude Code chat and send.
4. Review the diff, accept the changes, redeploy.
5. Verify the fix using the checklist below.

Common mistakes to avoid

error_outlineCompressing already-compressed assets (JPEG, PNG, WebP) — waste of CPU.
error_outlineEnabling compression but not for the right content types — images and PDFs should not be recompressed.
error_outlineAssuming your host does it automatically without verifying.

How to verify the fix worked

check_circle`curl -I -H "Accept-Encoding: br" URL` — `Content-Encoding: br` in response.
check_circleChrome DevTools → Network → response headers show `content-encoding`.
check_circlehttps://tools.keycdn.com/brotli-test — green check.

Frequently asked questions

gzip or brotli?expand_more

Brotli is ~15-20% better than gzip on text. All modern browsers support it. Ship brotli, fall back to gzip.

Does it hurt CPU?expand_more

Negligibly, and hosts pre-compress static assets at build. Cost is near-zero.

Want all 34 prompts tailored to your Claude Code site?

Pantra scans your site in 10 seconds, detects the stack, and generates the exact prompts that apply — only the ones you actually need.

Scan my site

Related Claude Code prompts

Performance