---
doc_id: commands/claude-cache
audience: user
mode: mixed
review_policy: contract
stability: evolving
covers_surfaces: [command:claude-cache]
covers_sources: []
---
# `/claude-cache`

<!-- pi-docs:begin name="command-contract-claude-cache" generator="scripts/docs/generate.mjs" -->
| Command | Description | Provenance |
| --- | --- | --- |
| `/claude-cache` | Show or set Claude cache retention for this session (short, long, default) | `src/core/anthropic-attribution.ts:1928` |
<!-- pi-docs:end name="command-contract-claude-cache" -->

Show or change the Anthropic cache-retention preference for the current session.

## Synopsis

```text
/claude-cache
/claude-cache status
/claude-cache short
/claude-cache long
/claude-cache default
```

## Behavior

- No argument and `status` show the effective preference.
- `short` requests normal ephemeral retention.
- `long` requests one-hour retention where the selected model supports it.
- `default` removes the session override and returns to process/package policy.

The decision is persisted as a branch-local custom session entry and restored after reload, resume, and tree navigation. It does not enter model context.

An explicit call-level cache posture remains authoritative. In particular, Pi compaction calls that request no cache markers are not re-marked by the session default.

## Errors and boundaries

Unknown arguments fail with the accepted values. Malformed persisted entries and invalid `PI_CACHE_RETENTION` values fail loudly.

The command controls the package-owned Anthropic subscription provider only. It does not enable metered API credentials, alter non-Anthropic routes, or change isolated Fusion children; set `PI_CACHE_RETENTION` for isolated child processes.

## Related docs

- [Anthropic attribution subsystem](../subsystems/anthropic-attribution.md)
- [Configuration](../operations/configuration.md)