Follow Discord
Sweep 23 Oct 2026 · 21:48Z Build v2.1.310 529 read Stable v2.1.308 Latest v2.1.310 Next v2.1.310 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Code CLI 25 Sep 2026
One change · claude-code

Plugins in the SDK changedagent-sdk/plugins

Nearest release: v2.1.283, published 4 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Upstream edited this page at 25 Sep 2026 23:42 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 23 Oct 2026 19:07 UTC.

Upstream edited
Recorded here
Lines+8added
Lines−8removed
From line 9 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits9to this page, all time

The whole hunk

from line 9, old and new numbered
/
lines
from line 9
99* **Hooks**: event handlers that respond to tool use and other events
1010* **MCP servers**: external tool integrations via Model Context Protocol
1111 
12For complete information on plugin structure and how to create plugins, see [Plugins](/docs/en/plugins/overview.md).
12For complete information on plugin structure and how to create plugins, see [Plugins](https://code.claude.com/docs/en/plugins/overview.md).
1313 
1414## Loading plugins
1515 
1616Load plugins by providing their local file system paths in your options configuration. The `type` field must be `"local"`, the only value the SDK accepts. The SDK supports loading multiple plugins from different locations.
1717 
18To use a plugin distributed through a [marketplace](/docs/en/plugins/overview.md) or remote repository, download it first and provide the local directory path. For the directory layout a plugin needs, see the [Plugin structure reference](#plugin-structure-reference) below.
18To use a plugin distributed through a [marketplace](https://code.claude.com/docs/en/plugins/overview.md) or remote repository, download it first and provide the local directory path. For the directory layout a plugin needs, see the [Plugin structure reference](#plugin-structure-reference) below.
1919 
2020```typescript TypeScript theme={null}
2121import { query } from "@anthropic-ai/claude-agent-sdk";
from line 301
301301 
302302### Plugin not loading
303303 
304If your plugin doesn't appear in the init message's `plugins` list, check its [`plugin_errors`](/docs/en/agent-sdk/typescript#sdksystemmessage) field for the reason, then work through these checks:
304If your plugin doesn't appear in the init message's `plugins` list, check its [`plugin_errors`](https://code.claude.com/docs/en/agent-sdk/typescript#sdksystemmessage) field for the reason, then work through these checks:
305305 
3063061. **Check the path**: ensure the path points to the plugin root directory, the parent of `skills/`, `agents/`, `hooks/`, `commands/`, or `.claude-plugin/`
3073072. **Validate plugin.json**: if your plugin includes a manifest, ensure it has valid JSON syntax
from line 318
318318 
319319## See also
320320 
321* [Plugins](/docs/en/plugins/overview.md) - Complete plugin development guide
322* [Plugins reference](/docs/en/plugins/manifest-reference.md) - Technical specifications
323* [Commands](/docs/en/agent-sdk/skills.md#dispatch-commands-by-name) - Dispatching commands in the SDK
324* [Subagents](/docs/en/agent-sdk/subagents.md) - Working with specialized agents
325* [Skills](/docs/en/agent-sdk/skills.md) - Using Agent Skills
321* [Plugins](https://code.claude.com/docs/en/plugins/overview.md) - Complete plugin development guide
322* [Plugins reference](https://code.claude.com/docs/en/plugins/manifest-reference.md) - Technical specifications
323* [Commands](https://code.claude.com/docs/en/agent-sdk/skills.md#dispatch-commands-by-name) - Dispatching commands in the SDK
324* [Subagents](https://code.claude.com/docs/en/agent-sdk/subagents.md) - Working with specialized agents
325* [Skills](https://code.claude.com/docs/en/agent-sdk/skills.md) - Using Agent Skills
326326 
Feedback