Skip to content

v3.6.2 — quota-bar statusline + Recommended CC operational config

Choose a tag to compare

@vsits-proxy-builder vsits-proxy-builder released this 22 May 01:47
· 60 commits to main since this release
2290c01

Patch release. Two contributor PRs ship together, plus a small doc-accuracy correction.

Contributors

  • @schuay — statusline quota-bar rework (#140)
  • @fgrosswig — CC binary analysis informing the recommended config section (#139)

What's new

Statusline rework — quota bar with exhaust projection (#140)

Contributed by @schuay. tools/quota-statusline.sh now renders each window as a 10-cell bar with an elapsed-time tick, plus a (exhaust X, reset Y) projection:

Q5h [███░┃░░░░░] 30% (exhaust 4h40m, reset 3h00m) | Q7d [█████┃░░░░] 53% (exhaust 3d 13h, reset 3d 0h) | TTL:1h 98.3%
  • Filled cells are consumed quota.
  • Tick marks wall-clock elapsed position in the window. Tick to the right of fill = under pace. Tick inside fill = burning faster than time.
  • exhaust = projected time-to-100% at the current burn rate.
  • reset = wall-clock time until window rollover.
  • When exhaust < reset, you'll hit 100% before the window resets — back off.

Output format break: downstream tools that grep Q5h: N% need to switch to Q5h \[.{10}\] N%. The bar uses standard Unicode block characters (█┃░); terminals without Unicode font coverage will need a Unicode-capable monospace font. TTL / hit-rate / PEAK / OVERAGE suffix segments are unchanged.

Thank you, @schuay.

Recommended CC operational config — README section (#139)

New README section documenting three ~/.claude/settings.json env vars that solve adjacent CC problems the proxy can't reach:

  • CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP=1 — disables CC's silent post-update model remap.
  • ANTHROPIC_MODEL — pins the primary model so cache prefix stays stable across CC version bumps.
  • ANTHROPIC_SMALL_FAST_MODEL — pins the side-channel fast model.

Plus caveats on autoCompactWindow=1M (only works on 1M-eligible models with the right beta header) and CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 (strips tool fields outside ["name", "description", "input_schema", "cache_control"]).

Findings sourced from @fgrosswig's binary analysis of CC v2.1.91 — public methodology (PowerShell + ASCII string extraction), privately shared punch list. Thank you, @fgrosswig.

README provenance-claim correction (#134)

The prior README's supply-chain paragraph claimed "npm provenance links each published version to its source commit." Verified against the npm registry: no published release carries sigstore provenance attestations — only the default signatures field. Corrected the wording to match reality. No package behavior change.

Upgrade

npm install -g claude-code-cache-fix@3.6.2

Tests

824 → 831 (+7): seven new format-contract tests pinning the quota-bar output across edge cases (under-pace, over-pace, missing resets_at, stale window, fresh window, pre-warmup, at-cap).