Disable Auto-Compact
⚠️
This is critical. Auto-compact destroys context unpredictably. This setup uses /wrapup then /clear instead.
Why Disable Auto-Compact?
Auto-compact summarizes your conversation when context fills up. This means:
- Lost implementation details
- Forgotten decisions and reasoning
- Inconsistent behavior between sessions
- No control over what gets preserved
How to Disable
Claude Code Settings → Cmd+, (macOS) or Ctrl+, (Linux)
Auto-compact: falseThe Alternative Workflow
Instead of auto-compact, use the Document & Clear workflow:
- Work until context fills (~80% shown in status line)
- Run
/wrapupto save status to CLAUDE.md - Run
/clearto start fresh - Run
/catchupto resume where you left off
This gives you full control over what gets preserved between sessions.
Monitoring Context Usage
With ccstatusline installed, you’ll see:
Ctx: 45% | Model: opus | Branch: mainWhen it hits ~80%, it’s time for /wrapup.