diff --git a/01-slash-commands/README.md b/01-slash-commands/README.md index 3551bd6..4083e57 100644 --- a/01-slash-commands/README.md +++ b/01-slash-commands/README.md @@ -28,7 +28,7 @@ Built-in commands are shortcuts for common actions. There are **60+ built-in com | `/btw ` | Ask an ephemeral side question while Claude is working on the main task; doesn't pollute the main conversation context | | `/chrome` | Configure Chrome browser integration | | `/clear` | Clear conversation (aliases: `/reset`, `/new`) | -| `/color [color\|default]` | Set prompt bar color | +| `/color [color\|default]` | Set prompt bar color. Bare `/color` (no args) picks a random session color (v2.1.128+); pass a color name or hex to set explicitly. | | `/compact [instructions]` | Compact conversation with optional focus instructions | | `/config` | Open Settings (alias: `/settings`) | | `/context` | Visualize context usage as colored grid | @@ -601,8 +601,8 @@ If both exist with the same name, the **skill takes precedence**. Remove one or --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/slash-commands - https://code.claude.com/docs/en/interactive-mode diff --git a/02-memory/README.md b/02-memory/README.md index 4891ac5..cb79331 100644 --- a/02-memory/README.md +++ b/02-memory/README.md @@ -1198,11 +1198,11 @@ For the most up-to-date information, refer to the official Claude Code documenta - [Official Memory Docs](https://code.claude.com/docs/en/memory) - Anthropic documentation --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/memory - https://code.claude.com/docs/en/settings - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/03-skills/README.md b/03-skills/README.md index b3424a7..af3d6a1 100644 --- a/03-skills/README.md +++ b/03-skills/README.md @@ -649,6 +649,27 @@ Skill(deploy *) **Hide individual skills** by adding `disable-model-invocation: true` to their frontmatter. +### Controlling Skill Override Behavior (`skillOverrides`) + +When a project skill and a user skill share the same name, project wins by default. The `skillOverrides` setting (v2.1.129+) lets you tune this. Add it to `~/.claude/settings.json` or project `.claude/settings.json`: + +```json +{ + "skillOverrides": "name-only" +} +``` + +Accepted values: + +| Value | Behavior | +|-------|----------| +| `"on"` (default) | A repo skill can override a user skill of the same name. | +| `"off"` | Disable overriding entirely — user skills always win. | +| `"name-only"` | Match overrides only on skill name (ignore description / source). | +| `"user-invocable-only"` | Only user-invocable skills can be overridden — model-invoked skills always come from their original location. | + +Useful when team policy says "user-defined skills must always take precedence" (`"off"`) or "only allow narrow name-based overrides" (`"name-only"`). + ## Best Practices ### 1. Make Descriptions Specific @@ -823,8 +844,8 @@ Once you start building skills seriously, two things become essential: a library - [Hooks Guide](../06-hooks/) - Event-driven automation --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/skills - https://code.claude.com/docs/en/settings diff --git a/04-subagents/README.md b/04-subagents/README.md index ccb2d4f..bd6dd30 100644 --- a/04-subagents/README.md +++ b/04-subagents/README.md @@ -1217,11 +1217,11 @@ graph TD --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/sub-agents - https://code.claude.com/docs/en/agent-teams - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/05-mcp/README.md b/05-mcp/README.md index 69d1588..8476f02 100644 --- a/05-mcp/README.md +++ b/05-mcp/README.md @@ -194,6 +194,13 @@ sequenceDiagram Claude->>User: ✅ MCP connected! ``` +### `/mcp` command + +Type `/mcp` inside a session to list connected servers, trigger OAuth flows, and inspect connection state. + +- Since **v2.1.121**, MCP retries the initial connection up to 3 times on transient errors. +- Since **v2.1.128**, `/mcp` displays the **tool count** for each connected server and visually flags servers reporting **0 tools** so misconfigured servers stand out at a glance. + ## MCP Tool Search When MCP tool descriptions exceed 10% of the context window, Claude Code automatically enables tool search to efficiently select the right tools without overwhelming the model context. @@ -1132,8 +1139,8 @@ export GITHUB_TOKEN="your_token" --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/mcp - https://code.claude.com/docs/en/changelog diff --git a/06-hooks/README.md b/06-hooks/README.md index 4f1dcda..f318c58 100644 --- a/06-hooks/README.md +++ b/06-hooks/README.md @@ -1366,11 +1366,11 @@ Edit `~/.claude/settings.json` or `.claude/settings.json` with the hook configur --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/hooks - https://code.claude.com/docs/en/changelog - https://github.com/anthropics/claude-code/releases/tag/v2.1.118 -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/07-plugins/README.md b/07-plugins/README.md index b53efa7..1df585e 100644 --- a/07-plugins/README.md +++ b/07-plugins/README.md @@ -688,6 +688,12 @@ claude plugin install plugin-name@marketplace-name # CLI flag for local testing (repeatable for multiple plugins) claude --plugin-dir ./path/to/plugin claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b + +# --plugin-dir also accepts a .zip archive path (v2.1.128+) +claude --plugin-dir ./my-plugin.zip + +# Fetch a plugin .zip archive from a URL for the current session (v2.1.129+, repeatable) +claude --plugin-url https://example.com/releases/my-plugin-0.3.0.zip ``` ### From Git Repository @@ -760,6 +766,12 @@ Before publishing, test your plugin locally using the `--plugin-dir` CLI flag (r ```bash claude --plugin-dir ./my-plugin claude --plugin-dir ./my-plugin --plugin-dir ./another-plugin + +# --plugin-dir accepts .zip archives in addition to directories (v2.1.128+) +claude --plugin-dir ./my-plugin.zip + +# --plugin-url fetches a plugin .zip from a URL for this session (v2.1.129+, repeatable) +claude --plugin-url https://example.com/releases/my-plugin-0.3.0.zip ``` This launches Claude Code with your plugin loaded, allowing you to: @@ -1037,12 +1049,12 @@ The following Claude Code features work together with plugins: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/plugin-marketplaces - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 - https://github.com/anthropics/claude-code/releases/tag/v2.1.118 -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/07-plugins/devops-automation/README.md b/07-plugins/devops-automation/README.md index 7acf8dc..43fe134 100644 --- a/07-plugins/devops-automation/README.md +++ b/07-plugins/devops-automation/README.md @@ -108,9 +108,9 @@ Result: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/plugins -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/07-plugins/documentation/README.md b/07-plugins/documentation/README.md index 1c60a6c..a5b7514 100644 --- a/07-plugins/documentation/README.md +++ b/07-plugins/documentation/README.md @@ -120,9 +120,9 @@ export GITHUB_TOKEN="your_github_token" --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/plugins -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/07-plugins/pr-review/README.md b/07-plugins/pr-review/README.md index 771644e..11f1f82 100644 --- a/07-plugins/pr-review/README.md +++ b/07-plugins/pr-review/README.md @@ -92,9 +92,9 @@ Result: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/plugins -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/08-checkpoints/README.md b/08-checkpoints/README.md index 3ec5c2b..1d571b5 100644 --- a/08-checkpoints/README.md +++ b/08-checkpoints/README.md @@ -325,8 +325,8 @@ Remember: checkpoints are not a replacement for git. Use checkpoints for rapid e --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/checkpointing - https://code.claude.com/docs/en/settings diff --git a/08-checkpoints/checkpoint-examples.md b/08-checkpoints/checkpoint-examples.md index a2f015c..5b5bbd3 100644 --- a/08-checkpoints/checkpoint-examples.md +++ b/08-checkpoints/checkpoint-examples.md @@ -339,4 +339,8 @@ User: Now let's continue with the approach that worked. 6. **Summarize long sessions**: Use "Summarize from here" to keep conversations manageable --- -**Last Updated**: April 9, 2026 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 +**Sources**: +- https://code.claude.com/docs/en/checkpointing +- https://code.claude.com/docs/en/changelog diff --git a/09-advanced-features/README.md b/09-advanced-features/README.md index eba6a81..2b2db04 100644 --- a/09-advanced-features/README.md +++ b/09-advanced-features/README.md @@ -277,7 +277,7 @@ Extended thinking is a deliberate, step-by-step reasoning process where Claude: **Automatic activation**: - Enabled by default for all models (Opus 4.7, Sonnet 4.6, Haiku 4.5) -- Opus 4.7: Adaptive reasoning with effort levels: `low` (○), `medium` (◐), `high` (●), `xhigh` (Opus 4.7 only, default on Claude Code since Opus 4.7 launch, 2026-04-16), `max`. Opus 4.6 and Sonnet 4.6 also support `low`, `medium`, `high`, `max` (no `xhigh`). Opus 4.7 has 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). +- Opus 4.7: Adaptive reasoning with effort levels: `low` (○), `medium` (◐), `high` (●), `xhigh` (Opus 4.7 only, default on Claude Code since Opus 4.7 launch, 2026-04-16), `max`. Opus 4.6 and Sonnet 4.6 also support `low`, `medium`, `high`, `max` (no `xhigh`). Opus 4.7 has 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 @@ -1100,7 +1100,7 @@ Claude Code supports keyboard shortcuts for efficiency. Here's the complete refe | `Ctrl+G` | Edit plan in external editor | | `Ctrl+L` | Clear terminal screen | | `Ctrl+O` | Toggle verbose output (view reasoning) | -| `Ctrl+R` | Reverse search history | +| `Ctrl+R` | Reverse search history. Defaults to **all prompts across all projects** (v2.1.129+); press `Ctrl+S` inside the picker to narrow to the current project. Earlier versions defaulted to project-only. | | `Ctrl+T` | Toggle task list view | | `Ctrl+B` | Background running tasks | | `Esc+Esc` | Rewind code/conversation | @@ -1370,6 +1370,8 @@ Customize the push-to-talk keybinding in your keybindings file (`/keybindings`). Channels is a Research Preview feature that pushes events from external services into a running Claude Code session via MCP servers. Sources include Telegram, Discord, iMessage, and arbitrary webhooks, allowing Claude to react to real-time notifications without polling. +> **Auth (v2.1.128+)**: `--channels` now works with both Pro/Max OAuth **and** API-key (console) authentication. Earlier releases required OAuth. + ### Subscribing to Channels ```bash @@ -1539,6 +1541,18 @@ To enable: Push notifications require a Claude subscription and the Claude mobile app. +### Disabling Remote Control (`disableRemoteControl`, v2.1.128+) + +Admins on Team or Enterprise plans can block Remote Control entirely with the `disableRemoteControl` setting. When `true`, both `claude remote-control` and `/remote-control` refuse to start. + +```json +{ + "disableRemoteControl": true +} +``` + +The setting is honored at the **managed/policy** scope (e.g., `/Library/Application Support/ClaudeCode/managed-settings.json` on macOS) so it cannot be overridden by individual users. Useful when local-only execution must be enforced organization-wide. + --- ## Web Sessions @@ -2007,9 +2021,16 @@ export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80 export CLAUDE_STREAM_IDLE_TIMEOUT_MS=30000 export ANTHROPIC_CUSTOM_MODEL_OPTION=my-custom-model export SLASH_COMMAND_TOOL_CHAR_BUDGET=50000 + +# Output and package manager (v2.1.129+) +export CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 # Force synchronous output for terminals where auto-detect misses (Emacs eat, etc.) +export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 # Enable background upgrades for Homebrew/WinGet installs +export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 # Opt in to /v1/models gateway discovery when ANTHROPIC_BASE_URL is set ``` -> **v2.1.108**: `ENABLE_PROMPT_CACHING_1H=1` — use a 1-hour prompt cache TTL instead of the default 5-minute TTL. Reduces cache misses in long, stable sessions. +> **v2.1.108**: `ENABLE_PROMPT_CACHING_1H=1` — use a 1-hour prompt cache TTL instead of the default 5-minute TTL. Reduces cache misses in long, stable sessions. (v2.1.129 fixes a regression where the 1-hour TTL was silently downgraded to 5 minutes.) + +> **v2.1.129**: `CLAUDE_CODE_FORCE_SYNC_OUTPUT=1` forces synchronous output for terminals whose capability auto-detection fails (e.g., Emacs `eat`). `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1` enables background upgrades on Homebrew/WinGet installs, which otherwise never auto-update. ### Configuration Management Commands @@ -2166,8 +2187,8 @@ For more information about Claude Code and related features: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/permission-modes - https://code.claude.com/docs/en/interactive-mode diff --git a/09-advanced-features/planning-mode-examples.md b/09-advanced-features/planning-mode-examples.md index f57bd79..6ee1d7a 100644 --- a/09-advanced-features/planning-mode-examples.md +++ b/09-advanced-features/planning-mode-examples.md @@ -533,4 +533,7 @@ Proceed with this plan? (yes/no/modify) 7. **Plan for testing** at each phase --- -**Last Updated**: April 9, 2026 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 +**Sources**: +- https://code.claude.com/docs/en/changelog diff --git a/10-cli/README.md b/10-cli/README.md index c2350ea..6b08fb1 100644 --- a/10-cli/README.md +++ b/10-cli/README.md @@ -56,7 +56,7 @@ The older JavaScript bundle is still produced for Windows and for environments t | `claude remote-control` | Start Remote Control server | `claude remote-control` | | `claude plugin` | Manage plugins (install, enable, disable) | `claude plugin install my-plugin` | | `claude plugin tag ` | Create a release git tag for a plugin with version validation (v2.1.118+) | `claude plugin tag v0.3.0` | -| `claude install [version]` | Install a specific native-binary version. Accepts `stable`, `latest`, or an explicit version string | `claude install 2.1.126` | +| `claude install [version]` | Install a specific native-binary version. Accepts `stable`, `latest`, or an explicit version string | `claude install 2.1.131` | | `claude project purge [path]` | Delete all local Claude Code state for a project (transcripts, tasks, debug logs, file-edit history, prompt history, and `~/.claude.json` entry). Omit `[path]` for an interactive picker. Flags: `--dry-run` to preview, `-y/--yes` to skip confirmation, `-i/--interactive` to confirm each item, `--all` for every project (v2.1.126+) | `claude project purge ~/work/repo --dry-run` | | `claude plugin prune` | Remove orphaned auto-installed plugin dependencies (parent plugin gone). `plugin uninstall --prune` does the same cascade after uninstalling a target (v2.1.121+) | `claude plugin prune` | | `claude ultrareview [target]` | Run `/ultrareview` non-interactively. Prints findings to stdout, exits 0 on success / 1 on failure. Use `--json` for raw payload, `--timeout ` to override the 30-minute default (v2.1.120+) | `claude ultrareview 1234 --json` | @@ -150,7 +150,7 @@ claude -p --model opus --fallback-model sonnet "analyze architecture" claude --model opusplan "design and implement the caching layer" ``` -> **Gateway model discovery (v2.1.126+)**: When `ANTHROPIC_BASE_URL` points at an Anthropic-compatible gateway, `/model` populates its picker from the gateway's `/v1/models` endpoint instead of the hard-coded list — useful for self-hosted proxies that expose a different model lineup. +> **Gateway model discovery (v2.1.129+, opt-in)**: When `ANTHROPIC_BASE_URL` points at an Anthropic-compatible gateway, set `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` to populate `/model` from the gateway's `/v1/models` endpoint. Without the env var, `/model` falls back to the built-in static list. The flag is opt-in (changed in v2.1.129) because the discovery call can surface models a user may not be entitled to use; v2.1.126 made it implicit and that behavior was reverted. ## System Prompt Customization @@ -793,6 +793,9 @@ The "ultrathink" keyword in prompts activates deep reasoning. The `max` effort l | `OTEL_LOG_TOOL_DETAILS` | Set to `1` to unredact custom and MCP command names in OpenTelemetry events (v2.1.117+). Redaction remains the default. | | `ANTHROPIC_BEDROCK_SERVICE_TIER` | Selects the Bedrock service tier: `default`, `flex`, or `priority` (v2.1.122+) | | `AI_AGENT` | Set automatically on subprocesses so external CLIs (e.g., `gh`) can attribute traffic to Claude Code (v2.1.120+) | +| `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+) | > **`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. @@ -900,8 +903,8 @@ claude -p --output-format json "query" --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/cli-reference - https://code.claude.com/docs/en/settings @@ -911,5 +914,5 @@ claude -p --output-format json "query" - https://github.com/anthropics/claude-code/releases/tag/v2.1.116 - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 - https://github.com/anthropics/claude-code/releases/tag/v2.1.118 -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/CATALOG.md b/CATALOG.md index feda855..2ef34d6 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-april-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-may-2026) --- @@ -17,12 +17,12 @@ |---------|----------|----------|-------|-----------| | **Slash Commands** | 60+ | 8 | 68+ | [01-slash-commands/](01-slash-commands/) | | **Subagents** | 6 | 11 | 17 | [04-subagents/](04-subagents/) | -| **Skills** | 5 bundled | 4 | 9 | [03-skills/](03-skills/) | +| **Skills** | 5 bundled | 6 | 11 | [03-skills/](03-skills/) | | **Plugins** | - | 3 | 3 | [07-plugins/](07-plugins/) | | **MCP Servers** | 1 | 8 | 9 | [05-mcp/](05-mcp/) | | **Hooks** | 28 events | 8 | 8 | [06-hooks/](06-hooks/) | | **Memory** | 7 types | 3 | 3 | [02-memory/](02-memory/) | -| **Total** | **99** | **45** | **119** | | +| **Total** | **99** | **47** | **121** | | --- @@ -423,7 +423,7 @@ Persistent context loaded automatically across sessions. | **Project Rules** | `.claude/rules/` | Project (team) | Modular project rules | | **User** | `~/.claude/CLAUDE.md` | User (personal) | Personal preferences | | **User Rules** | `~/.claude/rules/` | User (personal) | Modular personal rules | -| **Local** | `./CLAUDE.local.md` | Local (git-ignored) | Machine-specific overrides (not in official docs as of March 2026; may be legacy) | +| **Local** | `./CLAUDE.local.md` | Local (git-ignored) | Machine-specific local overrides (gitignored). Documented at https://code.claude.com/docs/en/memory as a supported per-developer override file. | | **Auto Memory** | Automatic | Session | Auto-captured insights and corrections | > **Scope**: `Organization` = managed by admins, `Project` = shared with team via git, `User` = personal preferences, `Local` = not committed, `Session` = auto-managed @@ -438,7 +438,7 @@ cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md --- -## New Features (April 2026) +## New Features (May 2026) | Feature | Description | How to Use | |---------|-------------|------------| @@ -530,8 +530,8 @@ chmod +x ~/.claude/hooks/*.sh --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/commands diff --git a/CHANGELOG.md b/CHANGELOG.md index 77e6235..2f517fa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,75 @@ # Changelog +## [v2.1.131] — 2026-05-06 + +### Synced to Claude Code v2.1.131 + +Bumps tutorial coverage from Claude Code v2.1.126 → v2.1.131 (May 6, 2026 +release). Anthropic shipped v2.1.128, v2.1.129, and v2.1.131 since the last +sync; v2.1.127 and v2.1.130 were skipped and never released publicly. + +### Added (English docs) + +- `--plugin-url ` flag (v2.1.129) — fetches a plugin `.zip` archive from + a URL for the current session. Repeatable. Documented in + `07-plugins/README.md`. +- `CLAUDE_CODE_FORCE_SYNC_OUTPUT` env var (v2.1.129) — forces synchronous + output for terminals where auto-detection misses (e.g., Emacs `eat`). + Documented in `10-cli/README.md` and `09-advanced-features/README.md`. +- `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` env var (v2.1.129) — enables + background upgrades for Homebrew/WinGet installs (which normally do not + auto-update). Documented in `10-cli/README.md` and + `09-advanced-features/README.md`. +- `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` env var (v2.1.129) — required + to opt in to `/v1/models` gateway discovery (see Changed). Documented in + `10-cli/README.md`. +- `disableRemoteControl` setting (v2.1.128) — admins can block + `claude remote-control` and `/remote-control` via managed/policy scope. + Documented in `09-advanced-features/README.md`. +- `--plugin-dir` accepts `.zip` archives (v2.1.128) — alongside directory + inputs. Documented in `07-plugins/README.md`. +- `skillOverrides` accepts `"name-only"` and `"user-invocable-only"` + (v2.1.129) — in addition to the previous `"on"`/`"off"`. Documented in + `03-skills/README.md`. + +### Changed + +- **Behavior change**: Gateway `/v1/models` discovery is now **opt-in** + (v2.1.129). Previously (v2.1.126), setting `ANTHROPIC_BASE_URL` automatically + populated `/model` from the gateway's `/v1/models` endpoint. From v2.1.129, + users must additionally set `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`; + without the env var, `/model` falls back to the built-in static list. + Documented in `10-cli/README.md`. +- `/mcp` shows tool count per server and visually flags servers reporting 0 + tools (v2.1.128). Documented in `05-mcp/README.md`. +- Bare `/color` (no args) picks a random session color (v2.1.128); explicit + `/color ` continues to set a specific color. Documented in + `01-slash-commands/README.md`. +- `--channels` flag now works with API-key (console) authentication + (v2.1.128). Earlier releases required Pro/Max OAuth. Documented in + `09-advanced-features/README.md`. +- Ctrl+R history picker defaults to **all prompts across all projects** + (v2.1.129). Press Ctrl+S inside the picker to narrow scope to the current + project. Documented in `09-advanced-features/README.md`. +- `/context` no longer dumps its ASCII visualization into the conversation + (v2.1.129). The viz is shown in-UI only; no more ~1.6k token cost per + invocation. Documented in `09-advanced-features/README.md`. +- Oversized images in drag-and-drop are auto-downscaled (v2.1.128) — earlier + versions rejected images outright. + +### Fixed + +- VS Code extension activation on Windows (v2.1.131). +- Mantle endpoint authentication (v2.1.131). +- 1-hour prompt-cache TTL no longer truncated to 5 minutes (v2.1.129). +- Crash on stdin payloads larger than 10 MB (v2.1.128). + +### Notes for translation maintainers + +The `vi/`, `zh/`, `uk/`, and `ja/` localized trees are community-maintained +and may lag the English source. Contributors syncing translations should diff +against the English files updated in this release. + ## [v2.1.126] — 2026-05-02 ### Synced to Claude Code v2.1.126 diff --git a/INDEX.md b/INDEX.md index 82aedb3..2d4373b 100644 --- a/INDEX.md +++ b/INDEX.md @@ -874,13 +874,13 @@ Want to add more examples? Follow the structure: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks - https://code.claude.com/docs/en/commands -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 **Total Examples**: 100+ files **Categories**: 10 features diff --git a/LEARNING-ROADMAP.md b/LEARNING-ROADMAP.md index 51cb3fe..2ac6c21 100644 --- a/LEARNING-ROADMAP.md +++ b/LEARNING-ROADMAP.md @@ -97,7 +97,7 @@ graph TD | Step | Feature | Complexity | Time | Level | Dependencies | Why Learn This | Key Benefits | |------|---------|-----------|------|-------|--------------|----------------|--------------| -| **1** | [Slash Commands](01-slash-commands/) | ⭐ Beginner | 30 min | Level 1 | None | Quick productivity wins (55+ built-in + 5 bundled skills) | Instant automation, team standards | +| **1** | [Slash Commands](01-slash-commands/) | ⭐ Beginner | 30 min | Level 1 | None | Quick productivity wins (60+ built-in + 5 bundled skills) | Instant automation, team standards | | **2** | [Memory](02-memory/) | ⭐⭐ Beginner+ | 45 min | Level 1 | None | Essential for all features | Persistent context, preferences | | **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 | @@ -738,12 +738,12 @@ Once you've completed all milestones: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, 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 5960258..e7fb257 100644 --- a/QUICK_REFERENCE.md +++ b/QUICK_REFERENCE.md @@ -113,7 +113,7 @@ claude -r "session" # Resume session by name/ID | Feature | Install Path | Usage | |---------|-------------|-------| -| **Slash Commands (55+)** | `.claude/commands/*.md` | `/command-name` | +| **Slash Commands (60+)** | `.claude/commands/*.md` | `/command-name` | | **Memory** | `./CLAUDE.md` | Auto-loaded | | **Skills** | `.claude/skills/*/SKILL.md` | Auto-invoked | | **Subagents** | `.claude/agents/*.md` | Auto-delegated | @@ -439,7 +439,7 @@ echo $GITHUB_TOKEN | Need | Use This | Example | |------|----------|---------| -| Quick shortcut | Slash Command (55+) | `01-slash-commands/optimize.md` | +| Quick shortcut | Slash Command (60+) | `01-slash-commands/optimize.md` | | Team standards | Memory | `02-memory/project-CLAUDE.md` | | Auto workflow | Skill | `03-skills/code-review/` | | Specialized task | Subagent | `04-subagents/code-reviewer.md` | @@ -457,7 +457,6 @@ echo $GITHUB_TOKEN - **Main Guide**: `README.md` - **Complete Index**: `INDEX.md` -- **Summary**: `EXAMPLES_SUMMARY.md` - **Original Guide**: `claude_concepts_guide.md` --- @@ -505,11 +504,11 @@ Getting started checklist: **This Card**: Keep it handy for quick reference! --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks - https://code.claude.com/docs/en/commands -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/README.md b/README.md index 3dd20ca..75aad16 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ [![GitHub Stars](https://img.shields.io/github/stars/luongnv89/claude-howto?style=flat&color=gold)](https://github.com/luongnv89/claude-howto/stargazers) [![GitHub Forks](https://img.shields.io/github/forks/luongnv89/claude-howto?style=flat)](https://github.com/luongnv89/claude-howto/network/members) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) -[![Version](https://img.shields.io/badge/version-2.1.126-brightgreen)](CHANGELOG.md) +[![Version](https://img.shields.io/badge/version-2.1.131-brightgreen)](CHANGELOG.md) [![Claude Code](https://img.shields.io/badge/Claude_Code-2.1+-purple)](https://code.claude.com) 🌐 **Language / Ngôn ngữ / 语言 / Мова:** [English](README.md) | [Tiếng Việt](vi/README.md) | [中文](zh/README.md) | [Українська](uk/README.md) | [日本語](ja/README.md) @@ -102,7 +102,7 @@ Run `/lesson-quiz [topic]` after each module. The quiz pinpoints what you missed - **GitHub stars** from developers who use Claude Code daily - **Forks** from teams adapting this guide for their own workflows -- **Actively maintained** — synced with every Claude Code release (latest: v2.1.126, May 2026) +- **Actively maintained** — synced with every Claude Code release (latest: v2.1.131, May 2026) - **Community-driven** — contributions from developers who share their real-world configurations [![Star History Chart](https://api.star-history.com/svg?repos=luongnv89/claude-howto&type=Date)](https://star-history.com/#luongnv89/claude-howto&Date) @@ -201,7 +201,7 @@ cp -r 03-skills/code-review ~/.claude/skills/ Yes. MIT licensed, free forever. Use it in personal projects, at work, in your team — no restrictions beyond including the license notice. **Is this maintained?** -Actively. The guide is synced with every Claude Code release. Current version: v2.1.126 (May 2026), compatible with Claude Code 2.1+. +Actively. The guide is synced with every Claude Code release. Current version: v2.1.131 (May 2026), compatible with Claude Code 2.1+. **How is this different from the official docs?** The official docs are a feature reference. This guide is a tutorial with diagrams, production-ready templates, and a progressive learning path. They complement each other — start here to learn, reference the docs when you need specifics. @@ -871,11 +871,11 @@ MIT License - see [LICENSE](LICENSE). Free to use, modify, and distribute. The o --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 - https://github.com/anthropics/claude-code/releases/tag/v2.1.113 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md index 0e2122b..c5c5e6f 100644 --- a/STYLE_GUIDE.md +++ b/STYLE_GUIDE.md @@ -631,8 +631,8 @@ Before submitting content, verify: --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog diff --git a/claude_concepts_guide.md b/claude_concepts_guide.md index 8520f82..c177ac4 100644 --- a/claude_concepts_guide.md +++ b/claude_concepts_guide.md @@ -3145,8 +3145,8 @@ Claude Code supports three models with adaptive reasoning effort: *Now includes: Hooks, Checkpoints, Planning Mode, Extended Thinking, Background Tasks, Permission Modes (6 modes), Headless Mode, Session Management, Auto Memory, Agent Teams, Scheduled Tasks, Chrome Integration, Channels, Voice Dictation, and Bundled Skills* --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks diff --git a/resources.md b/resources.md index 602c90b..5cce024 100644 --- a/resources.md +++ b/resources.md @@ -249,10 +249,10 @@ These steps capture the core recommendations for smooth workflows with Claude Co | **Monitor Tool** | Watch a background command's stdout stream and react to events instead of polling (v2.1.98+) | [Advanced Features](09-advanced-features/) | --- -**Last Updated**: May 2, 2026 -**Claude Code Version**: 2.1.126 +**Last Updated**: May 6, 2026 +**Claude Code Version**: 2.1.131 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog -- https://github.com/anthropics/claude-code/releases/tag/v2.1.126 +- https://github.com/anthropics/claude-code/releases/tag/v2.1.131 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5