461 pages for hooks.

Configure your terminal for Claude Code Claude Code CLI · in the page terminal-config …notification event. See [when each notification type fires](/docs/en/hooks.md#notification) for the exact timing. Surfacing this as a terminal bell or desktop notification lets you switch to other wo… Tools reference Claude Code CLI · in the page tools-reference …ent tool lists](/docs/en/sub-agents.md), and [hook matchers](/docs/en/hooks.md). To control which tools Claude can use and when it asks first, configure [permission rules](/docs/en/permissions.md#too… Troubleshoot installation and login Claude Code CLI · in the page troubleshoot-install …ting.md). For configuration problems such as settings not applying or hooks not firing, see [Debug your configuration](/docs/en/debug-your-config.md). ## Find your error Match the error message or s… Troubleshooting Claude Code CLI · in the page troubleshooting …shoot-install.md#login-and-authentication) | | Settings not applying, hooks not firing, MCP servers not loading | [Debug your configuration](/docs/en/debug-your-config.md) | | Session started in auto… Use Claude Code in VS Code Claude Code CLI · in the page vs-code …ection includes entries such as MCP servers, commands, output styles, hooks, memory, instructions, permissions, and plugins. Items with a terminal icon open in the integrated terminal. * To browse… Get started with Claude Code in the cloud Claude Code CLI · in the page web-quickstart …rt hook](/docs/en/cloud-environments.md#setup-scripts-vs-sessionstart-hooks) that launches them in the background, so the session becomes usable while they finish. * Remove long retry sleeps from the… Week 13 · March 23–27, 2026 Claude Code CLI · in the page whats-new/2026-w13 …tool docs](/docs/en/tools-reference.md#powershell-tool) Conditional hooks v2.1.85 Hooks can now declare an `if` field using permission rule syntax. Your pre-commit check only spawns for `Bash(git c… Week 14 · March 30 – April 3, 2026 Claude Code CLI · in the page whats-new/2026-w14 …ed. Handy for packaging CLI helpers next to the commands, agents, and hooks that call them. Add a `bin/` directory at the plugin root: ```text highlight={4, 5} theme={null} my-plugin/ ├── .claude-pl… Week 15 · April 6–10, 2026 Claude Code CLI · in the page whats-new/2026-w15 …directs, and compound commands now prompt correctly`UserPromptSubmit` hooks can set the session title via `hookSpecificOutput.sessionTitle` [Full changelog for v2.1.92–v2.1.101 →](/docs/en/changelog.… Week 16 · April 13–17, 2026 Claude Code CLI · in the page whats-new/2026-w16 …it`, `/review`, and `/security-review` via the Skill tool`PreCompact` hooks can block compaction by exiting with code 2 or returning `{"decision":"block"}``ENABLE_PROMPT_CACHING_1H` opts API key, Amaz… Week 17 · April 20–24, 2026 Claude Code CLI · in the page whats-new/2026-w17 …line selection in the prompt input, with operators and visual feedbackHooks can now call MCP tools directly via [`type: "mcp_tool"`](/docs/en/hooks#mcp-tool-hook-fields), so a hook can hit an already-… Week 18 · April 27 – May 1, 2026 Claude Code CLI · in the page whats-new/2026-w18 …so you can find a skill in a long list without scrolling`PostToolUse` hooks can replace tool output for any tool via `hookSpecificOutput.updatedToolOutput`, not only MCP toolsNew [`claude ultrareview`… Week 19 · May 4–8, 2026 Claude Code CLI · in the page whats-new/2026-w19 …hat should never run automatically even when broader allow rules applyHooks now receive the active effort level via the `effort.level` JSON input field and the `$CLAUDE_EFFORT` environment variable, a… Week 20 · May 11–15, 2026 Claude Code CLI · in the page whats-new/2026-w20 …ver need quotingNew `continueOnBlock` config option for `PostToolUse` hooks feeds the hook's rejection reason back to Claude and continues the turn instead of ending itNew `terminalSequence` field in… Week 21 · May 18–22, 2026 Claude Code CLI · in the page whats-new/2026-w21 …Discover and Browse screens list a plugin's commands, agents, skills, hooks, and MCP/LSP servers before installationNew `worktree.bgIsolation: "none"` setting lets background sessions edit the working… Week 22 · May 25–29, 2026 Claude Code CLI · in the page whats-new/2026-w22 …and re-scans skill directories without restarting, and `SessionStart` hooks can return `reloadSkills: true` to make skills they install available in the same sessionSkills and commands can set `disall… Week 23 · June 1–5, 2026 Claude Code CLI · in the page whats-new/2026-w23 …keyword is highlighted in violet in the prompt[Stop and SubagentStop hooks](/docs/en/hooks.md) can return `hookSpecificOutput.additionalContext` to give Claude feedback and keep the turn going instea… Week 24 · June 8–12, 2026 Claude Code CLI · in the page whats-new/2026-w24 …aunch with all customizations disabled: `CLAUDE.md`, skills, plugins, hooks, MCP servers, and custom commands and agents do not load. Authentication, model selection, built-in tools, and permissions s… Week 28 · July 6–10, 2026 Claude Code CLI · in the page whats-new/2026-w28 …UDE.md` content Claude could derive from the codebase, and flags slow hooks. It reports findings first and asks for confirmation before changing anything. `/checkup` is its alias. Run a checkup from… Week 32 · August 3–7, 2026 Claude Code CLI · in the page whats-new/2026-w32 …hides part of a command from the approval dialogPreToolUse auto-allow hooks no longer bypass tool restrictions in Claude Code's internal side tasks such as summaries and compactionThe [Ultraplan](/doc… Week 35 · August 24–28, 2026 Claude Code CLI · in the page whats-new/2026-w35 …-session-to-another-directory), the new directory's project settings, hooks, `.mcp.json` servers, skills, and subagents take effect immediately instead of on the next `--resume`In non-interactive sess… Week 36 · August 31 – September 4, 2026 Claude Code CLI · in the page whats-new/2026-w36 …lls.md#find-unused-skills) Other wins A [`PreModelSwitch`](/docs/en/hooks#premodelswitch) hook can block a model switch you request, and a [`PostModelSwitch`](/docs/en/hooks#postmodelswitch) hook ca… Week 37 · September 7–11, 2026 Claude Code CLI · in the page whats-new/2026-w37 …t's read-only transcript or stop itIn the VS Code extension, select **Hooks** or **Permissions** in the command menu's Customize section to [add or remove hooks and permission rules](/docs/en/vs-code.… What's new Claude Code CLI · in the page whats-new/index …* block actions unconditionally regardless of allow exceptions; and **hooks see the active effort level** via `effort.level` and `$CLAUDE_EFFORT`. [Read the Week 19 digest →](/docs/en/whats-new/2026-… Orchestrate subagents at scale with dynamic workflows Claude Code CLI · in the page workflows …hook**: return `"allow"` for the call from a [`PreToolUse`](/docs/en/hooks#pretooluse) hook. In [plan mode](/docs/en/permission-modes.md#analyze-before-you-edit-with-plan-mode), the workflow doesn't… Run parallel sessions with worktrees Claude Code CLI · in the page worktrees …lag, subagent isolation, `.worktreeinclude`, cleanup, and non-git VCS hooks. A [git worktree](https://git-scm.com/docs/git-worktree) is a separate working directory with its own files and branch, sha… Configure GitHub access Claude Documentation · in the page claude-tag/admins/configure-github …ls in `.claude/skills/` load, so Claude can use them in the session [Hooks](https://code.claude.com/docs/en/hooks) in a repository's `.claude/settings.json` don't run in the session. A repository's `… Network requirements Claude Documentation · in the page claude-tag/admins/network-requirements …service | Which hosts a credential may be sent to | ## Events and webhooks Events from connected services, like GitHub activity, are delivered directly to Anthropic, so there is no inbound listener… Claude Tag for Claude Code users Claude Documentation · in the page claude-tag/concepts/for-claude-code-users …aude-tag/admins/configure-github.md#what-loads-from-a-repository) | [Hooks](https://code.claude.com/docs/en/hooks) in the repository's `.claude/settings.json` don't run in the session. ## Local sett… Blend your MCP App with Claude's theme Claude Documentation · in the page connectors/building/mcp-apps/transparent-theming …te. The SDK provides helpers that do the DOM work for you, and React hooks that wrap them: * [`applyDocumentTheme(theme)`](https://modelcontextprotocol.github.io/ext-apps/api/functions/app.applyDocu… Changelog Claude Documentation · in the page cowork/changelog …ion allows skill creation, uploads skills that grant tools or declare hooks, all without asking you to confirm. Before, each local MCP server waited for you to confirm its command and settings. Organi… Install plugins Claude Documentation · in the page cowork/guide/plugins …nstalling one can add skills, MCP connectors, subagents, commands, or hooks in a single step. Plugins come from the marketplace, from your organization, or from a file you upload. A plugin you instal… Publish to the directory Claude Documentation · in the page directory/publish …| :- | | What it is | A plugin folder with skills, commands, agents, hooks, and MCP server references | One remote MCP server that people connect to reach your app or data | | Where it comes from | A… Claude for Government changelog Claude Documentation · in the page government/changelog …n for them. **Claude Code 2.1.299** 2026-10-14 * Changed **Managed hooks** on Windows devices without Git for Windows: on Claude Code 2.1.299 or later, a managed hook written as a Bash command that… Manage plugins and connectors Claude Documentation · in the page government/config/plugins-and-connectors …. It can add skills, slash commands, and sub-agents, and it can carry hooks, which are scripts a plugin author includes to run automatically at defined points during a session, such as when a session… Available settings Claude Documentation · in the page government/config/settings …Bash and PowerShell tools. | None blocked | Claude Code | | **Managed hooks** | [Hooks](https://code.claude.com/docs/en/hooks) that run in every member's Claude Code sessions, such as a command that w… Connect Claude Code to Claude for Government Claude Documentation · in the page government/deploy-claude-code/configure …se settings replace the Claude Code policy in these managed settings, hooks and permission rules included, apart from the two sign-in keys, any `env` variables the organization's settings leave unset,… Plugins in Claude Desktop Claude Documentation · in the page government/desktop/plugins …ude in a single step, such as skills, slash commands, sub-agents, and hooks. Plugins work in Cowork and in Code. See the [Plugins overview](/docs/plugins/overview.md) for more on what a plugin can con… Security and data handling Claude Documentation · in the page government/security/security-and-data-handling …instead of the Claude Code policy in those managed settings, such as hooks and permission rules, apart from the [keys Claude Code reads from every admin source](https://code.claude.com/docs/en/manage… Manage plugins for your organization Claude Documentation · in the page plugins/admin …de Desktop on your own model provider, see [MCP, plugins, skills, and hooks](/docs/third-party/claude-desktop/extensions.md) To start, go to [**Organization settings > Plugins & skills**](https://cla… Plugin structure and testing Claude Documentation · in the page plugins/build …imal example; components that only some apps load, such as agents and hooks, are listed after the explorer. What goes in the plugin folder This example plugin, `expense-reports`, has one of each fil… Roll out a plugin to your whole organization Claude Documentation · in the page plugins/org-rollout …audiences, because each surface skips the components it doesn't load. Hooks and agents load in Cowork and Claude Code and not in chat, and a local MCP server doesn't run in chat. Check each component… Sync your organization's plugins from a repository Claude Documentation · in the page plugins/org-sync …nce them as `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` from your [skills, hooks, or MCP server configs](https://code.claude.com/docs/en/plugins/manifest-reference#environment-variables). ## Next steps *… Plugins Claude Documentation · in the page plugins/overview …de, some parts of a plugin also run on your computer: * **Agents and hooks**: run commands on your computer when certain events happen * **A connector marked Runs in each session**: runs a program on… Plugin feature support across platforms Claude Documentation · in the page plugins/platform-support …| Loads | | | Agents (`agents/*.md`) | Ignored | Loads | Loads | | | Hooks (`hooks/hooks.json`) | Ignored | Loads | Loads | [Hooks](https://code.claude.com/docs/en/plugins/components#hooks) in the Cl… Plugin pre-submission checklist Claude Documentation · in the page plugins/pre-submission-checklist …cters | Blocks | | | Spell the keys that declare components, such as `hooks` and `mcpServers`, exactly as the [plugins reference](https://code.claude.com/docs/en/plugins/manifest-reference) does, and… Chat in Claude Desktop on 3P Claude Documentation · in the page third-party/claude-desktop/chat …tions to the user (the `AskUserQuestion` tool). | | Plugin skills and hooks | Skills from the plugins you provision through [organization plugins](/docs/third-party/claude-desktop/extensions.md#organi… Code in Claude Desktop on 3P Claude Documentation · in the page third-party/claude-desktop/code …Claude Code's settings files. Allow rules already in those files, and hooks, keep allowing the tool until someone removes them. For scheduled tasks, see [Tool approvals on scheduled tasks](/docs/third… Configuration reference Claude Documentation · in the page third-party/claude-desktop/configuration …ey set `parentSettingsBehavior` to `merge`. Not covered: MCP servers, hooks, the terminal, commands in `sandbox.excludedCommands`, and git worktrees, which Claude Desktop and Claude Code still create… Features Claude Documentation · in the page third-party/claude-desktop/feature-matrix …op/extensions.md#managed-mcp-servers-admin) > * [Skills, plugins, and hooks](/docs/third-party/claude-desktop/extensions.md) > * [Plugin marketplaces](/docs/third-party/claude-desktop/extensions.md#pl…