Installs

Install the Claude Ads plugin in Claude Code.

Claude Ads installs as a plugin inside Claude Code. No signup, no account access, no upload. It runs locally on your machine, free and open-source.

Quick install · Claude Code
/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

What gets installed

Claude Ads installs as a native Claude Code plugin: a set of skills and slash commands that live on your machine alongside Claude Code. There is no separate app to run, no account to create, and no OAuth handshake with your ad platforms.

It works anywhere Claude Code runs: macOS, Windows, and Linux. Claude Code is the only prerequisite. No account access means no ad-platform login screen, OAuth grant, refresh token, or background connector owned by Claude Ads. You choose the inputs for each audit: exported reports, screenshots, pasted metrics, or an MCP connection you control.

The marketplace install places the plugin in Claude Code’s local plugin directory, so Claude Code resolves commands on this machine. To update, re-run the marketplace install when a new release ships. Teams that need repeatable environments can pin the tagged release or repository version they install, which keeps the setup portable across work laptops and CI-like environments without anyone sharing ad-account credentials. If a command does not appear after install, use the troubleshooting and verification steps below before reinstalling.

When you run /ads audit, the audit executes locally against the data you provide. Nothing about your accounts is uploaded to a Claude Ads server, because there isn’t one. Pick whichever install path below fits your setup; they all land at the same place.

Prerequisites

What you need first.

  • Claude Code CLI

    Required

    Claude Ads installs as a plugin inside Claude Code. That's the only hard requirement.

  • CPython 3.11 or 3.12

    Recommended

    Managed dependencies support CPython 3.11 and 3.12 on the declared Linux, macOS, and Windows wheel matrix. Unsupported interpreters fail before anything changes.

  • Playwright browser payload

    Optional

    Browser capture requires an operator-installed Playwright browser payload.

  • WeasyPrint + Pango

    Optional

    PDF report rendering requires the host's WeasyPrint and Pango system libraries.

  • --no-deps install

    Optional

    Use --no-deps (or -NoDeps on PowerShell) for a skill-only install that skips the managed Python dependencies.

Install

Pick your install path.

The plugin marketplace is the quickest route inside Claude Code. A local clone or a checksum-verified release archive gives you the same managed install. Claude Ads never asks you to pipe a remote installer to a shell.

Run these inside Claude Code. The native plugin flow registers Claude Ads with namespace isolation and version tracking.

Claude Code
/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Clone the public repository and run the installer from the local checkout. Best if you want to read or edit the skills yourself.

macOS / Linux
git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local
Windows PowerShell
git clone https://github.com/AgriciDaniel/claude-ads.git
Set-Location claude-ads
.\install.ps1 -Source local

Standalone hosts other than Claude Code are selected explicitly. Use --no-deps for a skill-only install:

Other hosts
bash install.sh --target=codex --source=local
bash install.sh --target=gemini --source=local --no-deps

Prefer a tagged release archive with a verified SHA-256 checksum when you cannot use the plugin flow or a git clone. Verify before you extract; a failed check means do not install.

macOS / Linux
# Download the v2.0.1 archive and its SHA-256 checksum
# from https://github.com/AgriciDaniel/claude-ads/releases
sha256sum --check claude-ads-v2.0.1.tar.gz.sha256
tar -xzf claude-ads-v2.0.1.tar.gz
cd claude-ads
bash install.sh --source=local

Uninstall removes only files owned by the installation manifest, so your other skills and projects are never touched.

macOS / Linux
bash uninstall.sh --target=claude

The PowerShell equivalent is uninstall.ps1.

Public vs Pro early access

These commands use the public AgriciDaniel/claude-ads repo, MIT-licensed, no membership required. Pro members get early access through the AI-Marketing-Hub mirror, which needs gh auth login with org access. If /plugin marketplace add returns a 404, ask in the Skool community to be added.

Verify

Confirm it's working.

The installer records every file it owns in an ownership manifest, so the install itself is verifiable. In Claude Code, run:

Claude Code
/ads validate
/ads status

Validate checks contracts, capabilities, and the installation against the ownership manifest. Status shows the current state and the highest-priority blocker.

Troubleshooting

Command not found

Restart Claude Code after installing so it picks up the new plugin, then run /ads status.

Managed dependencies fail

Managed dependencies need CPython 3.11 or 3.12. Re-run the installer with --no-deps (or -NoDeps) for a skill-only install.

Capture or PDF features missing

Browser capture needs an operator-installed Playwright browser payload. PDF rendering needs the host's WeasyPrint and Pango libraries.

More answers in the docs & FAQ