From 343d6f0f992de4b5fadd10583388efde7cf39e71 Mon Sep 17 00:00:00 2001 From: Luong NGUYEN Date: Wed, 29 Jul 2026 15:01:31 +0700 Subject: [PATCH] docs: sync to Claude Code v2.1.220 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bumps tutorial coverage from the v2.1.217 baseline (2026-07-22 sync) to v2.1.220 — three contiguous releases (v2.1.218–v2.1.220). Critical fixes: - Nested subagent spawning is on by default again at depth 3 (v2.1.219). Five locations across 04-subagents, CATALOG, 10-cli and QUICK_REFERENCE stated it was disabled by default — true for v2.1.217–v2.1.218 only. CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 now disables rather than enables. All five carry an identical three-era history note. - Claude Opus 5 is the default Opus model (v2.1.219). 10-cli asserted "Opus 4.8 remains the default"; Opus 5 was absent from every model table. Added to both model tables, 19 Compatible Models footers, and ~20 effort-level enumerations. Also fixed: fast-mode model list, auto-mode eligibility self-contradiction in 09-advanced-features, stale CLAUDE_CODE_ENABLE_AUTO_MODE opt-in in CATALOG, hook-event count disagreement (29/30 -> 31 across three files), doc-generator skill name/directory mismatch, stale "May 2026" headings, and the last three docs.anthropic.com links. Added: DirectoryAdded hook, /deep-research explicit-invocation note, /code-review background subagent, context:fork background default, agent frontmatter hook workspace trust, dynamic workflow size guideline and workflowSizeGuideline key, sandbox.network.strictAllowlist, MCP error surfacing, stream-json nested subagent forwarding, frontmatter boolean values, agent name ':' rejection, auto/plan-mode classifier changes, and Opus 5 safety-classifier fallback. Renamed the deep-research skill example to topic-research to stop it shadowing the built-in; mirrored to vi/ja/uk. doc-generator rename mirrored to ja/zh/uk. --- 01-slash-commands/README.md | 15 ++- 03-skills/README.md | 18 ++- 03-skills/doc-generator/SKILL.md | 2 +- 04-subagents/README.md | 13 ++- 05-mcp/README.md | 48 +++++++- 06-hooks/README.md | 10 +- 07-plugins/README.md | 7 +- 07-plugins/devops-automation/README.md | 7 +- 07-plugins/documentation/README.md | 7 +- 07-plugins/pr-review/README.md | 7 +- 08-checkpoints/README.md | 7 +- 08-checkpoints/checkpoint-examples.md | 7 +- 09-advanced-features/README.md | 60 +++++++--- .../planning-mode-examples.md | 7 +- 10-cli/README.md | 34 +++--- CATALOG.md | 20 ++-- CHANGELOG.md | 107 ++++++++++++++++++ INDEX.md | 11 +- LEARNING-ROADMAP.md | 11 +- QUICK_REFERENCE.md | 15 ++- README.md | 10 +- STYLE_GUIDE.md | 14 +-- claude_concepts_guide.md | 20 ++-- ja/03-skills/README.md | 2 +- ja/03-skills/doc-generator/SKILL.md | 2 +- resources.md | 9 +- uk/03-skills/README.md | 2 +- uk/03-skills/doc-generator/SKILL.md | 2 +- vi/03-skills/README.md | 2 +- zh/03-skills/doc-generator/SKILL.md | 2 +- 30 files changed, 344 insertions(+), 134 deletions(-) diff --git a/01-slash-commands/README.md b/01-slash-commands/README.md index 7a04206..b712885 100644 --- a/01-slash-commands/README.md +++ b/01-slash-commands/README.md @@ -39,11 +39,11 @@ Built-in commands are shortcuts for common actions. There are **60+ built-in com | `/desktop` | Continue in Desktop app (alias: `/app`) | | `/diff` | Interactive diff viewer for uncommitted changes | | `/doctor` | Diagnose installation health — openable while Claude is responding; shows status icons; press `f` to auto-fix issues (enhanced in v2.1.116; layout refreshed to a flat tree with clearer icons in v2.1.178) | -| `/effort [low\|medium\|high\|xhigh\|max\|auto]` | Set effort level via interactive arrow-key slider. Levels: `low` → `medium` → `high` → `xhigh` (new in v2.1.111) → `max`. Default is `high` on Opus 4.8 (`xhigh` on Opus 4.7); `xhigh` needs Opus 4.8 or 4.7; `max` works on Opus 4.8/4.7/4.6 and Sonnet 4.6. The menu also offers `ultracode` (not a model effort level — it sends `xhigh` and has Claude orchestrate dynamic workflows; session-only) | +| `/effort [low\|medium\|high\|xhigh\|max\|auto]` | Set effort level via interactive arrow-key slider. Levels: `low` → `medium` → `high` → `xhigh` (new in v2.1.111) → `max`. Default is `high` on Opus 5, Sonnet 5, and Opus 4.8 (`xhigh` on Opus 4.7); `xhigh` needs Opus 5, Sonnet 5, Opus 4.8, or Opus 4.7; `max` works on Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 and Sonnet 4.6. The menu also offers `ultracode` (not a model effort level — it sends `xhigh` and has Claude orchestrate dynamic workflows; session-only) | | `/exit` | Exit the REPL (alias: `/quit`) | | `/export [filename]` | Export the current conversation to a file or clipboard | | `/usage-credits` | Configure extra usage for rate limits (renamed from `/extra-usage` in v2.1.144; `/extra-usage` still works as an alias) | -| `/fast [on\|off]` | Toggle fast mode | +| `/fast [on\|off]` | Toggle fast mode. Applies to Opus 5 and Opus 4.8 (v2.1.219) | | `/feedback` | Submit feedback (alias: `/bug`). Since v2.1.141, can attach recent sessions (last 24h or 7d) so reports spanning more than one session include context. As of v2.1.178, `/bug` requires a description before it can be submitted. | | `/focus` | Toggle focus view (added v2.1.110; replaces `Ctrl+O` for focus toggle) | | `/goal ` | Register a session-level completion condition; Claude keeps working until the goal is met. `/goal clear` removes it. Active goal appears in the status line, with a live overlay panel showing elapsed time, turn count, and token usage (added v2.1.139). | @@ -61,7 +61,7 @@ Built-in commands are shortcuts for common actions. There are **60+ built-in com | `/mcp` | Manage MCP servers and OAuth | | `/memory` | Edit `CLAUDE.md`, toggle auto-memory | | `/mobile` | QR code for mobile app (aliases: `/ios`, `/android`) | -| `/model [model]` | Select model with left/right arrows for effort. Since v2.1.153, the choice is **saved as the default** for new sessions (matching the IDE); press `s` after selecting to apply it to the current session only. (The keybinding `modelPicker:setAsDefault` was renamed to `modelPicker:thisSessionOnly`; the old `d` action is now `s`.) | +| `/model [model]` | Select model with left/right arrows for effort. Since v2.1.153, the choice is **saved as the default** for new sessions (matching the IDE); press `s` after selecting to apply it to the current session only. (The keybinding `modelPicker:setAsDefault` was renamed to `modelPicker:thisSessionOnly`; the old `d` action is now `s`.) As of v2.1.219, the picker shows the merged Opus row as "Opus (1M context)". | | `/passes` | Share free week of Claude Code | | `/permissions` | View/update permissions (alias: `/allowed-tools`) | | `/plan [description]` | Enter plan mode | @@ -149,7 +149,7 @@ These skills ship with Claude Code and are invoked like slash commands: - `/recap` command added to manually trigger session context recap (v2.1.108) - `/undo` added as alias for `/rewind` (v2.1.108) - `/proactive` added as alias for `/loop` (v2.1.105) -- `/effort` gained interactive arrow-key slider and new `xhigh` level between `high` and `max`; default effort raised to `xhigh` for Opus 4.7 plans (v2.1.111). On Opus 4.8 the default is `high` (v2.1.154) +- `/effort` gained interactive arrow-key slider and new `xhigh` level between `high` and `max`; default effort raised to `xhigh` for Opus 4.7 plans (v2.1.111). On Opus 4.8 the default is `high` (v2.1.154); Opus 5 also defaults to `high` (v2.1.219) - `/ultrareview` added for comprehensive cloud-based multi-agent code review (v2.1.111) - `/less-permission-prompts` added to analyze Bash/MCP tool calls and reduce permission prompts via an allowlist in `.claude/settings.json` (v2.1.111) - Auto mode no longer requires the `--enable-auto-mode` flag for Max subscribers on Opus 4.7 (v2.1.112) @@ -633,8 +633,8 @@ If both exist with the same name, the **skill takes precedence**. Remove one or --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/slash-commands - https://code.claude.com/docs/en/skills @@ -643,12 +643,11 @@ If both exist with the same name, the **skill takes precedence**. Remove one or - https://code.claude.com/docs/en/commands - https://code.claude.com/docs/en/model-config - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md -- https://docs.anthropic.com/en/docs/claude-code/slash-commands - https://github.com/anthropics/claude-code/releases/tag/v2.1.139 - https://github.com/anthropics/claude-code/releases/tag/v2.1.144 - https://github.com/anthropics/claude-code/releases/tag/v2.1.152 - https://github.com/anthropics/claude-code/releases/tag/v2.1.153 - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 *Part of the [Claude How To](../) guide series* diff --git a/03-skills/README.md b/03-skills/README.md index ad94cec..79b79e1 100644 --- a/03-skills/README.md +++ b/03-skills/README.md @@ -158,6 +158,7 @@ model: opus # Specific model to use effort: high # Effort level override (low, medium, high, xhigh, max) context: fork # Run in isolated subagent agent: Explore # Which agent type (with context: fork) +background: false # Fork skills run in background (default true); false = foreground shell: bash # Shell for commands: bash (default) or powershell hooks: # Skill-scoped hooks PreToolUse: @@ -179,13 +180,16 @@ paths: "src/api/**/*.ts" # Glob patterns limiting when skill activ | `allowed-tools` | Comma-separated list of tools the skill may use without permission prompts. | | `disallowed-tools` | Comma-separated list of tools to remove while the skill is active (complements `allowed-tools`). Added v2.1.152. | | `model` | Model override while the skill is active (e.g., `opus`, `sonnet`). | -| `effort` | Effort level override while the skill is active: `low`, `medium`, `high`, `xhigh`, or `max`. Available levels depend on the model — the default effort is `high` on Opus 4.8 (`xhigh` on Opus 4.7). | +| `effort` | Effort level override while the skill is active: `low`, `medium`, `high`, `xhigh`, or `max` — all five are supported on Opus 5, Sonnet 5, Opus 4.8, and Opus 4.7. The default effort is `high` on every model that supports effort, except Opus 4.7 which defaults to `xhigh`. | | `context` | `fork` to run the skill in a forked subagent context with its own context window. | | `agent` | Subagent type when `context: fork` (e.g., `Explore`, `Plan`, `general-purpose`). | +| `background` | Only meaningful with `context: fork`. Defaults to `true` for `context: fork` skills, so they run in the background; set `false` to run them in the foreground. Added v2.1.218. | | `shell` | Shell used for `` !`command` `` substitutions and scripts: `bash` (default) or `powershell`. | | `hooks` | Hooks scoped to this skill's lifecycle (same format as global hooks). | | `paths` | Glob patterns that limit when the skill is auto-activated. Comma-separated string or YAML list. Same format as path-specific rules. | +Since v2.1.218, boolean frontmatter fields also accept `yes`/`no`, `on`/`off`, and `1`/`0` (case-insensitive) in addition to `true`/`false`. + ## Skill Content Types Skills can contain two types of content, each suited for different purposes: @@ -298,7 +302,7 @@ Commands execute immediately; Claude only sees the final output. By default, com ## Running Skills in Subagents -Add `context: fork` to run a skill in an isolated subagent context. The skill content becomes the task for a dedicated subagent with its own context window, keeping the main conversation uncluttered. +Add `context: fork` to run a skill in an isolated subagent context. The skill content becomes the task for a dedicated subagent with its own context window, keeping the main conversation uncluttered. As of v2.1.218, `background` defaults to `true` for `context: fork` skills, so they run in the background; set `background: false` in the frontmatter to run a fork skill in the foreground instead. > **v2.1.145 fix**: A skill using `context: fork` could previously trigger an infinite re-invocation loop in rare cases. Upgrade to v2.1.145+ if you author or rely on forking skills. @@ -324,7 +328,7 @@ agent: Explore ```yaml --- -name: deep-research +name: topic-research description: Research a topic thoroughly context: fork agent: Explore @@ -830,11 +834,12 @@ Claude Code ships with a set of built-in skills that are always available withou | `/claude-api` | Load Claude API/SDK reference; auto-activates on `anthropic`/`@anthropic-ai/sdk` imports | | `/dataviz` | Chart and dashboard design guidance with a runnable color-palette validator (v2.1.198) | | `/debug [description]` | Troubleshoot current session by reading debug log | +| `/deep-research ` | Run an in-depth research pass on a topic (explicit invocation only since v2.1.218 — Claude won't trigger this on its own) | | `/fewer-permission-prompts` | Scan transcripts and propose a prioritized allowlist for common read-only tools | | `/loop [interval] ` | Run prompt repeatedly on interval (e.g., `/loop 5m check the deploy`) | | `/run` *(v2.1.145+)* | Launch this project's app to see a change running — looks for a project skill, otherwise falls back to built-in patterns per project type | | `/run-skill-generator` *(v2.1.145+)* | Teach `/run`/`/verify` how to handle a specific project by generating a per-project skill | -| `/code-review [effort]` | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); pass `--comment` to post findings as inline PR comments. A distinct skill from `/simplify` (quality/reuse cleanups), which was split back out in v2.1.154. (explicit invocation only since v2.1.215 — Claude won't trigger this on its own) | +| `/code-review [effort]` | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); pass `--comment` to post findings as inline PR comments. A distinct skill from `/simplify` (quality/reuse cleanups), which was split back out in v2.1.154. (explicit invocation only since v2.1.215 — Claude won't trigger this on its own) Since v2.1.218 it runs as a background subagent, so review work no longer fills your conversation and stacked slash commands stay its review target. | | `/simplify` | Cleanup-only review — reuse, simplification, efficiency, altitude — and applies the fixes. Split back out from `/code-review` in v2.1.154 | | `/verify` *(v2.1.145+)* | Build, run, and observe the app to confirm a fix works (not just that tests pass) (explicit invocation only since v2.1.215 — Claude won't trigger this on its own) | @@ -883,8 +888,9 @@ Once you start building skills seriously, two things become essential: a library --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/skills - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md +- https://code.claude.com/docs/en/model-config diff --git a/03-skills/doc-generator/SKILL.md b/03-skills/doc-generator/SKILL.md index c053ba9..82d9b23 100644 --- a/03-skills/doc-generator/SKILL.md +++ b/03-skills/doc-generator/SKILL.md @@ -1,5 +1,5 @@ --- -name: api-documentation-generator +name: doc-generator description: Generate comprehensive, accurate API documentation from source code. Use when creating or updating API documentation, generating OpenAPI specs, or when users mention API docs, endpoints, or documentation. --- diff --git a/04-subagents/README.md b/04-subagents/README.md index b91fc0a..44100cb 100644 --- a/04-subagents/README.md +++ b/04-subagents/README.md @@ -121,7 +121,7 @@ to solving problems. | Field | Required | Description | |-------|----------|-------------| -| `name` | Yes | Unique identifier (lowercase letters and hyphens) | +| `name` | Yes | Unique identifier (lowercase letters and hyphens). Lookup is normalized (case- and separator-insensitive — see below), but a name containing `:` is **rejected** as of v2.1.218: `:` is reserved for plugin namespacing | | `description` | Yes | Natural language description of purpose. Include "use PROACTIVELY" to encourage automatic invocation | | `tools` | No | Comma-separated list of specific tools. Omit to inherit all tools. Supports `Agent(agent_name)` syntax to restrict spawnable subagents | | `disallowedTools` | No | Comma-separated list of tools the subagent must not use | @@ -839,7 +839,7 @@ export CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200 Two more environment variables cap subagent fan-out: - `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` (v2.1.217) - Maximum number of subagents running **concurrently** at once. Default: 20. -- `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` (v2.1.217) - Maximum **nesting depth** for subagents spawning their own subagents. Nested spawning is disabled by default; set this to opt in (see [Key Behaviors](#key-behaviors)). +- `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` (v2.1.217) - Maximum **nesting depth** for subagents spawning their own subagents. **Default: 3 since v2.1.219** (was 1 in v2.1.217–v2.1.218). Set this to `1` to disable nesting (see [Key Behaviors](#key-behaviors)). ```bash export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20 @@ -929,7 +929,7 @@ graph TB ### Key Behaviors -- **No nested spawning by default (v2.1.217)** - As of v2.1.217, subagents do not spawn their own subagents by default. Set `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` to opt into nested spawning, up to the depth you configure. (History: from v2.1.172 through v2.1.216, subagents could nest by default, up to 5 levels deep; v2.1.217 made that opt-in.) Use the `Agent(agent_type)` restriction syntax (see [Restrict Spawnable Subagents](#restrict-spawnable-subagents)) to control which subagents a given subagent may spawn +- **Nested spawning on by default, depth 3 (v2.1.219)** - Subagents can spawn their own subagents up to three layers below the main conversation. Set `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` to change the limit, or `1` to turn nesting off. At the depth limit, Claude Code withholds the `Agent` tool from every subagent except a fork. (History: v2.1.172–v2.1.216 nested by default up to 5 layers with no way to change it; v2.1.217 made nesting opt-in at depth 1; v2.1.219 set the default to 3.) Use the `Agent(agent_type)` restriction syntax (see [Restrict Spawnable Subagents](#restrict-spawnable-subagents)) to control which subagents a given subagent may spawn - **Background permissions** - Background subagents auto-deny any permissions that are not pre-approved - **Backgrounding** - Press `Ctrl+B` to background a currently running task - **Transcripts** - Subagent transcripts are stored at `~/.claude/projects/{project}/{sessionId}/subagents/agent-{agentId}.jsonl` @@ -1270,8 +1270,8 @@ See the OpenTelemetry section in [Advanced Features → Telemetry](../09-advance --- -**Last Updated**: July 22, 2026 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/sub-agents - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md @@ -1284,4 +1284,5 @@ See the OpenTelemetry section in [Advanced Features → Telemetry](../09-advance - https://github.com/anthropics/claude-code/releases/tag/v2.1.138 - https://github.com/anthropics/claude-code/releases/tag/v2.1.139 - https://github.com/anthropics/claude-code/releases/tag/v2.1.140 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/05-mcp/README.md b/05-mcp/README.md index 2eee5cd..9b2fd73 100644 --- a/05-mcp/README.md +++ b/05-mcp/README.md @@ -1133,6 +1133,46 @@ npm install -g @modelcontextprotocol/server-slack ## Troubleshooting +### Start With the Error Output (v2.1.219+) + +If a server won't connect, run `claude mcp list` (or `/mcp` inside a session) before changing anything. Claude Code now prints the **HTTP status code and the server's error text** next to the failing server, so you get `401 Unauthorized` or `404 Not Found` instead of a generic "failed to connect": + +```bash +# Shows connection status plus HTTP status and error text for failures +claude mcp list +``` + +Read the status first — it tells you which fix applies: + +- `401` / `403` → bad or expired credentials; re-authenticate with `claude mcp login ` +- `404` → wrong URL (a missing `/mcp` or `/sse` path suffix is the usual cause) +- `5xx` / timeout → the remote server is down; see [Connection Timeout](#connection-timeout) + +### Hidden Whitespace in Config Values (v2.1.219+) + +Claude Code warns when an MCP config value has **leading or trailing whitespace**. This is a common and hard-to-spot cause of auth failures: a token copy-pasted from a browser or a chat message often carries a trailing space or newline, which gets sent verbatim in the `Authorization` header and fails as an invalid credential. + +If you see this warning, re-check the value in `.mcp.json` (or the env var it expands from) and trim it: + +```bash +# Reveals hidden leading/trailing whitespace between the delimiters +printf '[%s]\n' "$GITHUB_TOKEN" +``` + +### Skipped Servers in Headless Runs (v2.1.219+) + +Servers passed via `--mcp-config` that fail config validation are **skipped** rather than aborting the run, so a headless script can appear to work while missing half its tools. Claude Code now reports which ones were dropped: + +- **Headless / `-p` runs**: the stream-json `init` event carries an `mcp_server_errors` field listing every skipped entry. Check it before trusting the run's output. +- **Interactive terminal runs**: the same problem is printed as a startup warning when the session begins. + +```bash +# Inspect skipped --mcp-config entries in a headless run +claude -p "list my tools" --mcp-config ./servers.json \ + --output-format stream-json --verbose \ + | jq -r 'select(.type == "system" and .subtype == "init") | .mcp_server_errors' +``` + ### MCP Server Not Found ```bash # Verify MCP server is installed @@ -1196,13 +1236,13 @@ export GITHUB_TOKEN="your_token" --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/mcp - https://code.claude.com/docs/en/changelog - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 - https://github.com/anthropics/claude-code/releases/tag/v2.1.139 - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md -- https://docs.anthropic.com/en/docs/claude-code/mcp -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/06-hooks/README.md b/06-hooks/README.md index 5762cea..2d95464 100644 --- a/06-hooks/README.md +++ b/06-hooks/README.md @@ -235,7 +235,7 @@ Subagent-based verification hooks that spawn a dedicated agent to evaluate condi ## Hook Events -Claude Code supports **30 hook events**: +Claude Code supports **31 hook events**: | Event | When Triggered | Matcher Input | Can Block | Common Use | |-------|---------------|---------------|-----------|------------| @@ -261,6 +261,7 @@ Claude Code supports **30 hook events**: | **TaskCreated** | Task created via TaskCreate | (none) | No | Task tracking, logging | | **ConfigChange** | Config file changes | (none) | Yes (except policy) | React to config updates | | **CwdChanged** | Working directory changes | (none) | No | Directory-specific setup | +| **DirectoryAdded** | New working directory registered mid-session via `/add-dir` or the SDK `register_repo_root` control request (v2.1.219) | (none) | No | Set up tooling for a newly added directory | | **FileChanged** | Watched file changes | (none) | No | File monitoring, rebuild | | **PreCompact** | Before context compaction | manual/auto | No | Pre-compact actions | | **PostCompact** | After compaction completes | (none) | No | Post-compact actions | @@ -558,6 +559,8 @@ hooks: --- ``` +**Workspace trust required (v2.1.218):** Frontmatter hooks in a **project** subagent now require workspace trust acceptance for the folder the agent file came from before they run. Before v2.1.218, these hooks could run from folders you hadn't trusted. See the [subagents documentation](https://code.claude.com/docs/en/sub-agents#hooks-in-subagent-frontmatter) for which scopes are exempt. + ## PermissionRequest Event Handles permission requests with custom output format: @@ -1509,8 +1512,9 @@ Edit `~/.claude/settings.json` or `.claude/settings.json` with the hook configur --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/hooks - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md +- https://code.claude.com/docs/en/sub-agents diff --git a/07-plugins/README.md b/07-plugins/README.md index ea5f1c0..5eae653 100644 --- a/07-plugins/README.md +++ b/07-plugins/README.md @@ -1125,8 +1125,8 @@ The following Claude Code features work together with plugins: --- -**Last Updated**: July 11, 2026 -**Claude Code Version**: 2.1.206 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/changelog#2-1-172 @@ -1142,4 +1142,5 @@ The following Claude Code features work together with plugins: - https://github.com/anthropics/claude-code/releases/tag/v2.1.142 - https://github.com/anthropics/claude-code/releases/tag/v2.1.143 - https://code.claude.com/docs/en/cli-reference -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/07-plugins/devops-automation/README.md b/07-plugins/devops-automation/README.md index df7f1b3..6354ea4 100644 --- a/07-plugins/devops-automation/README.md +++ b/07-plugins/devops-automation/README.md @@ -108,10 +108,11 @@ Result: --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/plugins - https://github.com/anthropics/claude-code/releases/tag/v2.1.131 - https://github.com/anthropics/claude-code/releases/tag/v2.1.138 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/07-plugins/documentation/README.md b/07-plugins/documentation/README.md index 983a77d..75123d0 100644 --- a/07-plugins/documentation/README.md +++ b/07-plugins/documentation/README.md @@ -120,10 +120,11 @@ export GITHUB_TOKEN="your_github_token" --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/plugins - https://github.com/anthropics/claude-code/releases/tag/v2.1.131 - https://github.com/anthropics/claude-code/releases/tag/v2.1.138 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/07-plugins/pr-review/README.md b/07-plugins/pr-review/README.md index fa17331..dae7a75 100644 --- a/07-plugins/pr-review/README.md +++ b/07-plugins/pr-review/README.md @@ -92,10 +92,11 @@ Result: --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/plugins - https://github.com/anthropics/claude-code/releases/tag/v2.1.131 - https://github.com/anthropics/claude-code/releases/tag/v2.1.138 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/08-checkpoints/README.md b/08-checkpoints/README.md index 6e6b093..35144fc 100644 --- a/08-checkpoints/README.md +++ b/08-checkpoints/README.md @@ -330,10 +330,11 @@ Remember: checkpoints are not a replacement for git. Use checkpoints for rapid e --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/checkpointing - https://code.claude.com/docs/en/settings - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/08-checkpoints/checkpoint-examples.md b/08-checkpoints/checkpoint-examples.md index 6713f52..7a5dd7d 100644 --- a/08-checkpoints/checkpoint-examples.md +++ b/08-checkpoints/checkpoint-examples.md @@ -339,9 +339,10 @@ User: Now let's continue with the approach that worked. 6. **Summarize long sessions**: Use "Summarize from here" to keep conversations manageable --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/checkpointing - https://code.claude.com/docs/en/changelog -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/09-advanced-features/README.md b/09-advanced-features/README.md index aab0569..a839fc8 100644 --- a/09-advanced-features/README.md +++ b/09-advanced-features/README.md @@ -279,8 +279,8 @@ Extended thinking is a deliberate, step-by-step reasoning process where Claude: - `Option + T` (macOS) / `Alt + T` (Windows/Linux) - Toggle extended thinking **Automatic activation**: -- Enabled by default for all models (Opus 4.8, Opus 4.7, Sonnet 4.6, Haiku 4.5) -- Opus 4.8: Adaptive reasoning with effort levels: `low` (○), `medium` (◐), `high` (●), `xhigh`, `max`. The default is `high` on Opus 4.8 (v2.1.154), Opus 4.6, and Sonnet 4.6, and `xhigh` on Opus 4.7. `xhigh` is available on Opus 4.8 and Opus 4.7 (it falls back to `high` on Opus 4.6 / Sonnet 4.6). `max` works on Opus 4.8/4.7/4.6 and Sonnet 4.6 (session-only). Haiku 4.5 has no effort levels. Opus 4.8 and Opus 4.7 have a 1M-token native context window (1M context fix landed in v2.1.117 — before that, `/context` miscounted Opus 4.7 against a 200K window and triggered premature autocompact). Since v2.1.129, `/context` shows its visualization in-UI only; the ASCII viz no longer leaks into the conversation context (~1.6k tokens saved per call), so `/context` is safe to invoke freely. +- Enabled by default for all models (Opus 5, Opus 4.8, Opus 4.7, Sonnet 4.6, Haiku 4.5) +- Opus 5 / Opus 4.8: Adaptive reasoning with effort levels: `low` (○), `medium` (◐), `high` (●), `xhigh`, `max`. The default is `high` on Opus 5 (v2.1.219), Opus 4.8 (v2.1.154), Opus 4.6, and Sonnet 4.6, and `xhigh` on Opus 4.7. `xhigh` is available on Opus 5, Opus 4.8, and Opus 4.7 (it falls back to `high` on Opus 4.6 / Sonnet 4.6). `max` works on Opus 5 and Opus 4.8/4.7/4.6 and Sonnet 4.6 (session-only). Haiku 4.5 has no effort levels. Opus 5, Opus 4.8, and Opus 4.7 have a 1M-token native context window (1M context fix landed in v2.1.117 — before that, `/context` miscounted Opus 4.7 against a 200K window and triggered premature autocompact). Since v2.1.129, `/context` shows its visualization in-UI only; the ASCII viz no longer leaks into the conversation context (~1.6k tokens saved per call), so `/context` is safe to invoke freely. - Pro/Max subscribers on Opus 4.6 / Sonnet 4.6: default effort was raised from `medium` to `high` in v2.1.117. - Other models: Fixed budget up to 31,999 tokens @@ -294,9 +294,9 @@ Extended thinking is a deliberate, step-by-step reasoning process where Claude: export MAX_THINKING_TOKENS=1024 ``` -**Effort level** (supported on Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6 — not Haiku 4.5): +**Effort level** (supported on Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6 — not Haiku 4.5): ```bash -export CLAUDE_CODE_EFFORT_LEVEL=high # low (○), medium (◐), high (●), xhigh (Opus 4.8/4.7), or max — default is high on Opus 4.8 +export CLAUDE_CODE_EFFORT_LEVEL=high # low (○), medium (◐), high (●), xhigh (Opus 5/4.8/4.7), or max — default is high on Opus 5 and Opus 4.8 ``` **CLI flag**: @@ -309,7 +309,16 @@ claude --effort high "complex architectural review" /effort high ``` -> **Note:** The keyword "ultrathink" in prompts activates deep reasoning mode. Effort levels `low`, `medium`, `high`, and `max` are supported on Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6 (Haiku 4.5 has none). `xhigh` is available on Opus 4.8 and Opus 4.7. The default effort is `high` on Opus 4.8 (and Opus 4.6 / Sonnet 4.6) and `xhigh` on Opus 4.7. The `/effort` menu also offers `ultracode`, which is **not** a model effort level — it sends `xhigh` and has Claude orchestrate dynamic workflows (session-only). +> **Note:** The keyword "ultrathink" in prompts activates deep reasoning mode. Effort levels `low`, `medium`, `high`, and `max` are supported on Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6 (Haiku 4.5 has none). `xhigh` is available on Opus 5, Opus 4.8, and Opus 4.7. The default effort is `high` on Opus 5, Opus 4.8 (and Opus 4.6 / Sonnet 4.6) and `xhigh` on Opus 4.7. Unlike Opus 4.8 and Opus 4.7, which pin their default effort on first run, Opus 5 has no such hold — a level you previously set carries over. The `/effort` menu also offers `ultracode`, which is **not** a model effort level — it sends `xhigh` and has Claude orchestrate dynamic workflows (session-only). + +### Safety-Classifier Fallback on Opus 5 + +Separate from the [`fallbackModel` setting](#fallback-models-fallbackmodel) (which handles overload and unavailability), Claude Code applies a **category-based fallback** when a safety classifier flags a request. It requires Claude Code v2.1.219 or later. + +- **Opus 5**: cybersecurity-flagged requests re-run on Opus 4.8. Biology-flagged requests end with a refusal instead, because Opus 5 runs its own biology classifiers with no fallback model. You get those refusals from the first flagged request. +- Workloads in offensive security or biology — penetration testing, Capture the Flag (CTF) exercises, and biology-adjacent codebases — trigger fallback frequently, often on the first request. + +Why this matters here: if you run [security-review subagents](../04-subagents/README.md) or CTF/pentest work on Opus 5, expect silent re-runs on Opus 4.8 (different effort ceiling and context window) for cybersecurity prompts, and outright refusals for biology-adjacent ones. Pin a different model explicitly if that behavior gets in the way. ### Benefits of Extended Thinking @@ -397,26 +406,29 @@ Extended thinking is controlled via environment variables, keyboard shortcuts, a # Set thinking token budget export MAX_THINKING_TOKENS=16000 -# Set effort level (Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6): low (○), medium (◐), high (●), xhigh (Opus 4.8/4.7), or max — default is high on Opus 4.8 +# Set effort level (Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6): low (○), medium (◐), high (●), xhigh (Opus 5/4.8/4.7), or max — default is high on Opus 5 and Opus 4.8 export CLAUDE_CODE_EFFORT_LEVEL=high ``` Toggle during a session with `Alt+T` / `Option+T`, set effort with `/effort`, or configure via `/config`. -> **Lean system prompt (v2.1.154):** The lean system prompt is now the **default** for all models except Haiku, Sonnet, and Opus 4.7-and-earlier, reducing baseline token overhead on Opus 4.8. +> **Lean system prompt (v2.1.154):** The lean system prompt is now the **default** for all models except Haiku, Sonnet, and Opus 4.7-and-earlier, reducing baseline token overhead on Opus 5 and Opus 4.8. --- ## Auto Mode -Auto Mode is a permission mode that uses a background safety classifier to review each action before execution. It allows Claude to work autonomously while blocking dangerous operations. It's available on all plans, but requires an eligible model (Claude Opus 4.6+, Sonnet 4.6+, or Fable 5 on the Anthropic API and Claude Platform on AWS; Sonnet 5, Opus 4.7, Opus 4.8, or Fable 5 on Bedrock, Vertex, Foundry, and signed-in Claude apps gateway sessions) and, on Team/Enterprise, an Owner opt-in. +Auto Mode is a permission mode that uses a background safety classifier to review each action before execution. It allows Claude to work autonomously while blocking dangerous operations. It's available on all plans, but requires an eligible model (Claude Opus 5, Opus 4.6+, Sonnet 4.6+, or Fable 5 on the Anthropic API and Claude Platform on AWS; Opus 5, Sonnet 5, Opus 4.7, Opus 4.8, or Fable 5 on Bedrock, Vertex, Foundry, and signed-in Claude apps gateway sessions). On Team and Enterprise it is on by default — administrators can turn it off for the organization in managed settings. ### Requirements -- **Plan**: Team, Enterprise, or API (not available on Pro or Max plans) -- **Model**: Claude Sonnet 4.6 or Opus 4.8 -- **Provider**: Anthropic API only (not supported on Bedrock, Vertex, or Foundry) -- **Classifier**: Runs on Claude Sonnet 4.6 (adds extra token cost) +Auto mode is available only when your account meets all of these requirements: + +- **Plan**: all plans. +- **Organization**: on Team and Enterprise, auto mode is available by default. Administrators can turn it off for the organization by setting `permissions.disableAutoMode` to `"disable"` in managed settings. +- **Model**: on the Anthropic API and Claude Platform on AWS — Claude Opus 4.6 or later (Opus 5 included), Sonnet 4.6 or later, or Fable 5. On Amazon Bedrock, Google Cloud's Agent Platform (Vertex AI), Microsoft Foundry, and signed-in Claude apps gateway sessions — only Claude Sonnet 5, Opus 4.7 or later (Opus 5 included), and Fable 5. Older models — Sonnet 4.5, Opus 4.5, Haiku, and claude-3 models — are not supported on any provider. +- **Provider**: available by default on the Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform (Vertex AI), Microsoft Foundry, and signed-in Claude apps gateway sessions. In v2.1.158 through v2.1.206, auto mode was off on all of these except the Anthropic API and Claude Platform on AWS until you set `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removed the requirement. The variable is still accepted for compatibility and has no effect from v2.1.207 onward. +- **Classifier**: runs on Claude Sonnet 4.6 (adds extra token cost) ### Enabling Auto Mode @@ -431,7 +443,7 @@ claude --enable-auto-mode > **v2.1.158 update**: Auto mode became available on Bedrock, Vertex, and Foundry for Opus 4.7/4.8, gated behind `CLAUDE_CODE_ENABLE_AUTO_MODE=1`. > -> **v2.1.207 update**: That opt-in requirement was removed. Auto mode is now available by default on Bedrock, Vertex AI, Microsoft Foundry, and signed-in Claude apps gateway sessions for Claude Sonnet 5, Opus 4.7, Opus 4.8, and Fable 5 — no flag or env var needed. Administrators can disable it with `disableAutoMode` in managed settings. `CLAUDE_CODE_ENABLE_AUTO_MODE` is still accepted for compatibility but has no effect from v2.1.207 onward. +> **v2.1.207 update**: That opt-in requirement was removed. Auto mode is now available by default on Bedrock, Vertex AI, Microsoft Foundry, and signed-in Claude apps gateway sessions for Claude Sonnet 5, Opus 4.7, Opus 4.8, and Fable 5 (and Opus 5 from v2.1.219) — no flag or env var needed. Administrators can disable it with `disableAutoMode` in managed settings. `CLAUDE_CODE_ENABLE_AUTO_MODE` is still accepted for compatibility but has no effect from v2.1.207 onward. Or set it as the default permission mode: @@ -470,6 +482,8 @@ Auto mode blocks the following by default: | IAM changes | Permission and role modifications | | Force push to main | `git push --force origin main` | +> **More decisions moved to the classifier (v2.1.218)**: The classifier also decides removals targeting the filesystem root or home directory, such as `rm -rf /` and `rm -rf ~`, including when the removal sits inside command or process substitution. Before v2.1.218, the plain forms prompted for approval instead, and the substitution forms prompted in v2.1.208 through v2.1.217. The background-`&` and suspicious-Windows-path checks likewise no longer open permission dialogs — the classifier judges them. + ### Default Allowed Actions | Allowed Action | Example | @@ -771,6 +785,8 @@ done Dynamic workflows let Claude orchestrate tens to hundreds of background [subagents](../04-subagents/README.md) **deterministically** — fan-out, pipelines, and parallel stages encoded in a script rather than left to the model's improvisation. Where a single agent holds one context window, a workflow decomposes a task across many agents and recombines their results. +As of v2.1.219, dynamic workflows default to a **medium size guideline (aim for fewer than 15 agents)**. Pick another size — or unrestricted — via **Dynamic workflow size** in `/config`, or set the `workflowSizeGuideline` key in your settings file. The running-workflow status line shows the active size and points to `/config` for changing it. + ### When to Use Them - **Comprehensive coverage** — audit or review across many files/dimensions in parallel. @@ -880,7 +896,7 @@ Permission modes control what actions Claude can take without explicit approval. | `manual` | Read files only; prompts for all other actions. Renamed from `default` in v2.1.200 — `default` is still accepted as an alias | | `acceptEdits` | Read and edit files; prompts for commands | | `plan` | Read files only (research mode, no edits) | -| `auto` | All actions with background safety classifier checks. Requires an eligible plan, model (Sonnet 5, Opus 4.7/4.8, or Fable 5 on most providers), and provider — see [Auto Mode](#auto-mode) | +| `auto` | All actions with background safety classifier checks. Requires an eligible model (Opus 5, Sonnet 5, Opus 4.7/4.8, or Fable 5 on most providers) and provider — available on all plans, see [Auto Mode](#auto-mode) | | `bypassPermissions` | All actions, no permission checks (dangerous) | | `dontAsk` | Only pre-approved tools execute; all others denied | @@ -888,9 +904,11 @@ Permission modes control what actions Claude can take without explicit approval. Cycle through modes with `Shift+Tab` in the CLI. Set a default with the `--permission-mode` flag or the `permissions.defaultMode` setting. +> **Plan mode defers shell commands to the classifier (v2.1.218)**: When [auto mode](#auto-mode) is available and the `useAutoModeDuringPlan` setting is on — which it is by default — the classifier reviews shell commands during planning instead of prompting you. Approved commands run, and rejected ones are blocked. Plan mode still blocks file writes unconditionally. + As of v2.1.160, even `acceptEdits` prompts before writing shell-startup files (`.zshenv`, `.zlogin`, `.bash_login`, `~/.config/git/`) and code-executing build configs (`.npmrc`, `.yarnrc*`, `bunfig.toml`, `.bazelrc`, `.pre-commit-config.yaml`, `.devcontainer/`, …), which could otherwise lead to unintended command execution. -> **`--dangerously-skip-permissions` extended path coverage (v2.1.121, v2.1.126)**: The `--dangerously-skip-permissions` CLI flag (and equivalent `bypassPermissions` mode) now bypasses prompts for writes to a much broader allowlist — `.claude/skills/`, `.claude/agents/`, `.claude/commands/`, `.claude/`, `.git/`, `.vscode/`, and shell config files. Catastrophic removal commands (`rm -rf /`, etc.) still prompt regardless of mode. Treat the flag as a sharper tool than before; use it only in throwaway sandboxes. +> **`--dangerously-skip-permissions` extended path coverage (v2.1.121, v2.1.126)**: The `--dangerously-skip-permissions` CLI flag (and equivalent `bypassPermissions` mode) now bypasses prompts for writes to a much broader allowlist — `.claude/skills/`, `.claude/agents/`, `.claude/commands/`, `.claude/`, `.git/`, `.vscode/`, and shell config files. Catastrophic removal commands (`rm -rf /`, etc.) still prompt in this mode (in auto mode they are judged by the classifier instead — see [Auto Mode](#auto-mode)). Treat the flag as a sharper tool than before; use it only in throwaway sandboxes. > **Windows shell detection (v2.1.120, v2.1.126)**: Git for Windows / Git Bash is no longer required. When Git Bash is absent, Claude Code uses PowerShell as the shell tool. From v2.1.126 PowerShell is the *primary* shell when the PowerShell tool is enabled, and detection covers PowerShell 7 installed via the Microsoft Store, MSI without PATH, or as a `.NET global tool`. @@ -1971,6 +1989,7 @@ claude --no-sandbox # Disable sandboxing | `sandbox.filesystem.denyRead` | Paths denied for read access | | `sandbox.network.allowedDomains` | Domains Bash-launched processes are allowed to reach (supports `*.` wildcard) | | `sandbox.network.deniedDomains` | Domains to block even when `allowedDomains` wildcard would otherwise permit them (v2.1.113+) | +| `sandbox.network.strictAllowlist` | (v2.1.219) Deny non-allowlisted hosts for sandboxed commands without prompting | | `sandbox.enableWeakerNetworkIsolation` | Enable weaker network isolation on macOS | | `sandbox.bwrapPath` | (v2.1.133+, Linux/WSL) Path to the `bubblewrap` binary. Default: `$PATH` lookup. | | `sandbox.socatPath` | (v2.1.133+, Linux/WSL) Path to the `socat` binary. Default: `$PATH` lookup. | @@ -2069,6 +2088,7 @@ Since v2.1.83, administrators can deploy multiple managed settings files into a | `enforceAvailableModels` | (v2.1.175) When `true`, the `availableModels` allowlist *also* constrains the **Default** model — if the configured default is not in the list, Claude Code falls back to the first allowed model. User and project settings can no longer widen a managed `availableModels` list. | | `allowedChannelPlugins` | Control which channel plugins are permitted | | `autoMode.environment` | Configure trusted infrastructure for auto mode | +| `workflowSizeGuideline` | (v2.1.219) Set the advisory [dynamic workflow size guideline](#dynamic-workflows). Readable from any settings file, not just managed settings; while one sets it, the **Dynamic workflow size** row is hidden from `/config` | | `wslInheritsWindowsSettings` | Windows/WSL only (v2.1.118+): when `true`, Claude Code running inside WSL inherits managed settings from the Windows host, so enterprise policies deployed via Registry/MDM apply uniformly across the Windows and WSL shells | | `parentSettingsBehavior` | (v2.1.133+, admin-tier) Controls how the SDK's `managedSettings` merges with parent-process settings. `"first-wins"` keeps existing precedence (earlier setting wins on conflict); `"merge"` deep-merges values. | | Custom policies | Organization-specific permission and tool policies | @@ -2195,7 +2215,7 @@ export ANTHROPIC_API_KEY=sk-ant-... # Thinking configuration export MAX_THINKING_TOKENS=16000 -export CLAUDE_CODE_EFFORT_LEVEL=high # low, medium, high, xhigh (Opus 4.8/4.7), or max — default is high on Opus 4.8 (supported on Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6) +export CLAUDE_CODE_EFFORT_LEVEL=high # low, medium, high, xhigh (Opus 5/4.8/4.7), or max — default is high on Opus 5 and Opus 4.8 (supported on Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6) # Feature toggles export CLAUDE_CODE_DISABLE_AUTO_MEMORY=true @@ -2272,6 +2292,7 @@ The `/config` command provides an interactive menu to toggle settings such as: - Verbose output - Permission mode - Model selection +- Dynamic workflow size (v2.1.219) — hidden when `workflowSizeGuideline` is set in a settings file, see [Dynamic Workflows](#dynamic-workflows) In the interactive menu, press Enter or Space to change the selected setting, and Esc to save and close (v2.1.183+). @@ -2426,8 +2447,11 @@ For more information about Claude Code and related features: --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/settings - https://code.claude.com/docs/en/sandboxing +- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md +- https://code.claude.com/docs/en/model-config +- https://code.claude.com/docs/en/permission-modes diff --git a/09-advanced-features/planning-mode-examples.md b/09-advanced-features/planning-mode-examples.md index ca998f7..dfa844a 100644 --- a/09-advanced-features/planning-mode-examples.md +++ b/09-advanced-features/planning-mode-examples.md @@ -533,9 +533,10 @@ Proceed with this plan? (yes/no/modify) 7. **Plan for testing** at each phase --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/changelog - https://code.claude.com/docs/en/best-practices -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/10-cli/README.md b/10-cli/README.md index 83c4e42..52e79b7 100644 --- a/10-cli/README.md +++ b/10-cli/README.md @@ -137,7 +137,7 @@ claude -p "list todos" | grep "URGENT" ### Model Selection Examples ```bash -# Use Opus 4.8 for complex tasks +# Use Opus 5 for complex tasks claude --model opus "design a caching strategy" # Use Haiku 4.5 for quick tasks @@ -236,6 +236,7 @@ claude --disallowedTools "Bash(rm -rf:*)" "Bash(git push --force:*)" | `--input-format` | Specify input format (print mode) | `text`, `stream-json` | `claude -p --input-format stream-json` | | `--verbose` | Enable verbose logging | | `claude --verbose` | | `--include-partial-messages` | Include streaming events | Requires `stream-json` | `claude -p --output-format stream-json --include-partial-messages "query"` | +| `--forward-subagent-text` | Forward subagent text output into the stream. As of v2.1.219, subagents spawned at depth 2 or deeper are forwarded too, keyed by their spawning `Agent` `tool_use` id (this is how you observe the nesting enabled by default via `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`) | Requires `stream-json` | `claude -p --output-format stream-json --forward-subagent-text "query"` | | `--json-schema` | Get validated JSON matching schema | | `claude -p --json-schema '{"type":"object"}' "query"` | | `--max-budget-usd` | Maximum spend for print mode. Since v2.1.217, hitting the cap also halts running background subagents and denies new spawns (previously background agents kept running past the cap) | | `claude -p --max-budget-usd 5.00 "query"` | @@ -758,8 +759,9 @@ Claude Code supports multiple models with different capabilities: | Model | ID | Context Window | Notes | |-------|-----|----------------|-------| -| Sonnet 5 | `claude-sonnet-5` | 1M tokens | Default on Pro / Team Standard / Enterprise seats (v2.1.197); native 1M-token context window. Opus 4.8 remains the default on Max, Team Premium, Enterprise pay-as-you-go, and the Claude API | -| Opus 4.8 | `claude-opus-4-8` | 1M tokens | Most capable; adaptive effort levels `low → max`; default effort `high` (v2.1.154) | +| Sonnet 5 | `claude-sonnet-5` | 1M tokens | Default on Pro / Team Standard / Enterprise seats (v2.1.197); native 1M-token context window. As of v2.1.219, **Opus 5** is the default Opus model on Max, Team Premium, Enterprise pay-as-you-go, and the Anthropic API; Microsoft Foundry still resolves the `opus` alias to Opus 4.6 | +| Opus 5 | `claude-opus-5` | 1M tokens | Default Opus model on Max, Team Premium, Enterprise pay-as-you-go, Anthropic API, Claude Platform on AWS, Amazon Bedrock, and Google Cloud's Agent Platform (v2.1.219); adaptive effort levels `low → max`, default effort `high` | +| Opus 4.8 | `claude-opus-4-8` | 1M tokens | Previous flagship Opus, still selectable; adaptive effort levels `low → max`; default effort `high` (v2.1.154) | | Sonnet 4.6 | `claude-sonnet-4-6` | 1M tokens | Balanced speed and capability; default effort for Pro/Max subscribers raised from `medium` to `high` in v2.1.117 | | Haiku 4.5 | `claude-haiku-4-5` | 200K tokens | Fastest, best for quick tasks; no effort levels | | Fable 5 | `claude-fable-5` | — | Mythos-class model, made safe for general use (v2.1.170) | @@ -779,11 +781,11 @@ claude --model opusplan "design and implement the API" /fast ``` -> **Fast Mode now runs on Opus 4.8 (v2.1.154)**: As of v2.1.154, `/fast` runs **Opus 4.8** by default as a research preview — about 2× the standard rate for ~2.5× the output speed. It previously flipped from Opus 4.6 to Opus 4.7 in v2.1.142. The `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` env var was **deprecated in v2.1.154 and removed on 2026-06-01**; to use fast mode on Opus 4.6 now, run `/model claude-opus-4-6[1m]` then `/fast on`. +> **Fast Mode runs on Opus 5 and Opus 4.8 (v2.1.219)**: As of v2.1.219, `/fast` applies to **Opus 5 and Opus 4.8** — Opus 4.7 was removed from fast mode. Opus 5's fast mode is billed at $10/$50 per Mtok. Fast mode first moved to Opus 4.8 in v2.1.154 (about 2× the standard rate for ~2.5× the output speed), having flipped from Opus 4.6 to Opus 4.7 in v2.1.142. The `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` env var was **deprecated in v2.1.154 and removed on 2026-06-01**; fast mode is no longer available on Opus 4.6 — select Opus 5 or Opus 4.8 instead. -### Effort Levels (Opus 4.8 / Opus 4.7) +### Effort Levels (Opus 5 / Sonnet 5 / Opus 4.8 / Opus 4.7) -Opus 4.8 and Opus 4.7 support adaptive reasoning with effort levels, ordered from lightest to heaviest: `low` (○), `medium` (◐), `high` (●), `xhigh`, and `max`. The **default** is `high` on Opus 4.8 (since v2.1.154), Opus 4.6, and Sonnet 4.6, and `xhigh` on Opus 4.7. `xhigh` is available on Opus 4.8 and Opus 4.7; `max` works on Opus 4.8/4.7/4.6 and Sonnet 4.6 (session-only). Haiku 4.5 has no effort levels. On Opus 4.6 / Sonnet 4.6, the default effort for Pro/Max subscribers was raised from `medium` to `high` in v2.1.117. +Opus 5, Sonnet 5, Opus 4.8, and Opus 4.7 support adaptive reasoning with effort levels, ordered from lightest to heaviest: `low` (○), `medium` (◐), `high` (●), `xhigh`, and `max`. The **default** is `high` on Opus 5, Sonnet 5, Opus 4.8 (since v2.1.154), Opus 4.6, and Sonnet 4.6, and `xhigh` on Opus 4.7. `xhigh` is available on Opus 5, Sonnet 5, Opus 4.8, and Opus 4.7; `max` works on Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 and Sonnet 4.6 (session-only). Haiku 4.5 has no effort levels. On Opus 4.6 / Sonnet 4.6, the default effort for Pro/Max subscribers was raised from `medium` to `high` in v2.1.117. ```bash # Set effort level via CLI flag @@ -793,7 +795,7 @@ claude --effort high "complex review" /effort high # Set effort level via environment variable -export CLAUDE_CODE_EFFORT_LEVEL=high # low, medium, high, xhigh (Opus 4.8/4.7), or max — default is high on Opus 4.8 +export CLAUDE_CODE_EFFORT_LEVEL=high # low, medium, high, xhigh (Opus 5, Sonnet 5, Opus 4.8/4.7), or max — default is high on Opus 5 ``` The "ultrathink" keyword in prompts activates deep reasoning. The `/effort` menu also offers `ultracode`, which is **not** a model effort level — it sends `xhigh` and has Claude orchestrate dynamic workflows (session-only). @@ -811,7 +813,7 @@ The "ultrathink" keyword in prompts activates deep reasoning. The `/effort` menu | `ANTHROPIC_DEFAULT_SONNET_MODEL` | Override default Sonnet model ID | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Override default Haiku model ID | | `MAX_THINKING_TOKENS` | Set extended thinking token budget | -| `CLAUDE_CODE_EFFORT_LEVEL` | Set effort level (`low`/`medium`/`high`/`xhigh`/`max`) — default is `high` on Opus 4.8 (`xhigh` on Opus 4.7); `xhigh` needs Opus 4.8/4.7; `max` works on Opus 4.8/4.7/4.6 and Sonnet 4.6 | +| `CLAUDE_CODE_EFFORT_LEVEL` | Set effort level (`low`/`medium`/`high`/`xhigh`/`max`) — default is `high` on Opus 5, Sonnet 5, and Opus 4.8 (`xhigh` on Opus 4.7); `xhigh` needs Opus 5, Sonnet 5, or Opus 4.8/4.7; `max` works on Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 and Sonnet 4.6 | | `CLAUDE_CODE_SIMPLE` | Minimal mode, set by `--bare` flag | | `CLAUDE_CODE_SAFE_MODE` | Set to `1` to start with all customizations disabled (CLAUDE.md, plugins, skills, hooks, MCP) — env-var form of `--safe-mode`, for isolating config problems (v2.1.169) | | `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Set to `1` to hide the bundled skills, workflows, and commands from the model (v2.1.169) | @@ -851,11 +853,11 @@ The "ultrathink" keyword in prompts activates deep reasoning. The `/effort` menu | `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Set to `1` to force synchronous output for terminals where auto-detection misses (e.g., Emacs `eat`) (v2.1.129+) | | `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Set to `1` to enable background upgrades for Homebrew/WinGet installs (which normally do not auto-update) (v2.1.129+) | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Set to `1` to opt in to gateway `/v1/models` discovery when `ANTHROPIC_BASE_URL` is set. Without it, `/model` shows the built-in static list (v2.1.129+) | -| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Legacy opt-in for auto mode on Bedrock, Vertex, and Foundry (v2.1.158–v2.1.206). As of v2.1.207, auto mode is available by default on those providers for Sonnet 5, Opus 4.7/4.8, and Fable 5 — this variable is accepted for compatibility but has no effect | +| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Legacy opt-in for auto mode on Bedrock, Vertex, and Foundry (v2.1.158–v2.1.206). As of v2.1.207, auto mode is available by default on those providers for Sonnet 5, Opus 4.7/4.8, and Fable 5 (Opus 5 added in v2.1.219) — this variable is accepted for compatibility but has no effect | | `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Cap on WebSearch tool calls per session, to stop runaway search loops. Default 200 (v2.1.212) | | `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Cap on subagent spawns per session, to stop runaway delegation loops. Default 200; `/clear` resets the budget (v2.1.212) | | `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Cap on subagents running concurrently. Default 20 (v2.1.217) | -| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Controls how deep nested subagent spawns can go. Nesting is now off by default; set this to opt back in to deeper nesting (v2.1.217) | +| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Controls how deep nested subagent spawns can go. Since v2.1.219 the default is **3 layers** (was 1); set to `1` to disable nesting entirely | | `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Threshold, in milliseconds, before a long-running MCP tool call auto-backgrounds. Default 120000 (2 minutes) (v2.1.212) | | `CLAUDE_AX_SCREEN_READER` | Set to `1` to enable plain-text screen reader rendering mode. Same effect as `--ax-screen-reader` or `"axScreenReader": true` in settings (v2.1.208) | | `CLAUDE_CLIENT_PRESENCE_FILE` | Point at a marker file to suppress mobile push notifications while you're at the machine (v2.1.181+). Note: the name is `CLAUDE_CLIENT_PRESENCE_FILE`, not `CLAUDE_CODE_CLIENT_PRESENCE_FILE`. | @@ -863,7 +865,7 @@ The "ultrathink" keyword in prompts activates deep reasoning. The `/effort` menu | `CLAUDE_CODE_RETRY_WATCHDOG` | Retry control recommended for unattended sessions, as an alternative to raising `CLAUDE_CODE_MAX_RETRIES` (v2.1.186+). | | `CLAUDE_ENABLE_STREAM_WATCHDOG` | Streaming idle watchdog (aborts/retries after 5 min with no stream events) is on by default for all providers; set to `0` to disable (v2.1.196). | | `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Override the 5-minute idle abort for remote MCP tool calls that hang with no response (v2.1.187+). | -| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | **Removed (no-op as of v2.1.160).** Previously pinned Fast Mode (`/fast`) to Opus 4.6. To use fast mode on Opus 4.6 now, run `/model claude-opus-4-6[1m]` then `/fast on`. | +| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | **Removed (no-op as of v2.1.160).** Previously pinned Fast Mode (`/fast`) to Opus 4.6. As of v2.1.219, `/fast` applies to **Opus 5 and Opus 4.8** only — Opus 4.6 and Opus 4.7 are no longer fast-mode targets. | > **`ENABLE_TOOL_SEARCH` on Vertex AI (v2.1.119+)**: Tool search is **disabled by default on Google Cloud Vertex AI** deployments. Users who want the tool-search capability on Vertex must explicitly opt in with `export ENABLE_TOOL_SEARCH=true`. On direct Anthropic API it remains enabled by default. @@ -881,6 +883,7 @@ These keys live in a `settings.json` file (`~/.claude/settings.json` for user sc | `language` | Sets Claude's preferred response language and voice-dictation language (e.g. `"french"`, `"japanese"`). As of **v2.1.176** it also pins the language used for auto-generated session titles. | | `sandbox.filesystem.disabled` | (v2.1.216) Skips filesystem sandboxing while keeping network egress control enforced. For workflows where file sandboxing breaks tooling but network policy must stay enforced. | | `emojiCompletionEnabled` | (v2.1.217) Enables emoji shortcode autocomplete in the prompt input (e.g. typing `:heart:` inserts ❤️). Set `false` to disable. | +| `workflowSizeGuideline` | (v2.1.219) Sets the advisory Dynamic workflow size guideline from any settings file. The guideline is guidance Claude aims for, not a hard cap — the default is medium (aim for fewer than 15 agents), and other sizes or unrestricted can be selected. While this key is set, the "Dynamic workflow size" row is hidden in `/config`. Distinct from `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`, which is an enforced concurrency limit. | ```json { @@ -994,8 +997,8 @@ claude -p --output-format json "query" --- -**Last Updated**: July 22, 2026 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/cli-reference - https://code.claude.com/docs/en/env-vars @@ -1004,7 +1007,6 @@ claude -p --output-format json "query" - https://code.claude.com/docs/en/changelog - https://code.claude.com/docs/en/settings - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md -- https://docs.anthropic.com/en/docs/claude-code/cli-reference - https://code.claude.com/docs/en/troubleshooting - https://code.claude.com/docs/en/slash-commands - https://code.claude.com/docs/en/model-config @@ -1016,4 +1018,6 @@ claude -p --output-format json "query" - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/overview -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/sub-agents +- https://code.claude.com/docs/en/headless +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/CATALOG.md b/CATALOG.md index 8e5af03..f8402c2 100644 --- a/CATALOG.md +++ b/CATALOG.md @@ -7,7 +7,7 @@ > Quick reference guide to all Claude Code features: commands, agents, skills, plugins, and hooks. -**Navigation**: [Commands](#slash-commands) | [Permission Modes](#permission-modes) | [Subagents](#subagents) | [Skills](#skills) | [Plugins](#plugins) | [MCP Servers](#mcp-servers) | [Hooks](#hooks) | [Memory](#memory-files) | [New Features](#new-features-may-2026) +**Navigation**: [Commands](#slash-commands) | [Permission Modes](#permission-modes) | [Subagents](#subagents) | [Skills](#skills) | [Plugins](#plugins) | [MCP Servers](#mcp-servers) | [Hooks](#hooks) | [Memory](#memory-files) | [New Features](#new-features) --- @@ -88,7 +88,7 @@ Commands are user-invoked shortcuts that execute specific actions. | `/stats` | Shortcut alias that opens the stats tab of `/usage` (v2.1.118+) | Review session metrics | | `/statusline` | Configure status line | Customize status display | | `/stickers` | View session stickers | Fun rewards | -| `/fast` | Toggle fast output mode | Speed up responses | +| `/fast` | Toggle fast output mode; applies to **Opus 5 and Opus 4.8** (v2.1.219) | Speed up responses | | `/terminal-setup` | Configure terminal integration | Setup terminal features | | `/undo` | Alias for `/rewind` (v2.1.108) | Same as `/rewind` | | `/upgrade` | Check for updates | Version management | @@ -144,7 +144,7 @@ Claude Code supports 6 permission modes that control how tool use is authorized. Specialized AI assistants with isolated contexts for specific tasks. -> **Nested spawning is opt-in (v2.1.217)**: As of v2.1.217, subagents do not spawn their own subagents by default. Set `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` to allow nesting, up to the depth you configure. (From v2.1.172 through v2.1.216, subagents nested by default, up to 5 levels deep; v2.1.217 made that opt-in.) See [04-subagents/README.md](04-subagents/README.md#restrict-spawnable-subagents) for the `Agent(agent_type)` syntax that restricts which subagents a given subagent may spawn. +> **Nested spawning is on by default, depth 3 (v2.1.219)**: Subagents can spawn their own subagents up to three layers below the main conversation. Set `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` to change the limit, or `1` to disable nesting. (History: v2.1.172–v2.1.216 nested by default up to 5 layers with no way to change it; v2.1.217 made nesting opt-in at depth 1; v2.1.219 set the default to 3.) See [04-subagents/README.md](04-subagents/README.md#restrict-spawnable-subagents) for the `Agent(agent_type)` syntax that restricts which subagents a given subagent may spawn. ### Built-in Subagents @@ -250,7 +250,7 @@ cp -r 03-skills/* ~/.claude/skills/ | `/loop` | Run prompts on interval | Recurring tasks | | `/run` *(v2.1.145+)* | Launch this project's app to see a change running | Verifying a change in the real app | | `/run-skill-generator` *(v2.1.145+)* | Teach `/run`/`/verify` how to handle a specific project | First-time project setup for `/run` | -| `/code-review` | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); pass `--comment` to post findings as inline PR comments | After writing code, before landing a PR | +| `/code-review` | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); pass `--comment` to post findings as inline PR comments. Runs as a **background subagent** since v2.1.218, so review output no longer fills the conversation and stacked slash commands remain its review target | After writing code, before landing a PR | | `/simplify` *(distinct again since v2.1.154)* | Cleanup-only review (reuse / simplification / efficiency / altitude) that applies the fixes; does not hunt bugs | Tidying code without a bug hunt | | `/verify` *(v2.1.145+)* | Build, run, and observe the app to confirm a fix works | Validating a fix end-to-end | @@ -451,7 +451,7 @@ cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md --- -## New Features (May 2026) +## New Features | Feature | Description | How to Use | |---------|-------------|------------| @@ -485,7 +485,7 @@ cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md | **Plugin LSP Support** | Language Server Protocol integration via plugins | Configure LSP servers in `plugin.json` for editor features | | **Managed Drop-ins** | Organization-managed drop-in configurations (v2.1.83) | Admin-configured via managed policies; auto-applied to all users | | **`claude plugin init`** | Scaffold a new plugin in `.claude/skills`; such plugins auto-load with no marketplace (v2.1.157) | Run `claude plugin init ` | -| **Auto Mode on Bedrock/Vertex/Foundry** | Auto mode available on third-party providers for Opus 4.7/4.8 — opt-in (v2.1.158) | Set `CLAUDE_CODE_ENABLE_AUTO_MODE=1` | +| **Auto Mode on third-party providers** | Available by default on Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, and signed-in Claude apps gateway sessions, where the supported models are Claude Sonnet 5, Opus 4.7 or later (which includes Opus 5), and Fable 5 (opt-in required v2.1.158–v2.1.206; removed in v2.1.207 — `CLAUDE_CODE_ENABLE_AUTO_MODE` is still accepted but has no effect) | `Shift+Tab` to cycle to it, or `--permission-mode auto` | --- @@ -545,8 +545,8 @@ chmod +x ~/.claude/hooks/*.sh --- -**Last Updated**: July 22, 2026 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/sub-agents - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md @@ -560,4 +560,6 @@ chmod +x ~/.claude/hooks/*.sh - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/cli-reference -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +- https://code.claude.com/docs/en/skills +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/CHANGELOG.md b/CHANGELOG.md index d0c08b1..a353478 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,112 @@ # Changelog +## [v2.1.220] — 2026-07-29 + +### Synced to Claude Code v2.1.220 + +Bumps tutorial coverage from the v2.1.217 baseline (2026-07-22 sync) to +v2.1.220 — three contiguous releases (v2.1.218, v2.1.219, v2.1.220), no gaps. +v2.1.219 drives most of this sync: it added Claude Opus 5 and reversed the +nested-subagent default that the previous sync had just documented. + +### Fixed + +- **Nested-subagent default reversed again (v2.1.219)** — five locations across + `04-subagents/README.md`, `CATALOG.md`, `10-cli/README.md`, and + `QUICK_REFERENCE.md` stated that nested spawning is disabled by default. That + was correct for v2.1.217–v2.1.218 only. v2.1.219 sets the default to **depth + 3**; `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1` now *disables* nesting rather + than enabling it. All five now lead with current behavior and carry an + identical three-era history note (v2.1.172–v2.1.216 nested by default up to 5 + layers with no way to change it; v2.1.217 made nesting opt-in at depth 1; + v2.1.219 set the default to 3) so the next reversal degrades gracefully. +- **Opus 4.8 named as the default Opus model** — `10-cli/README.md` stated + "Opus 4.8 remains the default on Max, Team Premium, Enterprise pay-as-you-go, + and the Claude API". As of v2.1.219 that is **Claude Opus 5** + (`claude-opus-5`, 1M context, default effort `high`), which was absent from + every model table in the repo. Added to the `10-cli` and + `claude_concepts_guide.md` model tables and to all 18 `Compatible Models` + footers, plus ~20 effort-level enumerations. Microsoft Foundry still resolves + the `opus` alias to Opus 4.6. +- **Fast-mode model list** — `/fast` now applies to **Opus 5 and Opus 4.8**; + Opus 4.7 was removed (v2.1.219). Also corrected a present-tense instruction + for enabling fast mode on Opus 4.6 in `10-cli/README.md`. +- **Auto-mode eligibility self-contradiction** — `09-advanced-features/README.md` + said both "available on all plans" and "Team, Enterprise, or API" / + "Anthropic API only". Rewritten to the four documented requirements + (Plan / Organization / Model / Provider). Auto mode is available on **all + plans**, default-on for Team/Enterprise with an administrator opt-*out* via + `permissions.disableAutoMode` — the file previously described an Owner + opt-*in*. +- **Stale auto-mode opt-in instruction** — `CATALOG.md` still told users to set + `CLAUDE_CODE_ENABLE_AUTO_MODE=1` on third-party providers. That requirement + was removed in v2.1.207; the variable is accepted for compatibility but has + no effect. +- **Hook-event count disagreement** — `LEARNING-ROADMAP.md` and + `claude_concepts_guide.md` said 29 while `06-hooks/README.md` said 30 (now + 31). Aligned both to 31. `claude_concepts_guide.md`'s named event table was + also missing `MessageDisplay` (a pre-existing gap from v2.1.152) alongside + the new `DirectoryAdded`; its event list is now identical to `06-hooks`. +- **`doc-generator` skill name mismatch** — `03-skills/doc-generator/SKILL.md` + declared `name: api-documentation-generator` while living in `doc-generator/`, + contradicting every catalog and index entry. Renamed in the English copy and + mirrored to `ja/`, `zh/`, `uk/`. +- **Stale "New Features (May 2026)" headings** — retitled in `CATALOG.md` and + `resources.md` to date-free headings that cannot go stale again, with the + `CATALOG.md` navigation anchor updated to match. +- **Legacy `docs.anthropic.com` links** — the three remaining footer links in + `01-slash-commands/README.md`, `05-mcp/README.md`, and `10-cli/README.md` + migrated to `code.claude.com`. +- **Skill example shadowing a built-in** — `03-skills/README.md` used + `name: deep-research` as a custom-skill example, which now shadows the + built-in `/deep-research`. Renamed to `topic-research` and mirrored to + `vi/`, `ja/`, `uk/`. + +### Added + +- **`DirectoryAdded` hook (v2.1.219)** — fires after `/add-dir` or the SDK + `register_repo_root` control request registers a new working directory + mid-session. Added to the `06-hooks/README.md` events table (count 30 → 31). +- **`/deep-research` is explicit-invocation only (v2.1.218)** — Claude no + longer launches it on its own. Added to the bundled-skills table. +- **`/code-review` runs as a background subagent (v2.1.218)** — review work no + longer fills the conversation, and stacked slash commands remain its review + target. Documented in `03-skills/README.md` and `CATALOG.md`. +- **Fork skills run in the background by default (v2.1.218)** — skills with + `context: fork` default to `background: true`; set `false` to opt out. Added + a `background` frontmatter row, a matching YAML sample line, and an explicit + statement of the default so it doesn't read as contradicting + `04-subagents`, where `background: true` *forces* background. +- **Agent frontmatter hooks require workspace trust (v2.1.218)** — hooks in a + project subagent run only after the folder the agent file came from has + accepted workspace trust. +- **Dynamic workflow size guideline (v2.1.219)** — workflows now default to a + medium guideline (aim for fewer than 15 agents), selectable via **Dynamic + workflow size** in `/config` or the new `workflowSizeGuideline` settings key. +- **`sandbox.network.strictAllowlist` (v2.1.219)** — denies non-allowlisted + hosts for sandboxed commands without prompting. +- **MCP error surfacing (v2.1.219)** — `claude mcp list` and `/mcp` now report + HTTP status and error text on connection failure; hidden leading/trailing + whitespace in config values is warned about; headless runs expose + `mcp_server_errors` in the stream-json init event. Added as troubleshooting + guidance in `05-mcp/README.md`. +- **Nested subagent forwarding in stream-json (v2.1.219)** — subagents at depth + 2+ now appear when `--forward-subagent-text` is set, keyed by their spawning + `Agent` `tool_use` id. +- **Frontmatter booleans accept more values (v2.1.218)** — `yes`/`no`, + `on`/`off`, `1`/`0`, case-insensitive, alongside `true`/`false`. +- **Agent names reject `:` (v2.1.218)** — reserved for plugin namespacing. +- **Auto and plan mode defer more to the classifier (v2.1.218)** — `rm -rf /` + and `rm -rf ~` (including inside command/process substitution) are now + adjudicated by the classifier rather than opening a permission dialog, and + plan mode with auto no longer prompts for Bash commands the static analyzer + can't prove read-only (`useAutoModeDuringPlan`, on by default). +- **Opus 5 safety-classifier fallback (v2.1.219)** — cybersecurity-flagged + requests re-run on Opus 4.8; biology-flagged requests end in a refusal, since + Opus 5 runs its own biology classifiers with no fallback. Relevant to readers + using this repo's security-review subagent and plugin templates, as + pentest/CTF workloads trigger it frequently. + ## [v2.1.217] — 2026-07-22 ### Synced to Claude Code v2.1.217 diff --git a/INDEX.md b/INDEX.md index 79c25e3..e282af5 100644 --- a/INDEX.md +++ b/INDEX.md @@ -396,6 +396,7 @@ Advanced capabilities for complex workflows. - Deterministic orchestration of tens-to-hundreds of background subagents - Fan-out / pipeline / parallel stages for comprehensive coverage - View runs with `/workflows`; `ultracode` `/effort` turns it on for a session +- Default size guideline is medium (aim for fewer than 15 agents) as of v2.1.219 — change it with **Dynamic workflow size** in `/config` ### Permission Modes - **manual**: Ask for approval on risky actions (renamed from `default` in v2.1.200; `default` still accepted) @@ -465,7 +466,7 @@ Command-line interface usage patterns and reference. - `claude` - Start interactive session - `claude -p "prompt"` - Headless/non-interactive mode - `claude web` - Launch web session -- `claude --model` - Select model (Sonnet 4.6, Opus 4.8, Haiku 4.5) +- `claude --model` - Select model (Opus 5, Sonnet 5, Sonnet 4.6, Opus 4.8, Haiku 4.5) - `claude --permission-mode` - Set permission mode - `claude --remote` - Enable remote control via WebSocket @@ -880,8 +881,8 @@ Want to add more examples? Follow the structure: --- -**Last Updated**: July 18, 2026 -**Claude Code Version**: 2.1.212 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks @@ -889,7 +890,9 @@ Want to add more examples? Follow the structure: - https://code.claude.com/docs/en/permission-modes - https://github.com/anthropics/claude-code/releases/tag/v2.1.153 - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 **Total Examples**: 100+ files **Categories**: 10 features **Hooks**: 9 automation scripts diff --git a/LEARNING-ROADMAP.md b/LEARNING-ROADMAP.md index 55f2c6b..3715794 100644 --- a/LEARNING-ROADMAP.md +++ b/LEARNING-ROADMAP.md @@ -102,7 +102,7 @@ graph TD | **3** | [Checkpoints](08-checkpoints/) | ⭐⭐ Intermediate | 45 min | Level 1 | Session management | Safe exploration | Experimentation, recovery | | **4** | [CLI Basics](10-cli/) | ⭐⭐ Beginner+ | 30 min | Level 1 | None | Core CLI usage | Interactive & print mode | | **5** | [Skills](03-skills/) | ⭐⭐ Intermediate | 1 hour | Level 2 | Slash Commands | Automatic expertise | Reusable capabilities, consistency | -| **6** | [Hooks](06-hooks/) | ⭐⭐ Intermediate | 1 hour | Level 2 | Tools, Commands | Workflow automation (29 events, 5 types) | Validation, quality gates | +| **6** | [Hooks](06-hooks/) | ⭐⭐ Intermediate | 1 hour | Level 2 | Tools, Commands | Workflow automation (31 events, 5 types) | Validation, quality gates | | **7** | [MCP](05-mcp/) | ⭐⭐⭐ Intermediate+ | 1 hour | Level 2 | Configuration | Live data access | Real-time integration, APIs | | **8** | [Subagents](04-subagents/) | ⭐⭐⭐ Intermediate+ | 1.5 hours | Level 2 | Memory, Commands | Complex task handling (6 built-in including Bash) | Delegation, specialized expertise | | **9** | [Advanced Features](09-advanced-features/) | ⭐⭐⭐⭐⭐ Advanced | 2-3 hours | Level 3 | All previous | Power user tools | Planning, Auto Mode, Channels, Voice Dictation, permissions | @@ -235,7 +235,7 @@ Before starting Level 2, make sure you're comfortable with these Level 1 concept #### What You'll Achieve ✅ Auto-invoke specialized capabilities with YAML frontmatter (including `effort` and `shell` fields) -✅ Set up event-driven automation across 29 hook events +✅ Set up event-driven automation across 31 hook events ✅ Use all 5 hook types (command, http, mcp_tool, prompt, agent) ✅ Enforce code quality standards ✅ Create custom hooks for your workflow @@ -738,15 +738,16 @@ Once you've completed all milestones: --- -**Last Updated**: July 11, 2026 -**Claude Code Version**: 2.1.206 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks - https://code.claude.com/docs/en/permission-modes - https://github.com/anthropics/claude-code/releases/tag/v2.1.144 - https://github.com/anthropics/claude-code/releases/tag/v2.1.145 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 **Maintained by**: Claude How-To Contributors **License**: Educational purposes, free to use and adapt diff --git a/QUICK_REFERENCE.md b/QUICK_REFERENCE.md index 4f575ab..c96ba9b 100644 --- a/QUICK_REFERENCE.md +++ b/QUICK_REFERENCE.md @@ -399,9 +399,9 @@ cp -r 03-skills/code-review-specialist ~/.claude/skills/ | **Task List** | Manage background tasks | `/task list`, `/task status ` | | **Auto Memory** | Automatic memory saving from conversations | Claude auto-saves key context to CLAUDE.md | | **Git Worktrees** | Isolated workspaces for parallel development | `/worktree` to create isolated workspace | -| **Model Selection** | Switch between Sonnet 4.6, Opus 4.8, and Haiku 4.5 | `/model` — since v2.1.153 the choice is saved as the default for new sessions; press `s` for session-only | +| **Model Selection** | Switch between Opus 5, Sonnet 5, Sonnet 4.6, Opus 4.8, and Haiku 4.5 | `/model` — since v2.1.153 the choice is saved as the default for new sessions; press `s` for session-only | | **Agent Teams** | Coordinate multiple agents on tasks | Enable with `CLAUDE_AGENT_TEAMS=1` env var | -| **Dynamic Workflows** *(v2.1.154)* | Deterministic multi-agent orchestration | `/workflows` to view runs; ask Claude to create one | +| **Dynamic Workflows** *(v2.1.154)* | Deterministic multi-agent orchestration; since v2.1.219 the default size guideline is medium (aim for fewer than 15 agents) | `/workflows` to view runs; ask Claude to create one; change the size via **Dynamic workflow size** in `/config` | | **Scheduled Tasks** | Recurring tasks with `/loop` | `/loop 5m /command` or CronCreate tool | | **Chrome Integration** | Browser automation | `--chrome` flag or `/chrome` command | | **Keyboard Customization** | Custom keybindings | `/keybindings` command | @@ -410,7 +410,7 @@ cp -r 03-skills/code-review-specialist ~/.claude/skills/ | **/verify** *(v2.1.145+)* | Build, run, and observe the app to confirm a fix works (explicit invocation only since v2.1.215 — Claude won't trigger this on its own) | `/verify` | | **/run-skill-generator** *(v2.1.145+)* | Teach `/run`/`/verify` how to handle a specific project | `/run-skill-generator` | | **Subagent Output Scanning** *(v2.1.210+)* | Scans subagent reports for prompt-injection patterns and neutralizes them | On by default, no opt-out | -| **Session-Wide Spawn Caps** *(v2.1.212, extended v2.1.217)* | 200/session limits on WebSearch calls and subagent spawns; v2.1.217 added a concurrent-subagent cap (default 20) and turned nested subagent spawning off by default (previously allowed up to 5 levels since v2.1.172) | `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`, `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`, `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` (default 20), `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` (opt back into nesting); `/clear` resets | +| **Session-Wide Spawn Caps** *(v2.1.212, extended v2.1.219)* | 200/session limits on WebSearch calls and subagent spawns; concurrent-subagent cap (default 20) added in v2.1.217; since v2.1.219 subagents can spawn nested subagents up to **depth 3 by default** (v2.1.217 had disabled nesting) | `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`, `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`, `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` (default 20), `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` (default 3; set 1 to disable); `/clear` resets | | **Screen Reader Mode** *(v2.1.208)* | Plain-text rendering mode for screen readers | `--ax-screen-reader` flag, `CLAUDE_AX_SCREEN_READER=1`, or `"axScreenReader": true` in settings | --- @@ -514,9 +514,12 @@ Getting started checklist: --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/cli-reference - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/sub-agents +- https://code.claude.com/docs/en/model-config +- https://code.claude.com/docs/en/settings +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/README.md b/README.md index b64d5c8..c6ad5e8 100644 --- a/README.md +++ b/README.md @@ -210,7 +210,7 @@ The official docs are a feature reference. This guide is a tutorial with diagram 11-13 hours for the full path. But you'll get immediate value in 15 minutes — just copy a slash command template and try it. **Can I use this with Claude Sonnet / Haiku / Opus?** -Yes. All templates work with Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, and Claude Haiku 4.5. +Yes. All templates work with Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, and Claude Haiku 4.5. **Can I contribute?** Absolutely. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. We welcome new examples, bug fixes, documentation improvements, and community templates. @@ -871,8 +871,8 @@ MIT License - see [LICENSE](LICENSE). Free to use, modify, and distribute. The o --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog @@ -880,4 +880,6 @@ MIT License - see [LICENSE](LICENSE). Free to use, modify, and distribute. The o - https://platform.claude.com/docs/en/about-claude/models/overview - https://github.com/anthropics/claude-code/releases - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md index c2a524b..bdc461c 100644 --- a/STYLE_GUIDE.md +++ b/STYLE_GUIDE.md @@ -597,9 +597,9 @@ Lesson READMEs end with a metadata block: ```markdown --- -**Last Updated**: May 29, 2026 -**Claude Code Version**: 2.1.156 -**Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 ``` - Use month + day + year format (e.g., "May 20, 2026") @@ -631,11 +631,11 @@ Before submitting content, verify: --- -**Last Updated**: May 29, 2026 -**Claude Code Version**: 2.1.156 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog -- https://www.anthropic.com/news/claude-opus-4-8 +- https://code.claude.com/docs/en/model-config - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 -**Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/claude_concepts_guide.md b/claude_concepts_guide.md index 12200db..6b2d19b 100644 --- a/claude_concepts_guide.md +++ b/claude_concepts_guide.md @@ -2810,7 +2810,7 @@ Hooks are event-driven shell commands that execute automatically in response to ### Hook Events -Claude Code supports **29 hook events** across five hook types (command, http, mcp_tool, prompt, agent): +Claude Code supports **31 hook events** across five hook types (command, http, mcp_tool, prompt, agent): | Hook Event | Trigger | Use Cases | |------------|---------|-----------| @@ -2826,6 +2826,7 @@ Claude Code supports **29 hook events** across five hook types (command, http, m | **PostToolUseFailure** | Tool execution fails | Error handling, logging | | **PostToolBatch** | After a batch of tool uses completes | Aggregate reporting, batched validation | | **Notification** | Notification sent | Alerting, external integrations | +| **MessageDisplay** | While assistant message text is displayed | Transform or hide displayed message text | | **SubagentStart** | Subagent spawned | Context injection, initialization | | **SubagentStop** | Subagent finishes | Result validation, logging | | **Stop** | Claude finishes responding | Summary generation, cleanup tasks | @@ -2835,6 +2836,7 @@ Claude Code supports **29 hook events** across five hook types (command, http, m | **TaskCreated** | Task created via TaskCreate | Task tracking, logging | | **ConfigChange** | Config file changes | Validation, propagation | | **CwdChanged** | Working directory changes | Directory-specific setup | +| **DirectoryAdded** | New working directory registered mid-session via `/add-dir` or the SDK `register_repo_root` control request | Set up tooling for a newly added directory | | **FileChanged** | Watched file changes | File monitoring, rebuild triggers | | **PreCompact** | Before context compaction | State preservation | | **PostCompact** | After compaction completes | Post-compact actions | @@ -3129,15 +3131,16 @@ Claude Code supports the following models with adaptive reasoning effort: | Model | Context Window | Effort Levels | Default Effort (Claude Code) | |-------|----------------|---------------|------------------------------| -| Claude Sonnet 5 | 1M tokens (native) | `low`, `medium`, `high`, `max` | `high` — default model for Pro/Team Standard/Enterprise since v2.1.197 | +| Claude Opus 5 | 1M tokens (native) | `low`, `medium`, `high`, `xhigh`, `max` | `high` — default Opus model since v2.1.219 (requires Claude Code v2.1.219+) | +| Claude Sonnet 5 | 1M tokens (native) | `low`, `medium`, `high`, `xhigh`, `max` | `high` — default model for Pro/Team Standard/Enterprise since v2.1.197 | | Claude Opus 4.8 | 1M tokens (native) | `low`, `medium`, `high`, `xhigh`, `max` | `high` (since v2.1.154) | | Claude Opus 4.7 (legacy) | 1M tokens (native) | `low`, `medium`, `high`, `xhigh`, `max` | `xhigh` (since Opus 4.7 launch, 2026-04-16) | | Claude Sonnet 4.6 | 1M tokens | `low`, `medium`, `high`, `max` | `high` for Pro/Max subscribers (raised from `medium` in v2.1.117) | | Claude Haiku 4.5 | 200K tokens | — (no effort support) | — | -> **Note**: `xhigh` is available on Opus 4.8 and Opus 4.7; `max` works on Opus 4.8/4.7/4.6 and Sonnet 4.6 (session-only). Haiku 4.5 does not support effort levels. +> **Note**: `xhigh` is available on Opus 5, Sonnet 5, Opus 4.8, and Opus 4.7; `max` works on Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 and Sonnet 4.6 (session-only). Haiku 4.5 does not support effort levels. -> **Note**: v2.1.117 fixed a bug where Opus 4.7 sessions computed `/context` against 200K instead of the native 1M window — upgrade to v2.1.117 or later to actually get the 1M context on Opus 4.7. Opus 4.8 also has a native 1M-token window. +> **Note**: v2.1.117 fixed a bug where Opus 4.7 sessions computed `/context` against 200K instead of the native 1M window — upgrade to v2.1.117 or later to actually get the 1M context on Opus 4.7. Opus 5 and Opus 4.8 also have a native 1M-token window. > **Note**: `/cost` and `/stats` merged into `/usage` in v2.1.118. `/usage` is now the canonical command with tabs for cost/stats/etc.; `/cost` and `/stats` remain as shortcut aliases that open the corresponding tab. As of v2.1.149, the cost view also breaks spending down by category (skills, subagents, plugins, and per-MCP-server costs). @@ -3149,9 +3152,12 @@ Claude Code supports the following models with adaptive reasoning effort: - [Anthropic Cookbook](https://github.com/anthropics/anthropic-cookbook) --- -**Last Updated**: 2026-07-22 -**Claude Code Version**: 2.1.217 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://www.anthropic.com/news/claude-sonnet-5 - https://code.claude.com/docs/en/cli-reference -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md +- https://code.claude.com/docs/en/hooks +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/ja/03-skills/README.md b/ja/03-skills/README.md index 3b69aea..3053fcf 100644 --- a/ja/03-skills/README.md +++ b/ja/03-skills/README.md @@ -313,7 +313,7 @@ agent: Explore ```yaml --- -name: deep-research +name: topic-research description: Research a topic thoroughly context: fork agent: Explore diff --git a/ja/03-skills/doc-generator/SKILL.md b/ja/03-skills/doc-generator/SKILL.md index 0538253..15c66a6 100644 --- a/ja/03-skills/doc-generator/SKILL.md +++ b/ja/03-skills/doc-generator/SKILL.md @@ -3,7 +3,7 @@ --- -name: api-documentation-generator +name: doc-generator description: ソースコードから包括的かつ正確な API ドキュメントを生成する。API ドキュメントの作成・更新、OpenAPI 仕様の生成時、または API ドキュメント、エンドポイント、ドキュメントについて言及がある場合に使用する。 --- diff --git a/resources.md b/resources.md index 381dc44..fbfdde2 100644 --- a/resources.md +++ b/resources.md @@ -228,7 +228,7 @@ These steps capture the core recommendations for smooth workflows with Claude Co --- -## New Features & Capabilities (May 2026) +## New Features & Capabilities ### Key Feature Resources @@ -252,8 +252,8 @@ These steps capture the core recommendations for smooth workflows with Claude Co | **/run, /verify, /run-skill-generator** | Bundled skills to launch your project, confirm a fix works, and generate per-project run/verify skills (v2.1.145+) | [Skills Guide](03-skills/) | --- -**Last Updated**: July 11, 2026 -**Claude Code Version**: 2.1.206 +**Last Updated**: July 29, 2026 +**Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog @@ -261,4 +261,5 @@ These steps capture the core recommendations for smooth workflows with Claude Co - https://code.claude.com/docs/en/permission-modes - https://github.com/anthropics/claude-code/releases/tag/v2.1.144 - https://github.com/anthropics/claude-code/releases/tag/v2.1.145 -**Compatible Models**: Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 +- https://code.claude.com/docs/en/model-config +**Compatible Models**: Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5 diff --git a/uk/03-skills/README.md b/uk/03-skills/README.md index 3790050..0503d1b 100644 --- a/uk/03-skills/README.md +++ b/uk/03-skills/README.md @@ -313,7 +313,7 @@ agent: Explore ```yaml --- -name: deep-research +name: topic-research description: Research a topic thoroughly context: fork agent: Explore diff --git a/uk/03-skills/doc-generator/SKILL.md b/uk/03-skills/doc-generator/SKILL.md index 00c7103..5435f83 100644 --- a/uk/03-skills/doc-generator/SKILL.md +++ b/uk/03-skills/doc-generator/SKILL.md @@ -1,5 +1,5 @@ --- -name: api-documentation-generator +name: doc-generator description: Генерація вичерпної, точної документації API з вихідного коду. Використовуйте при створенні або оновленні документації API, генерації специфікацій OpenAPI, або коли користувачі згадують документацію API, ендпоінти чи документацію. --- diff --git a/vi/03-skills/README.md b/vi/03-skills/README.md index e73761a..a02dee8 100644 --- a/vi/03-skills/README.md +++ b/vi/03-skills/README.md @@ -307,7 +307,7 @@ agent: Explore ```yaml --- -name: deep-research +name: topic-research description: Research a topic thoroughly context: fork agent: Explore diff --git a/zh/03-skills/doc-generator/SKILL.md b/zh/03-skills/doc-generator/SKILL.md index 1a7b067..3f4dcb8 100644 --- a/zh/03-skills/doc-generator/SKILL.md +++ b/zh/03-skills/doc-generator/SKILL.md @@ -1,5 +1,5 @@ --- -name: api-documentation-generator +name: doc-generator description: 从源代码生成全面且准确的 API 文档。适用于创建或更新 API 文档、生成 OpenAPI 规范，或在用户提到 API 文档、端点或说明时使用。 ---