Skip to content

Claude Code security on your Mac

Excellent for Mac is free to scan. It reads Claude Code's logs and shows what it did. With Pro, it checks each action before it runs.

Works with Claude Code

Trademarks belong to their owners; no endorsement implied.

What Excellent sees

Excellent reads Claude Code's session logs in ~/.claude/projects on your Mac, helpers included.

It shows what was done: your email sent to websites or typed into forms, keys sitting in logs, secrets files read, history overwritten, checks skipped. Each finding says which agent and where.

With Pro, while the app runs, it reads Claude Code's logs as they grow, and sends you a notification when something new needs you.

Its key finder checks Claude Code's settings files for keys, and reports its sign-in file without changing it.

What it can stop Pro

This needs Excellent Pro. Free and Pro says what each does.

Turn on protection, and Excellent adds one entry to Claude Code's hook settings in ~/.claude/settings.json, after backing the file up. Claude Code runs it before each action.

It blocks your email on its way to a website, an API key typed into a command, deleting a folder you marked never-delete, and switching Excellent off.

It asks you first before a force push to main, skipping git hooks, typing your email into a web form, or writing over a file you marked never-delete.

Two more rules are off until you turn them on: asking before reading keys and .env files, and asking before breaking a rule you wrote in CLAUDE.md or AGENTS.md.

You can stop a Claude Code session from Excellent's menu. Its actions are refused until you press Continue or End. End stops its process and the commands it was running.

Excellent can also pause a session by itself when it breaks one of four rules: sending your email to a website, deleting or moving a never-delete folder, reading a never-open file, or overwriting history on main. Setup asks about this, with all four ticked.

Tested in Claude Code 2.1.322 on a Mac: the check Turn On adds ran there, refused what it should, and let a harmless command through.

Your rules

You write rules for Claude Code in CLAUDE.md and for Codex in AGENTS.md. Excellent shows which of your rules reach only one of them.

Press Share…, and on your OK it adds the missing ones to the file Claude Code reads: your own ~/.claude/CLAUDE.md, or each repository's CLAUDE.md. It backs the file up first. Take Shared Rules Out… removes them.

With Pro and Remind agents of my rules on, the check refuses an action that would break a rule you wrote in CLAUDE.md or AGENTS.md once, and quotes your rule. Reminders are off by default.

The sandbox Pro

Excellent can write a sandbox from your rules into Claude Code's own settings. Then macOS itself refuses what you closed, however a command is written.

Folders you marked never-delete can't be changed. Files you marked never-open can't be read. Commands can reach only the websites on a list built from your own logs, which you see and agree to.

Setup asks about it, already ticked. You see exactly what will be written, and what may stop working, before anything changes. Turn Off takes it back out.

What isn't covered

  • The check reads what a command says. An agent set on getting around it sometimes can. For files and folders, the sandbox holds however a command is written.
  • A script file run by an interpreter, like python3 cleanup.py, isn't read by the check. With the sandbox on, macOS still refuses what it does to the files and folders you closed.
  • It's one check, added to Claude Code's own settings, that Claude Code runs before each action. It isn't a wall around your Mac.

Set it up

  • Get the Mac app. It needs an Apple silicon Mac and macOS 14 or later. Protection needs Pro.
  • With Pro, open it and press Protect My Agents. It lists what it will change first, then adds its check to ~/.claude/settings.json. Turn On in the menu does the same later.
  • To share your rules with Codex or turn on the sandbox, see the docs below.

Install the Mac appTurn on protectionStop or pause an agentYour rules, sharedThe sandboxThe agents it supports

The other agents

Protect Claude Code on your Mac

Get the Mac app