> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerodrift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Plugin

> Check what Claude writes against your ZeroDrift policies before it goes out. Install in Claude Code, sign in once, and see how it works, what is checked, what each result means, and what to do next.

> [!NOTE]
>
> The Claude plugin is in preview. Behavior and availability may change as we update it.

The ZeroDrift plugin checks drafts Claude writes against your company policies. ZeroDrift finds problems and never rewrites your text. It works in Claude Code. In claude.ai and the Claude desktop app you can add it as a connector for on-request checks. See [Choose your path](#choose-your-path).

The plugin installs from the GitHub repository `ZeroDriftAI/zerodrift-claude-plugin`, which Claude Code adds as a marketplace. See the [changelog](https://docs.zerodrift.com/changelog.md) for the current version and what changed.

## Choose your path

The steps below are for Claude Code. Check where you work first.

| Where | What works |
| - | - |
| Claude Code (terminal, IDE extensions, the desktop app's Code tab) | Everything on this page. |
| claude.ai and the Claude desktop app | On-request checks only, through a custom connector. Add `https://mcp.zerodrift.ai/mcp` as the connector URL. Sends are not checked there. |
| Cowork | Not supported yet. |
| Codex | A separate plugin. See [ChatGPT and Codex Plugin](https://docs.zerodrift.com/codex-plugin.md). |

## Before you start

* A ZeroDrift Command account in the workspace whose policies you want to use.
* A ZeroDrift role that can install the plugin, grant OAuth consent and access the workspace: workspace Admins, Owners and Developers.
* Claude Code v2.1.275 or later for the one-command install. Check yours with `claude --version`.

## Set up

**1. Install the plugin**

```bash theme={null}
/plugin install zerodrift --marketplace ZeroDriftAI/zerodrift-claude-plugin
```

Claude Code opens the plugin's details. Choose an install scope to finish.

**2. Sign in to ZeroDrift**

```bash theme={null}
/mcp
```

Select **zerodrift**, then choose **Authenticate**. In the browser, sign in to ZeroDrift Command and select **Approve**. You never copy or paste an API key.

**3. Confirm the connection**

```bash theme={null}
/zerodrift:status
```

A signed-in install reports that it is connected and how many rules are active. It checks no text. In ZeroDrift Command, open **Connections**. Under **Enforcement surfaces**, the **Claude Plugin** card also shows **Connected** and when the plugin last ran a check.

> [accordion] Older Claude Code: install in two steps
>
> If `/plugin install` rejects `--marketplace`, add the marketplace first, then install from it. Run the commands one at a time.
>
> ```bash theme={null}
> /plugin marketplace add ZeroDriftAI/zerodrift-claude-plugin
> ```
>
> ```bash theme={null}
> /plugin install zerodrift@zerodrift
> ```
>
> `ZeroDriftAI/zerodrift-claude-plugin` is the GitHub repository that holds the plugin. `zerodrift` is the name of the marketplace it adds.

To update, disable or uninstall the plugin, open `/plugin` in Claude Code.

## How it works

ZeroDrift does not connect to your mailbox, open your PDFs, or build a connector for each system you use. Claude already does that. ZeroDrift can validate any content, or plugin reference content, that Claude has access to. If Claude can read it, Claude can hand it to ZeroDrift. Claude formats the text itself so that it passes the validation API.

1. You ask Claude for a task in plain language, such as "pull my last 20 emails and run them through ZeroDrift".
2. Claude gets the content with its own access: an email connector, a file you share, or another connector you connected to Claude.
3. Claude sends the text to the ZeroDrift `validate` tool.
4. ZeroDrift checks the text against your active rules and returns the outcome and each flagged line, with the rules it breaks.
5. Claude shows you the result and explains each flagged line.

The agent is the interface. ZeroDrift is the validation engine behind it, and it is the same engine for every source.

### What to expect

* **Detection only.** ZeroDrift flags text and never rewrites it. When Claude rewrites text, that is Claude's wording, and ZeroDrift has not checked it until you validate it again. See [Draft, Validate, Rewrite](https://docs.zerodrift.com/guides/claude-plugin/draft-validate-rewrite.md).
* **Your workspace's active rules.** The result depends on the rules active in your ZeroDrift workspace, so the same text can pass in one workspace and be flagged in another.
* **One `validate` call per piece of content.** The guides call the plain `validate` tool once per email, document or draft. They do not use the batch processor API.

## Check a draft

Run the command with your text, or ask Claude to check a draft:

```bash theme={null}
/zerodrift:validate Your investments are guaranteed to outperform the market this year.
```

Claude shows the outcome and next step, then each flagged line with a short quote and the rules it breaks.

The result depends on the rules active in your workspace. The same text can pass in one workspace and be flagged in another.

## What gets checked

| What | When | A do-not-send verdict is |
| - | - | - |
| Gmail send, reply, forward and draft actions. Slack send, draft and schedule actions. The `send_message`, `reply`, `forward`, `create_draft` and `update_draft` tools of other connectors. | Automatically, before the action runs | **Blocked**: the action is stopped |
| Any draft you give Claude | When you run `/zerodrift:validate` or ask Claude to check it | **Flagged**: nothing is stopped |
| Outlook, Microsoft Teams (including short replies), Google Drive documents, public web content | When Claude drafts, replies or publishes. Claude decides when to run the check. | **Flagged**: Claude holds the content, including Google Drive writes and sharing, until you decide |

Not checked:

* Attachments as files. ZeroDrift validates text, not files directly. See [Limits](#limits).
* The original message of a forward.
* Drafts you saved earlier and send as-is.
* Connectors other than those above.

## Read a result

| Result | What it means | What happens |
| - | - | - |
| **Passed** | No rule was broken. | The action goes through. |
| **Warned** | Findings to review, but none that say do not send. | The action goes through. |
| **Blocked** | A do-not-send finding in an automatic pre-send check. | The action is stopped. |
| **Flagged** | A do-not-send finding in an on-request check, or a check Claude ran on its own. | Nothing is stopped. Claude holds the content and waits for you. |
| **Not checked** | The check could not run: not signed in, service unreachable, or check unavailable. | The action goes through. Claude Code shows a hook error or a not-checked notice. |

Claude shows each result like this:

**ZeroDrift: Flagged — fix before sending (3 issues on 2 lines: 2 do not send, 1 caution)**

Line 3: "Your investments are guaranteed to outperform the market this year."

| Severity | Rule | Policy |
| - | - | - |
| Do not send | Missing risk disclosure | US Securities & Investment Communications |
| Do not send | Performance disclaimer missing | US Securities & Investment Communications |

Line 5: "Let's lock this in before the window closes."

| Severity | Rule | Policy |
| - | - | - |
| Caution | Urgency pressure tactics | US Marketing Channel Mechanics |

The header counts issues, and one line can carry more than one. Here line 3 has two do-not-send issues and line 5 has one caution.

### What to do next

1. Read the flagged lines. Claude adds a sentence on why each may break the listed rules.
2. Edit the draft. Claude suggests new wording only if you ask, and ZeroDrift has not checked that wording until you check it.
3. Check it again, or send it. For a **Blocked** send, edit the message and run the send again. The pre-send check runs each time.

Other details:

* Up to 20 flagged lines are listed. The rest are summarized by rule.
* Every check also appears in Activity in ZeroDrift Command. Activity shows who ran it, and the Claude model for on-request checks.

## Commands

| Command | What it does |
| - | - |
| `/plugin install zerodrift --marketplace ZeroDriftAI/zerodrift-claude-plugin` | Install the plugin |
| `/mcp` | Sign in, sign in again, or **Clear authentication** to sign out |
| `/zerodrift:status` | Confirm you are signed in and show the active rule count |
| `/zerodrift:validate <draft>` | Check a draft now |
| `/plugin` | Update, disable or uninstall the plugin |

## Troubleshoot

| What you see | What to do |
| - | - |
| `/zerodrift:validate` or `/zerodrift:status` is not found | The plugin is not installed, or Claude Code has not loaded it. Install it, then restart Claude Code. |
| `/zerodrift:status` asks you to sign in | Run `/mcp`, select **zerodrift**, and choose **Authenticate**. |
| You cannot approve access in the browser | Sign-in uses OAuth. In ZeroDrift, workspace Admins, Owners and Developers can approve access. Ask one of them to approve. |
| Claude Code shows a hook error or a not-checked notice | The check did not run, so the message went through. Run `/zerodrift:status`, sign in again if asked, then retry. |
| `/plugin install` rejects `--marketplace` | Update Claude Code to v2.1.275 or later, or use the [two-step install](#set-up). |
| A send went through unchecked in claude.ai or the desktop app | Sends are not checked there. Only on-request checks work through the connector. Use Claude Code for checks before a send. |
| Checks stopped after you disconnected in Command | Disconnecting ends every sign-in for your user. Run `/mcp` and authenticate again. |

Still stuck? Email [support@zerodrift.ai](mailto:support@zerodrift.ai).

## Disconnect

* **Connections → Enforcement surfaces → Claude Plugin → Manage → Disconnect** ends every sign-in for your user in this workspace.
* **Clear authentication** in `/mcp` signs out that Claude Code install.

Either way, Claude Code asks you to sign in again before the next check.

Signing in creates an API key that the plugin manages for you, and you never handle it. You can't rotate it. To cut off access, disconnect.

## Limits

* **Only the text Claude sends is checked.** Claude decides what to send and formats it for the validation API, so it may condense long messages or leave out parts such as promotional links. ZeroDrift checks the text it receives. Anything Claude leaves out is not checked.
* **Attachments.** ZeroDrift validates text, not files directly. To check an attachment, ask Claude to extract and format its contents for validation. Only the text Claude sends is checked.
* **Rate limit.** 50 requests per minute for a single validation.

## Data sent

| | |
| - | - |
| **What** | The text being checked (subject and body for connector actions) and, for on-request checks, the Claude model. Recipients are not sent. Attachments are not sent as files; see [Limits](#limits). |
| **Where** | `https://mcp.zerodrift.ai` over HTTPS, under your ZeroDrift sign-in. ZeroDrift records each check under your user and workspace. |
| **When** | Only for the checks above, including checks Claude runs on its own for Outlook, Teams, Google Drive and web content. |
| **Retention** | See [Data retention](https://docs.zerodrift.com/data-retention.md). |
| **Returned to Claude** | The outcome and each finding's severity, rule, policy and quoted text. No scores, reasoning or rewrites. |

Claude Code stores the sign-in in your operating system's secure store and refreshes it.

## Next steps

> [card] [Validate Recent Email](https://docs.zerodrift.com/guides/claude-plugin/validate-email.md)
>
> Ask Claude to pull your latest emails and check each one.

> [card] [Validate a PDF](https://docs.zerodrift.com/guides/claude-plugin/validate-pdf.md)
>
> Claude extracts the text. ZeroDrift flags it line by line.

> [card] [Validate Marketplace Connector Content](https://docs.zerodrift.com/guides/claude-plugin/validate-connector-content.md)
>
> Check content from another connector, such as Salesforce. Not tested in general.

> [card] [Draft, Validate, Rewrite](https://docs.zerodrift.com/guides/claude-plugin/draft-validate-rewrite.md)
>
> Write a message, check it, fix it, and check it again until it passes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.