Skip to main content
Asymptote hooks into the Claude Code CLI (and the Claude Code extension in VS Code) to automatically evaluate every file edit against your security policies as Claude works.

​
Prerequisites

  • Asymptote CLI installed (asym command)
  • Claude Code installed (claude command), or the Claude Code VS Code extension
  • Logged in to your Asymptote account (asym login)

​
Setup

1

Install the Asymptote CLI

Install the CLI via Homebrew:
brew install asymptote-labs/tap/asymptote-cli
Then log in:
asym login
2

Install the Asymptote plugin for Claude Code

Run the install command. By default, the plugin is installed at the user level and applies to all projects:
asym claude install
To install for the current project only:
asym claude install --project
If you’re running Claude Code inside VS Code, use the --vscode flag instead:
asym claude install --vscode
3

Start Claude Code

Run claude as normal. Asymptote will evaluate every file edit against your security policies automatically. No changes to your workflow are required.

​
How it works

Once installed, Asymptote registers four hooks via Claude’s plugin system:
HookPurpose
SessionStartInitializes the session and performs cleanup
PostToolUseSubmits diffs for async security evaluation
StopPolls results and re-prompts Claude on violations
SessionEndFinal cleanup
Claude will automatically remediate any policy violations before finishing its response.

​
Secure by Design

Asymptote includes an optional Secure by Design mode for Claude Code. When enabled, Asymptote injects your active security policies into Claude’s context during the UserPromptSubmit hook, before any code is written. This makes Claude security-aware from the first prompt rather than catching violations after they’re generated. To enable it: 
asym config set secure-by-design true
To check the current value: 
asym config get secure-by-design
See the CLI config reference for more details.

​
Uninstalling

To remove the Asymptote plugin from Claude Code: 
asym claude uninstall
To remove project-level only: 
asym claude uninstall --project
To remove hooks installed for Claude Code in VS Code: 
asym claude uninstall --vscode

​
Next steps

Cursor

Set up Asymptote for Cursor IDE.

GitHub Copilot

Set up Asymptote for GitHub Copilot in VS Code.

Factory

Set up Asymptote for Factory’s Droid agent.

CLI reference

Full reference for the asym claude command.