CalvinBackup/claude-howto
1
0
Fork 0
mirror of https://github.com/luongnv89/claude-howto.git synced 2026-07-07 11:17:48 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: sync to Claude Code v2.1.131 (3 patches since v2.1.126)

Browse Source 
Sync covers v2.1.128, v2.1.129, and v2.1.131 (May 2026). Highlights:
gateway /v1/models discovery is now opt-in (CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY),
added --plugin-url flag, disableRemoteControl setting, /mcp tool-count display,
expanded skillOverrides values, /context viz no longer leaks into conversation,
Ctrl+R cross-project default. Also reconciles slash-command count to 60+ and
fixes the skill-count entry in CATALOG.
This commit is contained in:
Luong NGUYEN
2026-05-06 23:55:28 +02:00
parent 9701bb74c2
commit d4b5cf56b4
24 changed files with 215 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files
01-slash-commands/README.md
+3 -3
View File
@@ -28,7 +28,7 @@ Built-in commands are shortcuts for common actions. There are **60+ built-in com
| `/btw <question>` | 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
02-memory/README.md
+3 -3
View File
@@ -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
03-skills/README.md
+23 -2
View File
@@ -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
04-subagents/README.md
+3 -3
View File
@@ -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
05-mcp/README.md
+9 -2
View File
@@ -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
06-hooks/README.md
+3 -3
View File
@@ -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
07-plugins/README.md
+15 -3
View File
@@ -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
07-plugins/devops-automation/README.md
+3 -3
View File
@@ -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
07-plugins/documentation/README.md
+3 -3
View File
@@ -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
07-plugins/pr-review/README.md
+3 -3
View File
@@ -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
08-checkpoints/README.md
+2 -2
View File
@@ -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
08-checkpoints/checkpoint-examples.md
+5 -1
View File
@@ -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
09-advanced-features/README.md
+26 -5
View File
@@ -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
09-advanced-features/planning-mode-examples.md
+4 -1
View File
@@ -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
10-cli/README.md
+8 -5
View File
@@ -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 <version>` | 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 <minutes>` 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
CATALOG.md
+7 -7
View File
@@ -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
CHANGELOG.md
+70
View File
@@ -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 <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 <name|hex>` 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
INDEX.md
+3 -3
View File
@@ -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
LEARNING-ROADMAP.md
+4 -4
View File
@@ -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
QUICK_REFERENCE.md
+5 -6
View File
@@ -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
README.md
+6 -6
View File
@@ -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
STYLE_GUIDE.md
+2 -2
View File
@@ -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
claude_concepts_guide.md
+2 -2
View File
@@ -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
resources.md
+3 -3
View File
@@ -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