ClaudeAI Coding Agents

Claude Security for Claude Code: review, how it works and whether it is worth it (2026)

Before you start

  • 10 min read

Boxes marked Run in terminal are what you type; plain text explains why.

What you get in one minute#

Claude Security is Anthropic's own plugin that scans your code for vulnerabilities with a team of agents that try to disprove every finding; it is worth it for a deep check of code you own before a release, but it is expensive in usage and not for everyday use.

Claude Code official logo

Logo: the official Claude Code logo from Anthropic's press kit (anthropic.com/press-kit)

The marketplace page shows 8,580 installs (October 2026). The plugin is in beta.

VerdictDetail
Useful?Niche, but good at that niche. A scoped deep scan before a release; poor as a routine check.
Best forDevelopers and small teams with a paid plan who want a security review of their own repository, with patches they apply themselves.
Skip it ifYour usage limit is tight, you scan code you do not trust (no sandbox), or you only want warnings while you type.
Made byAnthropic, in its official marketplace. The licence is proprietary ("all rights reserved"), not open source.
Version + date0.12.0 (25 September 2026); the repository was read at its 27 October 2026 state.
Install command/plugin install claude-security@claude-plugins-official
Token costNo figure published. Each scan counts toward your usage; users report hitting a 5-hour limit within minutes on large scans.

What it does#

You run /claude-security, pick a job, and a scan writes a report folder into your repository.

JobWhat it scansWhat you get
Scan codebaseThe whole repository or one areaReport, JSONL, SARIF, revision stamp
Scan changesA branch diff, a pull request or one commitSame files, only flaws the change takes part in
Suggest patchesThe findings of a reportOne F<n>.patch per finding you can apply with git apply

Effort tiers are low (one researcher, then the panel), medium (the default) and high (more passes). Added by the plugin: 1 skill, 9 agents, 1 workflow, 4 hook events, 0 MCP servers, one command.

How it works in the background#

One skill runs the conversation, one JavaScript workflow fans the work out to agents, and Python scripts do the counting so the model cannot inflate its own results.

How Claude Security scans your code: a hook shows the banner, the skill opens a menu, you pick scope and effort and confirm, a script stamps the commit, the workflow splits the repository, researchers hunt per component, a panel of three tries to disprove each finding, Python counts the votes and writes the report folder, and optionally patches are written that you apply yourself

  • Steps 5 to 7 run as the claude-security:scan workflow, shown live in /workflows.
  • The panel has three voters with different lenses (reachability, impact, defenses) and a 2-of-3 rule. Their instruction starts with "Default to FALSE_POSITIVE."

Under the hood: dissection#

About half the plugin is Python (208 KB) that does bookkeeping and reporting, and half is Markdown prompts (194 KB) that tell the agents how to behave. We read all 46 files at commit ca08d5e.

The file tree#

Codetext
claude-security/
├── .claude-plugin/plugin.json       name, version 0.12.0, author Anthropic
├── hooks/
│   ├── hooks.json                   4 hook events
│   ├── hooks.sh                     picks a Python 3.9+ and runs hooks.py
│   └── hooks.py                     banner, usage counts, scan tip, 60 s timeout
├── skills/claude-security/
│   ├── SKILL.md                     the front-desk menu
│   ├── role.md                      the "Security Lead" rules
│   ├── jobs/ scan-codebase.md, scan-changes.md, suggest-patches.md
│   └── specs/ report-spec.md, patch-spec.md
├── agents/                          9 agents (below)
├── workflows/scan.js                the scan pipeline, minified, 60 KB
├── scripts/
│   ├── write_scan_meta.py, save_result.py, render_report.py, patch_artifacts.py
│   ├── keep-waiting.sh
│   └── lib/                         14 helpers (SARIF, CWE, findings, strict JSON)
├── README.md, SECURITY.md, NOTICE.md, LICENSE

What each file is#

FileLanguageWhat it doesWhen it runs
hooks/hooks.json, hooks.sh, hooks.pyJSON, shell, PythonBanner, usage counts, scan tip, cost-question timeoutMenu opens, after Bash, on questions
SKILL.md, role.md, jobs/*.md, specs/*.mdMarkdownThe menu, the rules, one recipe per job, report and patch formatsWhen you run the command
agents/*.mdMarkdown9 agents (researcher, verifier, inventory, redactor, patch writer ...)Dispatched by the workflow
workflows/scan.jsJavaScriptSizes the scan, runs researchers and the panelDuring a scan
scripts/*.pyPythonStamp the commit, tally votes, render files, build patchesBetween agent steps

Two key excerpts#

hooks/hooks.json (shortened) runs a tip after a push or a new pull request:

File contentjson
"PostToolUse": [{ "matcher": "Bash", "hooks": [
  { "command": "sh \"${CLAUDE_PLUGIN_ROOT}/hooks/hooks.sh\" tip push || true",
    "if": "Bash(git push *)", "timeout": 5 } ] }]

agents/scan-verifier.md: tells each voter to "try to disprove it".

Models, disk and network#

  • Models: most agents use your session model; inventory, loader, redactor and explore use Sonnet.
  • Writes: one CLAUDE-SECURITY-<time>/ folder and scratch clones for patches.
  • Network: none in the scripts; the optional pull-request list uses gh if allowed.
  • Needs: python3 3.9+, git for change scans and patches, dynamic workflows.

A horizontal bar chart of the size of the Claude Security plugin by language at version 0.12.0: Python 208.1 KB, Markdown prompts 194.2 KB, JavaScript 60.5 KB, a CWE data table 30.0 KB, shell 2.9 KB, JSON manifests 2.9 KB and licence and git settings 1.7 KB

Chart: file sizes in plugins/claude-security at commit ca08d5e, read in October 2026.

What users say#

18 reports read: 2 praise, 5 mixed or neutral, 11 complaints, and the split is skewed. Reddit was not read; one Medium post was blocked (403), so only its title counts.

A bar chart of how the 18 Claude Security user reports lean: 2 praise, 5 mixed or neutral and 11 complaints, from GitHub issues and blogs between July and October 2026

Chart: our count of the 18 reports, July to October 2026. Not a satisfaction rate.

A horizontal bar chart of the 11 complaints by theme: 3 about the Workflow tool not being available, 2 about the Agent tool being dropped inside the workflow, 2 about cost and scale, 2 plugin not found or unclear, 1 wrong diff scanned and 1 cyber safeguards flagging the session

Chart: themes of the 11 complaints, labelled by DIY Lab Hub.

VoiceWhat they say
PraiseA hands-on writer (September 2026) scanned an old codebase and calls it better than rule-based scanners; the page is paywalled.
CostA Classmethod test (July 2026) hit the 5-hour limit in about 15 minutes; one GitHub report (July 2026) saw 95 agents over 2.5 hours on 208 files.
Cannot runIssue 4415 (July 2026): the Workflow tool is missing; issue 104581 (October 2026) is the same after a restart.
FixedIssue 92317 (September 2026): a change scan read the wrong diff; Anthropic says 0.12.0 fixes it.

Pros: why it is useful#

It looks for real attack paths and shows its work, which is what you want from a security review.

  • Short reports: a finding must survive three verifiers and a 2-of-3 vote, so you read fewer false alarms (Anthropic's claim; no independent false-positive rate exists).
  • Honest numbers: Python computes the tally, and the report lists what was not examined.
  • Safe by design: it never applies, commits or pushes; patches are built in a scratch clone and reviewed.
  • Free to install, runs on your own checkout, also on Bedrock, Vertex and Foundry.

Cons: why it is not useful#

It is a heavy, beta tool that can eat a day's usage, and it is not a sandbox.

  • Cost is unpredictable: verifiers scale with candidates and there is no time limit (a maintainer says this is intended).
  • Setup friction: Workflow tool problems blocked several first runs.
  • Nondeterministic: two scans can differ.
  • No isolation: a hostile repository's .claude/ hooks apply as usual (its SECURITY.md says so).
  • Overlaps with /security-review and security-guidance; no SAST replacement.

Should you consider it? When it is useful#

Consider it for a scoped deep scan of your own code before a release or a big merge, and skip it as a daily tool. Start with one area or one branch diff.

A decision flowchart for installing Claude Security: if the code is not yours, sandbox the session first; without a paid plan or API and Python 3.9 it will not run yet; if you cannot spend a large share of your usage scan one area at low or medium or only a branch diff; if you need a deep review before a release install it, otherwise try security-guidance or the security-review command

SituationVerdict
Release or audit of your own repositoryInstall; scan area by area
Everyday warnings while Claude writes codeSkip; use security-guidance
A third-party repository you do not trustOnly inside a sandbox
Tight usage limitSkip, or low on one folder

Install and check it#

You install it from Anthropic's official marketplace with one command.

Linux#

Inside Claude Code:

Codetext
/plugin install claude-security@claude-plugins-official
/reload-plugins

Check python3 --version shows 3.9 or newer first.

Windows (PowerShell)#

Make sure python3 runs, then start claude and enter the same two lines. Hooks start with sh, so install Git for Windows if the menu warns (our reading, not tested).

Run in terminalpowershell
python3 --version
claude

Mac (Terminal)#

Run in terminalbash
python3 --version
claude

Then enter the install lines from the Linux section at the prompt.

Check it worked#

Run /claude-security: a banner and a three-option menu appear. Run /model first (the README recommends Opus 5.5 or Fable 5.1). A cheap first test: /claude-security scan my branch at low.

Things to keep in mind#

  • Security. It runs under your permissions with no isolation. Sandbox untrusted code (sandbox-runtime).
  • Secrets. A model masks credentials in the report on a best-effort basis; read it before sharing.
  • Privacy. Usage counts go through Claude Code telemetry; DISABLE_TELEMETRY=1 stops them, CLAUDE_SECURITY_SCAN_TIP=off stops the push tip.
  • Licence. Proprietary: internal use with Anthropic products only.
  • Updates. No version pin, so it auto-updates; behaviour changed between 0.10 and 0.12.

Troubleshooting#

ProblemSolution
Marketplace "claude-plugins-official" not found/plugin marketplace add anthropics/claude-plugins-official, then install again.
Plugin "claude-security" not found in marketplace "claude-plugins-official"/plugin marketplace update claude-plugins-official, then retry.
Menu warns it needs python3 3.9 or newerPut a newer python3 first on PATH, start a new session.
No such tool available: Workflow. Workflow is not available inside subagents.Run /claude-security in your main session, not as a subagent; on Pro turn on Dynamic workflows in /config.
The scan pipeline is unavailable in this session (it needs the Workflow tool)Same fix; if it persists, see issue 104581.
No answer after 60 seconds, so nothing was run.Run the scan again and answer the cost question.
Usage limit hit very fastScan one area, use low, or scan only a branch diff.

FAQ#

Is this the hosted Claude Security product? No. That one is for Enterprise and can use Claude Mythos; the plugin uses your Claude Code models.

Does it change my code? No. It writes a report folder and, if you ask, patch files you apply yourself.

How is it different from security-guidance? That plugin warns while Claude writes code; this one does an on-demand deep scan.

Does my code leave my machine? The model in your session reads it, as in any Claude Code work; the scripts open no connections.

Sources#

Not run by DIY Lab Hub: we read the files and docs but did not install the plugin or run a scan.

Checked against the official docs on 2026-10-27