* docs: sync to Claude Code v2.1.245 Sync the tutorial, its four translations, and both learner-facing skills against Claude Code v2.1.245 (was anchored at v2.1.235). The graded material turned out to be staler than the tutorials it grades. The lesson READMEs already said "31 hook events", "six rewind options" and "six permission modes"; the quiz and self-assessment still said 25, 5 and 5, so learners were scored against a wrong answer and then sent to a lesson that contradicted it. Seven such claims are fixed here. Two long-standing doc defects were also verified against official docs: - Hook default timeout was documented as 60 seconds. It is 600 for command/http/mcp_tool (30 for prompt, 60 for agent), with per-event overrides. Wrong in five places. - Skill precedence was documented as enterprise > project > personal. The official order is enterprise > personal > project. question-bank.md Lesson 03 Q9 already graded the correct order, so the lesson had been contradicting its own quiz. Fixed - Hook default timeout 60s -> 600s, with per-event overrides - Skill precedence: project and personal were swapped - Memory "overrides root CLAUDE.md" -> concatenation model (last holdouts after the quiz was aligned in #164) - permissionMode frontmatter omitted `auto` (English + vi/ja/uk); the quiz was right and the docs were wrong - Built-in subagent `Bash` no longer exists upstream -> renamed to `claude` - `/undo` is absent from the official commands reference -> marked deprecated - `backgroundTasks` settings block was fabricated -> replaced with CLAUDE_CODE_DISABLE_BACKGROUND_TASKS and the concurrency env var - Plugin manifest field is `lspServers`, not inline `lsp` - vi/05-mcp documented `claude mcp add --transport ws`, which upstream explicitly does not support - Self-assessment could never reach its own maximum score: rounds cap at 4+4+4+3+4 = 19, not 20 - 13 dangling quiz `Review:` pointers, two of which named another lesson - Skill description cap: 1024 chars -> 1,536 combined with `when_to_use` Added - WebSocket (`ws`) MCP transport, undocumented until now - Concise output style (v2.1.237), a fifth built-in - modelPicker, promptCacheTtl, subagentPromptCacheTtl, modelPricing, keybindingFlavor settings - ANTHROPIC_DEFAULT_MODEL env var - Hook `async`, `asyncRewake`, `shell`, `statusMessage`, `retry` keys; `agent` type marked experimental - /design canvas, Remote Control out of research preview, notify_when_idle, plugin manifest fields (workflows, channels, dependencies, outputStyles) Deferred deliberately: the reserved `synced` skills folder, and a bulk footer stamp across the translations. zh/ carries none of the P0 claims (it is abridged upstream of this run), so it has no P0 sub-tasks rather than fabricated English. Mermaid validation did not run in this environment (mmdc absent); CI covers it. * fix(docs): propagate v2.1.245 corrections to CATALOG, translations, and stale enumerations * fix(docs): propagate built-in subagent rename to uk/vi/zh CATALOG and zh lesson
39 KiB
Claude Code Feature Catalog
Quick reference guide to all Claude Code features: commands, agents, skills, plugins, and hooks.
Navigation: Commands | Permission Modes | Subagents | Skills | Plugins | MCP Servers | Hooks | Memory | New Features
Summary
| Feature | Built-in | Examples | Total | Reference |
|---|---|---|---|---|
| Slash Commands | 60+ | 8 | 68+ | 01-slash-commands/ |
| Subagents | 6 | 9 | 15 | 04-subagents/ |
| Skills | 10 bundled | 6 | 16 | 03-skills/ |
| Plugins | - | 3 | 3 | 07-plugins/ |
| MCP Servers | 1 | 4 | 5 | 05-mcp/ |
| Hooks | 31 events | 11 | 42 | 06-hooks/ |
| Memory | 7 types | 3 | 10 | 02-memory/ |
| Total | 115 | 44 | 159 |
Slash Commands
Commands are user-invoked shortcuts that execute specific actions.
Built-in Commands
| Command | Description | When to Use |
|---|---|---|
/help |
Show help information | Get started, learn commands |
/btw |
Ephemeral side question — doesn't pollute main context | Quick tangent questions |
/chrome |
Configure Chrome integration | Browser automation |
/clear |
Clear conversation history | Start fresh, reduce context |
/diff |
Interactive diff viewer | Review changes |
/config |
View/edit configuration | Customize behavior |
/status |
Show session status | Check current state |
/agents |
List available agents | See delegation options |
/skills |
List available skills | See auto-invoke capabilities |
/hooks |
List configured hooks | Debug automation |
/insights |
Analyze session patterns | Session optimization |
/install-slack-app |
Install Claude Slack app | Slack integration |
/keybindings |
Customize keyboard shortcuts | Key customization |
/mcp |
List MCP servers | Check external integrations |
/memory |
View loaded memory files | Debug context loading |
/mobile |
Generate mobile QR code | Mobile access |
/passes |
View usage passes | Subscription info |
/plugin |
Manage plugins | Install/remove extensions |
/plan |
Enter planning mode | Complex implementations |
/proactive |
Alias for /loop (v2.1.105) |
Same as /loop |
/recap |
Show session recap when returning to a session | After being away, get context on what was done |
/rewind |
Rewind to checkpoint | Undo changes, explore alternatives |
/checkpoint |
Manage checkpoints | Save/restore states |
/cost |
Shortcut alias that opens the cost tab of /usage (v2.1.118+) |
Monitor spending |
/context |
Show context window usage | Manage conversation length |
/export |
Export conversation | Save for reference |
/usage-credits |
Configure extra usage limits (renamed from /extra-usage in v2.1.144; old name still works as alias) |
Rate limit management |
/feedback |
Submit feedback or bug report | Report issues |
/login |
Authenticate with Anthropic | Access features |
/logout |
Sign out | Switch accounts |
/sandbox |
Toggle sandbox mode | Safe command execution |
/doctor |
Run diagnostics | Troubleshoot issues |
/reload-plugins |
Reload installed plugins. Since v2.1.221 most installs activate immediately; only needed when the install summary says Run /reload-plugins to activate. |
Plugin management |
/reload-skills |
Re-scan skill directories without restarting (v2.1.152) | Skill management |
/workflows |
View running and completed dynamic workflow runs (v2.1.154) | Multi-agent orchestration |
/release-notes |
Show release notes | Check new features |
/remote-control |
Enable remote control | Remote access |
/permissions |
Manage permissions | Control access |
/session |
Manage sessions | Multi-session workflows |
/rename |
Rename current session | Organize sessions |
/resume |
Resume previous session | Continue work |
/todo |
View/manage todo list | Track tasks |
/tui |
Toggle fullscreen TUI (text user interface) mode | Flicker-free rendering in fullscreen/tmux |
/tasks |
View background tasks | Monitor async operations |
/copy |
Copy last response to clipboard | Share output quickly |
/teleport (alias /tp) |
Resume a Claude Code on the web session in this terminal; opens a picker. Requires a claude.ai subscription | Continue work remotely |
/desktop |
Open Claude Desktop app | Switch to desktop interface |
/theme |
Change color theme; v2.1.118 added custom named themes via ~/.claude/themes/<name>.json (plugins can ship a themes/ dir) |
Customize appearance |
/usage |
Canonical command for usage/cost/stats — merged /cost and /stats into a single tabbed view (v2.1.118); as of v2.1.149 the cost view breaks spending down by category (skills, subagents, plugins, per-MCP-server). In the VSCode extension (v2.1.174), the /usage (Account & usage) dialog adds an attribution breakdown — cache misses, long-context cost, subagents, and per-skill / per-agent / per-plugin / per-MCP usage over 24h and 7d windows |
Monitor quota and costs |
/focus |
Toggle focus view (distraction-free output display) | Reduce visual noise during long tasks |
/fork |
Copy the conversation into a new independent background session (v2.1.212+) | Explore alternatives in parallel |
/subtask |
Spawn a forked subagent that inherits the conversation and reports back (v2.1.212+) | Delegate a side task without losing your place |
/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; applies to Opus 5 and Opus 4.8 (v2.1.219) | Speed up responses |
/terminal-setup |
Configure terminal integration | Setup terminal features |
/undo |
No longer documented — added as an alias for /rewind in v2.1.108, but it appears nowhere in the official commands reference |
Use /rewind (or Esc Esc) instead |
/upgrade |
Check for updates | Version management |
/team-onboarding |
Generate a teammate ramp-up guide from this project's Claude Code usage | Onboarding new teammates (v2.1.101) |
/code-review ultra |
Run a cloud multi-agent code review over your current changes. /ultrareview remains as an alias; /code-review ultra is the preferred invocation. Includes 3 free runs on Pro and Max, then requires usage credits |
Deep pre-merge review across multiple agents (v2.1.112) |
/fewer-permission-prompts |
Scan transcripts and propose a prioritized allowlist for common read-only tools | Reduce repeat permission prompts in a project (v2.1.112) |
Custom Commands (Examples)
| Command | Description | When to Use | Scope | Installation |
|---|---|---|---|---|
/optimize |
Analyze code for optimization | Performance improvement | Project | cp 01-slash-commands/optimize.md .claude/commands/ |
/pr |
Prepare pull request | Before submitting PRs | Project | cp 01-slash-commands/pr.md .claude/commands/ |
/generate-api-docs |
Generate API documentation | Document APIs | Project | cp 01-slash-commands/generate-api-docs.md .claude/commands/ |
/commit |
Create git commit with context | Commit changes | User | cp 01-slash-commands/commit.md .claude/commands/ |
/push-all |
Stage, commit, and push | Quick deployment | User | cp 01-slash-commands/push-all.md .claude/commands/ |
/doc-refactor |
Restructure documentation | Improve docs | Project | cp 01-slash-commands/doc-refactor.md .claude/commands/ |
/setup-ci-cd |
Setup CI/CD pipeline | New projects | Project | cp 01-slash-commands/setup-ci-cd.md .claude/commands/ |
/unit-test-expand |
Expand test coverage | Improve testing | Project | cp 01-slash-commands/unit-test-expand.md .claude/commands/ |
Scope:
User= personal workflows (~/.claude/commands/),Project= team-shared (.claude/commands/)
Reference: 01-slash-commands/ | Official Docs
Quick Install (All Custom Commands):
cp 01-slash-commands/*.md .claude/commands/
Permission Modes
Claude Code supports 6 permission modes that control how tool use is authorized.
| Mode | Description | When to Use |
|---|---|---|
manual |
Prompt for each tool call | Standard interactive use (renamed from default in v2.1.200; default still accepted) |
acceptEdits |
Auto-accept file edits, prompt for others | Trusted editing workflows |
plan |
Read-only tools only, no writes | Planning and exploration |
auto |
All actions, with background safety classifier checks | Long tasks, reducing prompt fatigue |
bypassPermissions |
Skip all permission checks | CI/CD, headless environments |
dontAsk |
Skip tools that would require permission | Non-interactive scripting |
Note
:
automode requires an eligible plan, model, and provider — see 09-advanced-features/. UsebypassPermissionsonly in trusted, sandboxed environments.
Reference: Official Docs
Subagents
Specialized AI assistants with isolated contexts for specific tasks.
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_DEPTHto change the limit, or1to 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 for theAgent(agent_type)syntax that restricts which subagents a given subagent may spawn.
Built-in Subagents
| Agent | Description | Tools | Model | When to Use |
|---|---|---|---|---|
| general-purpose | Multi-step tasks, research | All tools | Inherits model | Complex research, multi-file tasks |
| Plan | Implementation planning | Read, Glob, Grep, Bash | Inherits model | Architecture design, planning |
| Explore | Codebase exploration | Read, Glob, Grep | Inherits (capped at Opus) | Quick searches, understanding code |
| claude | Catch-all for tasks that don't fit a more specialized agent | All tools | Inherits model | Tasks with no specialized agent; default agent for a dispatched background session |
| statusline-setup | Status line configuration | Bash, Read, Write | Sonnet 4.6 | Configure status line display |
| claude-code-guide | Help and documentation | Read, Glob, Grep | Haiku 4.5 | Getting help, learning features |
Subagent Configuration Fields
| Field | Type | Description |
|---|---|---|
name |
string | Agent identifier |
description |
string | What the agent does |
model |
string | Model override (e.g., haiku-4.5) |
tools |
array | Allowed tools list |
effort |
string | Reasoning effort level (low, medium, high) |
initialPrompt |
string | System prompt injected at agent start |
disallowedTools |
array | Tools explicitly denied to this agent |
Custom Subagents (Examples)
| Agent | Description | When to Use | Scope | Installation |
|---|---|---|---|---|
code-reviewer |
Comprehensive code quality | Code review sessions | Project | cp 04-subagents/code-reviewer.md .claude/agents/ |
clean-code-reviewer |
Clean Code principles review | Maintainability review | Project | cp 04-subagents/clean-code-reviewer.md .claude/agents/ |
test-engineer |
Test strategy & coverage | Test planning | Project | cp 04-subagents/test-engineer.md .claude/agents/ |
documentation-writer |
Technical documentation | API docs, guides | Project | cp 04-subagents/documentation-writer.md .claude/agents/ |
secure-reviewer |
Security-focused review | Security audits | Project | cp 04-subagents/secure-reviewer.md .claude/agents/ |
implementation-agent |
Full feature implementation | Feature development | Project | cp 04-subagents/implementation-agent.md .claude/agents/ |
debugger |
Root cause analysis | Bug investigation | User | cp 04-subagents/debugger.md .claude/agents/ |
data-scientist |
SQL queries, data analysis | Data tasks | User | cp 04-subagents/data-scientist.md .claude/agents/ |
performance-optimizer |
Profiling & performance tuning | Bottleneck investigation | Project | cp 04-subagents/performance-optimizer.md .claude/agents/ |
Scope:
User= personal (~/.claude/agents/),Project= team-shared (.claude/agents/)
Reference: 04-subagents/ | Official Docs
Quick Install (All Custom Agents):
cp 04-subagents/*.md .claude/agents/
Skills
Auto-invoked capabilities with instructions, scripts, and templates.
Example Skills
| Skill | Description | When Auto-Invoked | Scope | Installation |
|---|---|---|---|---|
code-review-specialist |
Comprehensive code review | "Review this code", "Check quality" | Project | cp -r 03-skills/code-review-specialist .claude/skills/ |
brand-voice |
Brand consistency checker | Writing marketing copy | Project | cp -r 03-skills/brand-voice .claude/skills/ |
doc-generator |
API documentation generator | "Generate docs", "Document API" | Project | cp -r 03-skills/doc-generator .claude/skills/ |
refactor |
Systematic code refactoring (Martin Fowler) | "Refactor this", "Clean up code" | User | cp -r 03-skills/refactor ~/.claude/skills/ |
claude-md |
Create or update CLAUDE.md files | "Create CLAUDE.md", "Audit CLAUDE.md" | Project | cp -r 03-skills/claude-md .claude/skills/ |
blog-draft |
Draft a blog post from ideas and resources | "Write a blog post", "Draft an article" | User | cp -r 03-skills/blog-draft ~/.claude/skills/ |
Scope:
User= personal (~/.claude/skills/),Project= team-shared (.claude/skills/)
Skill Structure
~/.claude/skills/skill-name/
├── SKILL.md # Skill definition & instructions
├── scripts/ # Helper scripts
└── templates/ # Output templates
Skill Frontmatter Fields
Skills support YAML frontmatter in SKILL.md for configuration:
| Field | Type | Description |
|---|---|---|
name |
string | Skill display name |
description |
string | What the skill does |
autoInvoke |
array | Trigger phrases for auto-invocation |
effort |
string | Reasoning effort level (low, medium, high) |
shell |
string | Shell to use for scripts (bash, zsh, sh) |
Reference: 03-skills/ | Official Docs
Quick Install (All Skills):
cp -r 03-skills/* ~/.claude/skills/
Bundled Skills
| Skill | Description | When Auto-Invoked |
|---|---|---|
/batch |
Run prompts on multiple files | Batch operations |
/claude-api |
Build apps with Claude API | API development |
/debug |
Debug failing tests/errors | Debugging sessions |
/design (research preview, v2.1.233+) |
Create a multi-artboard design canvas — UI mockups, screen flows, landing pages, posters — refined visually instead of in code. Pro/Max/Team/Enterprise | Designing a screen or page you would rather tweak by hand than in HTML |
/fewer-permission-prompts |
Scan transcripts and propose a prioritized allowlist | Reduce repeat permission prompts |
/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 [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path] |
Review the current diff — or a PR, branch, or path — for correctness bugs. --fix applies findings, --comment posts them as inline PR comments. With no level given it reuses the last one you typed (v2.1.223). Lower effort levels moved to a background subagent in v2.1.218; high, xhigh, and max followed in v2.1.232, so review output no longer fills the conversation |
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 |
Plugins
Bundled collections of commands, agents, MCP servers, and hooks.
Example Plugins
| Plugin | Description | Components | When to Use | Scope | Installation |
|---|---|---|---|---|---|
pr-review |
PR review workflow | 3 commands, 3 agents, GitHub MCP | Code reviews | Project | /plugin install pr-review |
devops-automation |
Deployment & monitoring | 4 commands, 3 agents, K8s MCP | DevOps tasks | Project | /plugin install devops-automation |
documentation |
Doc generation suite | 4 commands, 3 agents, templates | Documentation | Project | /plugin install documentation |
Scope:
Project= team-shared,User= personal workflows
Plugin Structure
.claude-plugin/
├── plugin.json # Manifest file
├── commands/ # Slash commands
├── agents/ # Subagents
├── skills/ # Skills
├── mcp/ # MCP configurations
├── hooks/ # Hook scripts
└── scripts/ # Utility scripts
Reference: 07-plugins/ | Official Docs
Plugin Management Commands:
/plugin list # List installed plugins
/plugin install <name> # Install plugin
/plugin remove <name> # Remove plugin
/plugin update <name> # Update plugin
MCP Servers
Model Context Protocol servers for external tool and API access.
Common MCP Servers
| Server | Description | When to Use | Scope | Installation |
|---|---|---|---|---|
| GitHub | PR management, issues, code | GitHub workflows | Project | claude mcp add github -- npx -y @modelcontextprotocol/server-github |
| Database | SQL queries, data access | Database operations | Project | claude mcp add db -- npx -y @modelcontextprotocol/server-postgres |
| Filesystem | Advanced file operations | Complex file tasks | User | claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem |
| Slack | Team communication | Notifications, updates | Project | Configure in settings |
| Google Docs | Document access | Doc editing, review | Project | Configure in settings |
| Asana | Project management | Task tracking | Project | Configure in settings |
| Stripe | Payment data | Financial analysis | Project | Configure in settings |
| Memory | Persistent memory | Cross-session recall | User | Configure in settings |
| Context7 | Library documentation | Up-to-date docs lookup | Built-in | Built-in |
Scope:
Project= team (.mcp.json),User= personal (~/.claude.json),Built-in= pre-installed
MCP Configuration Example
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
Reference: 05-mcp/ | MCP Protocol Docs
Quick Install (GitHub MCP):
export GITHUB_TOKEN="your_token" && claude mcp add github -- npx -y @modelcontextprotocol/server-github
Hooks
Event-driven automation that executes shell commands on Claude Code events.
Hook Events
| Event | Description | When Triggered | Use Cases |
|---|---|---|---|
SessionStart |
Session begins/resumes | Session initialization | Setup tasks |
Setup |
Initial environment setup (one-time per session) | First-time session bootstrap | Provision tooling, install deps |
InstructionsLoaded |
Instructions loaded | CLAUDE.md or rules file loaded | Custom instruction handling |
UserPromptSubmit |
Before prompt processing | User sends message | Input validation |
UserPromptExpansion |
User prompt expanded (@-mentions, slash commands resolved) | After expansion, before submit | Transform or inspect expanded prompt |
PreToolUse |
Before tool execution | Before any tool runs | Validation, logging |
PermissionRequest |
Permission dialog shown | Before sensitive actions | Custom approval flows |
PermissionDenied |
User denies a permission prompt | After permission decline | Logging, analytics, policy enforcement |
PostToolUse |
After tool succeeds | After any tool completes | Formatting, notifications |
PostToolUseFailure |
Tool execution fails | After tool error | Error handling, logging |
PostToolBatch |
After a batch of tool uses completes | End of a tool batch | Aggregate reporting, batched validation |
Notification |
Notification sent | Claude sends notification | External alerts |
SubagentStart |
Subagent spawned | Subagent task starts | Initialize subagent context |
SubagentStop |
Subagent finishes | Subagent task complete | Chain actions |
Stop |
Claude finishes responding | Response complete | Cleanup, reporting |
StopFailure |
API error ends turn | API error occurs | Error recovery, logging |
TeammateIdle |
Teammate agent idle | Agent team coordination | Distribute work |
TaskCompleted |
Task marked complete (only fires when the todo tools are enabled — see Hooks) | Task done | Post-task processing |
TaskCreated |
Task created via TaskCreate (only fires when the todo tools are enabled — see Hooks) | New task created | Task tracking, logging |
ConfigChange |
Configuration updated | Settings modified | React to config changes |
CwdChanged |
Working directory changes | Directory changed | Directory-specific setup |
FileChanged |
Watched file changes | File modified | File monitoring, rebuild |
PreCompact |
Before compact operation | Context compression | State preservation |
PostCompact |
After compaction completes | Compaction done | Post-compact actions |
WorktreeCreate |
Worktree being created | Git worktree created | Setup worktree environment |
WorktreeRemove |
Worktree being removed | Git worktree removed | Cleanup worktree resources |
Elicitation |
MCP server requests input | MCP elicitation | Input validation |
ElicitationResult |
User responds to elicitation | User responds | Response processing |
SessionEnd |
Session terminates | Session termination | Cleanup, save state |
Example Hooks
| Hook | Description | Event | Scope | Installation |
|---|---|---|---|---|
pre-tool-check.sh |
Blocks/warns on risky Bash commands | PreToolUse:Bash | User | cp 06-hooks/pre-tool-check.sh ~/.claude/hooks/ |
security-scan.sh |
Security scanning | PostToolUse:Write | Project | cp 06-hooks/security-scan.sh .claude/hooks/ |
format-code.sh |
Auto-formatting | PostToolUse:Write | User | cp 06-hooks/format-code.sh ~/.claude/hooks/ |
validate-prompt.sh |
Prompt validation | UserPromptSubmit | Project | cp 06-hooks/validate-prompt.sh .claude/hooks/ |
context-tracker.py |
Token usage tracking | UserPromptSubmit, Stop | User | cp 06-hooks/context-tracker.py ~/.claude/hooks/ |
context-tracker-tiktoken.py |
Token usage tracking (tiktoken, ~90-95% accuracy) | UserPromptSubmit, Stop | User | cp 06-hooks/context-tracker-tiktoken.py ~/.claude/hooks/ |
pre-commit.sh |
Pre-commit validation | PreToolUse:Bash | Project | cp 06-hooks/pre-commit.sh .claude/hooks/ |
log-bash.sh |
Command logging | PostToolUse:Bash | User | cp 06-hooks/log-bash.sh ~/.claude/hooks/ |
dependency-check.sh |
Vulnerability scan on manifest changes | PostToolUse:Write | Project | cp 06-hooks/dependency-check.sh .claude/hooks/ |
notify-team.sh |
Team notifications on git push | PostToolUse:Bash | Project | cp 06-hooks/notify-team.sh .claude/hooks/ |
session-end.sh |
Captures progress when a session ends | SessionEnd | User | cp 06-hooks/session-end.sh ~/.claude/hooks/ |
Scope:
Project= team (.claude/settings.json),User= personal (~/.claude/settings.json)
Hook Configuration
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"command": "~/.claude/hooks/pre-tool-check.sh"
}
],
"PostToolUse": [
{
"matcher": "Write",
"command": "~/.claude/hooks/format-code.sh"
}
]
}
}
Reference: 06-hooks/ | Official Docs
Quick Install (All Hooks):
mkdir -p ~/.claude/hooks && cp 06-hooks/*.sh ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.sh
Memory Files
Persistent context loaded automatically across sessions.
Memory Types
| Type | Location | Scope | When to Use |
|---|---|---|---|
| Managed Policy | Org-managed policies | Organization | Enforce org-wide standards |
| Project | ./CLAUDE.md |
Project (team) | Team standards, project context |
| 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 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
Reference: 02-memory/ | Official Docs
Quick Install:
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md
New Features
| Feature | Description | How to Use |
|---|---|---|
| /focus | Toggle focus view for distraction-free output display (v2.1.110) | Run /focus to reduce visual noise during long tasks |
| /proactive | Alias for /loop — same recurring-task behavior (v2.1.105) |
Use /proactive interchangeably with /loop |
| /recap | Show a session recap when returning to an existing session (v2.1.108) | Run /recap after being away to get context on what was done |
| /tui | Toggle fullscreen TUI (text user interface) mode for flicker-free rendering (v2.1.110) | Use /tui in fullscreen terminals or tmux |
| /undo | No longer documented — added as an alias for /rewind in v2.1.108, but it appears nowhere in the official commands reference |
Use /rewind (or Esc Esc) instead |
| Monitor Tool | Watch a background command's stdout stream and react to events instead of polling (v2.1.98+) | Use the Monitor tool via Advanced Features |
| Output Styles | Change Claude's role, tone, and default response format via the system prompt. Built-ins: Default, Proactive, Explanatory, Learning, Concise | /config → Output style, or set outputStyle. The /output-style command was removed in v2.1.91. See Advanced Features |
| Status Line | Render a custom status line from a command that receives session, model, cost, and context JSON on stdin | /statusline or the statusLine setting. See Advanced Features |
| Community Marketplace | Third-party plugins that passed Anthropic's automated validation, each pinned to a commit SHA | /plugin marketplace add anthropics/claude-plugins-community, then /plugin install <name>@claude-community |
| /team-onboarding | Auto-generate a teammate ramp-up guide from the project's Claude Code setup (v2.1.101) | Run /team-onboarding in your project |
| Remote Control | Control Claude Code sessions remotely via API. No longer a research preview — any machine running claude remote-control shows up as a device card in the Claude app's Code tab, so a session can be started on it from a phone |
Run claude remote-control on the machine, then pick its device card in the Claude app. See Advanced Features |
| Web Sessions | Run Claude Code in a browser-based environment | Access via claude web or through the Anthropic Console |
| Desktop App | Native desktop application for Claude Code | Use /desktop or download from Anthropic website |
| Cross-Session Messaging | Sessions can message each other — including your other machines and cloud sessions — discovered via ListAgents (v2.1.224+, macOS/Linux) |
See Advanced Features; control inbound with crossSessionInbound |
| Self-Hosted Runner | Run Claude Code web, mobile, and desktop sessions on your own machines or containers (v2.1.224+, Team/Enterprise) | claude self-hosted-runner setup; see CLI |
archive plugin source |
Install a plugin from an HTTPS zip, optionally pinned by sha256 (v2.1.224+) |
See Plugins |
command plugin source |
A locally installed tool prints the plugin directory path (v2.1.229+) | See Plugins |
| Marketplace owner wildcards | "owner/*" allows or blocks every marketplace repo under a GitHub owner — strictKnownMarketplaces and blockedMarketplaces only (v2.1.223+) |
See Plugins |
| Sandbox credential masking | Sandboxed commands read a sentinel while the proxy substitutes the real secret on egress (v2.1.221+, Linux/WSL) | See Advanced Features |
| Agent Teams | Coordinate multiple agents working on related tasks | Configure teammate agents that collaborate and share context |
| Task List | Background task management and monitoring | Use /tasks to view and manage background operations |
| Prompt Suggestions | Context-aware command suggestions | Suggestions appear automatically based on current context |
| Git Worktrees | Isolated git worktrees for parallel development | Use worktree commands for safe parallel branch work |
| Sandboxing | Isolated execution environments for safety | Use /sandbox to toggle; runs commands in restricted environments |
| MCP OAuth | OAuth authentication for MCP servers | Configure OAuth credentials in MCP server settings for secure access |
| MCP Tool Search | Search and discover MCP tools dynamically | Use tool search to find available MCP tools across connected servers |
| Scheduled Tasks | Set up recurring tasks with /loop and cron tools |
Use /loop 5m /command or CronCreate tool |
| Chrome Integration | Browser automation with headless Chromium | Use --chrome flag or /chrome command |
| Keyboard Customization | Customize keybindings including chord support | Use /keybindings or edit ~/.claude/keybindings.json |
| Auto Mode | Fully autonomous operation with background safety classifier checks | Shift+Tab to cycle to it, or --permission-mode auto |
| Channels | Multi-channel communication (Telegram, Slack, etc.) (Research Preview) | Configure channel plugins; March 2026 |
| Voice Dictation | Voice input for prompts | Use microphone icon or voice keybinding |
| Agent Hook Type | Hooks that spawn a subagent instead of running a shell command | Set "type": "agent" in hook configuration |
| Prompt Hook Type | Hooks that inject prompt text into the conversation | Set "type": "prompt" in hook configuration |
| MCP Elicitation | MCP servers can request user input during tool execution | Handle via Elicitation and ElicitationResult hook events |
| 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 <name> |
| 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 |
| Immediate Dialog Commands | /permissions can be opened while Claude is working (rule changes apply to the rest of the turn), and the /add-dir, /autocompact, /theme, /help, /config, and /advisor dialogs open mid-turn in the fullscreen TUI instead of queuing until Claude finishes responding (/bug already did this since v2.1.232) (v2.1.234) |
Run one of these commands while Claude is working. See Slash Commands |
CLAUDE_CODE_PROJECT_DIR_NAME |
Env var controlling per-project transcript directory naming (v2.1.234) | Set in your shell/env before launching Claude Code. See CLI |
| Goal Check-In Threshold | While a /goal is active, Claude checks in with a status update if a background task makes no progress for 30+ minutes, instead of continuing silently; tune with CLAUDE_CODE_GOAL_CHECKIN_MINUTES, or set to 0 to disable (v2.1.234) |
Set CLAUDE_CODE_GOAL_CHECKIN_MINUTES=<n> alongside an active /goal. See Slash Commands |
| Usage-Limit Auto-Continue | Claude Code auto-continues a session when a claude.ai usage limit resets, if it was blocked on that limit (v2.1.234) | On by default; turn it off in /config → "Continue automatically at usage limit". See Advanced Features |
spellcheck setting |
Underlines misspelled words in the prompt input using whichever of aspell, hunspell, or ispell is on your PATH; off by default (v2.1.235) |
Install a checker, then set "spellcheck": { "enabled": true } in ~/.claude/settings.json. User, --settings, and managed settings only — ignored in project settings. See Advanced Features |
| Agent Teams Default Model | The "Default teammate model" /config setting was removed; teammates now inherit the team lead's model by default unless the spawn call specifies one explicitly (v2.1.234) |
See Subagents — Agent Teams |
/design |
Design canvas — a multi-artboard visual design (UI mockups, screen flows, landing pages, posters) built on artifacts and refined visually rather than in code. Research preview; requires v2.1.233+; Pro/Max/Team/Enterprise | Run /design in the CLI or the Desktop app. See Slash Commands |
notify_when_idle |
Cross-session SendMessage input that asks another session on the same machine to send one notice when it next goes idle — opt-in, one-shot, no polling (v2.1.236). Related: ListAgents reports the session's own name and lists live teammates, and Windows gained cross-session messaging (v2.1.239) |
Pass notify_when_idle to SendMessage. See Advanced Features |
| Plugin manifest fields | plugin.json accepts workflows, channels, dependencies (semver), outputStyles, keywords, metadata, lspServers, and experimental.themes / experimental.monitors. CLI gained claude plugin new, remove/rm, prune/autoremove, and the flags --with, -f/--force, --available, --push, --dry-run |
See Plugins |
Quick Reference Matrix
Feature Selection Guide
| Need | Recommended Feature | Why |
|---|---|---|
| Quick shortcut | Slash Command | Manual, immediate |
| Persistent context | Memory | Auto-loaded |
| Complex automation | Skill | Auto-invoked |
| Specialized task | Subagent | Isolated context |
| External data | MCP Server | Real-time access |
| Event automation | Hook | Event-triggered |
| Complete solution | Plugin | All-in-one bundle |
Installation Priority
| Priority | Feature | Command |
|---|---|---|
| 1. Essential | Memory | cp 02-memory/project-CLAUDE.md ./CLAUDE.md |
| 2. Daily Use | Slash Commands | cp 01-slash-commands/*.md .claude/commands/ |
| 3. Quality | Subagents | cp 04-subagents/*.md .claude/agents/ |
| 4. Automation | Hooks | cp 06-hooks/*.sh ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.sh |
| 5. External | MCP | claude mcp add github -- npx -y @modelcontextprotocol/server-github |
| 6. Advanced | Skills | cp -r 03-skills/* ~/.claude/skills/ |
| 7. Complete | Plugins | /plugin install pr-review |
Complete One-Command Installation
Install all examples from this repository:
# Create directories
mkdir -p .claude/{commands,agents,skills} ~/.claude/{hooks,skills}
# Install all features
cp 01-slash-commands/*.md .claude/commands/ && \
cp 02-memory/project-CLAUDE.md ./CLAUDE.md && \
cp -r 03-skills/* ~/.claude/skills/ && \
cp 04-subagents/*.md .claude/agents/ && \
cp 06-hooks/*.sh ~/.claude/hooks/ && \
chmod +x ~/.claude/hooks/*.sh
Additional Resources
Last Updated: August 25, 2026 Claude Code Version: 2.1.245 Sources:
- https://code.claude.com/docs/en/sub-agents
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- https://code.claude.com/docs/en/overview
- https://code.claude.com/docs/en/commands
- https://code.claude.com/docs/en/hooks
- https://code.claude.com/docs/en/permission-modes
- https://code.claude.com/docs/en/changelog#2-1-172
- https://code.claude.com/docs/en/changelog#2-1-174
- https://github.com/anthropics/claude-code/releases/tag/v2.1.145
- 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
- https://code.claude.com/docs/en/model-config
- https://code.claude.com/docs/en/skills
- https://code.claude.com/docs/en/plugin-marketplaces
- https://code.claude.com/docs/en/discover-plugins
- https://code.claude.com/docs/en/settings Compatible Models: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5