What this read moved
1–3 of 3overview Changed · +5 / -5 lines
from line 18
1818 <Tab title="Native Install (Recommended)">
1919 **macOS, Linux, WSL:**
2020
21 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
21 ```bash theme={null}
2222 curl -fsSL https://claude.ai/install.sh | bash
2323 ```
2424
2525 **Windows PowerShell:**
2626
27 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
27 ```powershell theme={null}
2828 irm https://claude.ai/install.ps1 | iex
2929 ```
3030
3131 **Windows CMD:**
3232
33 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
33 ```batch theme={null}
3434 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3535 ```
3636
from line 46
4646 </Tab>
4747
4848 <Tab title="Homebrew">
49 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
49 ```bash theme={null}
5050 brew install --cask claude-code
5151 ```
5252
from line 58
5858 </Tab>
5959
6060 <Tab title="WinGet">
61 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
61 ```powershell theme={null}
6262 winget install Anthropic.ClaudeCode
6363 ```
6464
prompt-caching Changed · +6 / -6 lines
from line 31
3131Two settings don't appear in the layer table but still affect what stays cached:
3232
3333* **Model**: each model has its own cache. Switching models recomputes the entire request even when the content is identical. See [Switching models](#switching-models) below.
34* **Effort level**: on most models, each effort level has its own cache, so changing effort mid-session recomputes the entire request. On Fable 5.1 with an API key or a Claude subscription, the cache stays intact by default. See [Changing effort level](#changing-effort-level) below.
34* **Effort level**: on most models, each effort level has its own cache, so changing effort mid-session recomputes the entire request. On Opus 5.5 and Fable 5.1 with an API key or a Claude subscription, the cache stays intact by default. See [Changing effort level](#changing-effort-level) below.
3535
3636<Tip>
3737 Pick your model and effort level at the top of a session, then save `/compact` for natural breaks between tasks. The fewer changes you make mid-task, the higher your cache hit rate.
from line 92
9292
9393On most models, changing the [effort level](/docs/en/model-config#adjust-effort-level) mid-session means the next request reads the entire conversation history with no cache hits. While the cache is still warm, Claude Code asks you to confirm the change first.
9494
95On Fable 5.1 with an API key or a Claude subscription, changing effort keeps the cache, and Claude Code applies the new level without asking. This doesn't apply on Amazon Bedrock, Google Cloud's Agent Platform, or a [Claude apps gateway](/docs/en/claude-apps-gateway), or when you set [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/en/llm-gateway-protocol#disable-pre-release-capabilities) or your organization has a HIPAA configuration.
95On Opus 5.5 and Fable 5.1 with an API key or a Claude subscription, changing effort keeps the cache, and Claude Code applies the new level without asking. This doesn't apply on Amazon Bedrock, Google Cloud's Agent Platform, or a [Claude apps gateway](/docs/en/claude-apps-gateway), or when you set [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/en/llm-gateway-protocol#disable-pre-release-capabilities) or your organization has a HIPAA configuration.
9696
9797Before v2.1.260, changing effort on Fable 5.1 with an API key or a Claude subscription also invalidated the cache.
9898
from line 300
300300
301301Cache performance shows up as two token counts the API reports on every response. The most direct way to watch them live is a [statusline script](/docs/en/statusline) that reads the `current_usage` object:
302302
303| Field | Meaning |
304| ----------------------------- | --------------------------------------------------------------------------------------- |
305| `cache_creation_input_tokens` | Tokens written to the cache on this turn, billed at the cache write rate |
306| `cache_read_input_tokens` | Tokens served from cache on this turn, billed at roughly 10% of the standard input rate |
303| Field | Meaning |
304| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
305| `cache_creation_input_tokens` | Tokens written to the cache on this turn, billed at the cache write rate |
306| `cache_read_input_tokens` | Tokens served from cache on this turn, billed at the model's [cached token rate](https://platform.claude.com/docs/en/about-claude/pricing), below the standard input rate |
307307
308308A high read-to-creation ratio means caching is working well. If creation stays high turn after turn, something is changing in your prefix. The [actions that invalidate the cache](#actions-that-invalidate-the-cache) section lists the usual causes.
309309
quickstart Changed · +5 / -5 lines
from line 25
2525 <Tab title="Native Install (Recommended)">
2626 **macOS, Linux, WSL:**
2727
28 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
28 ```bash theme={null}
2929 curl -fsSL https://claude.ai/install.sh | bash
3030 ```
3131
3232 **Windows PowerShell:**
3333
34 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
34 ```powershell theme={null}
3535 irm https://claude.ai/install.ps1 | iex
3636 ```
3737
3838 **Windows CMD:**
3939
40 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
40 ```batch theme={null}
4141 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4242 ```
4343
from line 53
5353 </Tab>
5454
5555 <Tab title="Homebrew">
56 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
56 ```bash theme={null}
5757 brew install --cask claude-code
5858 ```
5959
from line 65
6565 </Tab>
6666
6767 <Tab title="WinGet">
68 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
68 ```powershell theme={null}
6969 winget install Anthropic.ClaudeCode
7070 ```
7171