Installation Guide

Get Claude Owl up and running in minutes

📋 System Requirements

  • ✓ macOS 10.15 (Catalina) or later
  • ✓ 4 GB RAM minimum (8 GB recommended)
  • ✓ 200 MB free disk space
  • ✓ Intel or Apple Silicon processor
1

Download Claude Owl for macOS

Choose the version that matches your Mac's processor

Apple Silicon (M1/M2/M3)

For Macs from 2020 onwards

Download ARM64

Intel Processor

For Macs before 2020

Download x64

💡 Not sure which version? Click → About This Mac → look for "Chip" (Apple M1/M2/M3 = ARM64, Intel = x64)

2

Install the Application

Simple drag-and-drop installation

  1. 1.

    Open the downloaded .dmg file

    It should be in your Downloads folder

  2. 2.

    Drag Claude Owl to Applications

    A window will appear with the app icon and Applications folder

  3. 3.

    Wait for the copy to complete

    This usually takes a few seconds

  4. 4.

    Eject the disk image

    Right-click the disk image icon and select "Eject"

3

Launch Claude Owl

First-time setup and security approval

  1. 1.

    Open Applications folder

    Press ⌘ + Shift + A in Finder

  2. 2.

    Double-click Claude Owl

    The app will start launching

⚠️ macOS Security Warning

When you first open Claude Owl, macOS may show this warning:

"Claude Owl cannot be opened because the developer cannot be verified."

This is normal for unsigned apps. Here's how to open it:

Option 1:

Right-click and Open

  1. 1. Right-click (or Control-click) the Claude Owl icon
  2. 2. Select "Open" from the menu
  3. 3. Click "Open" in the dialog that appears
Option 2:

System Settings

  1. 1. Open System Settings (or System Preferences)
  2. 2. Go to Privacy & Security
  3. 3. Scroll down to see the security warning
  4. 4. Click "Open Anyway"

🚨 "App is damaged" error?

If you see "Claude Owl is damaged and can't be opened" or "You should move it to the Trash", this is a macOS security restriction on unsigned apps downloaded from the internet.

✅ Verified Fix: Run this Terminal command after dragging Claude Owl to Applications:

xattr -r -d com.apple.quarantine "/Applications/Claude Owl.app"

This removes the download quarantine flag. After running this command, Claude Owl will launch normally.

📝 Why does this happen? Claude Owl is currently distributed without Apple code signing (which costs $99/year). macOS automatically quarantines downloaded unsigned apps and prevents them from launching. Code signing will be added in a future version.

✅ Next Steps

Once Claude Owl is running, you can:

  • • Manage Settings: Edit user and project-level Claude Code configurations
  • • Configure MCP Servers: Browse and install Model Context Protocol servers
  • • Edit Permission Rules: Use the visual editor to manage file access rules
  • • Customize Status Line: Apply templates to your Claude Code status line

Need help or found a bug?

Report an Issue Ask a Question