Step 1: Install Claude Code

Claude Code is the core tool that powers your agent system. This step gets it installed and running on your Mac.

What you’ll need: Your Mac, an internet connection, and your Anthropic account credentials.

Time: About 20 minutes.

1.1 Install Homebrew (Package Manager)

Homebrew is a tool that makes it easy to install other tools on your Mac. Think of it as an app store for your terminal.

Open your terminal (Cmd + Space, type “Terminal”, press Enter), then type:


/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Press Enter and follow any prompts. You may need to enter your Mac password.

What you should see: After a few minutes, a message saying “Installation successful!”

If something went wrong: If you see “Xcode Command Line Tools not found,” type xcode-select --install first, wait for it to finish, then try again.

1.2 Install Required Tools

Now use Homebrew to install the tools the system needs:


brew install node python3 gh

What you should see: Progress bars for each tool, ending with a summary of what was installed.

Verify they installed correctly:


node --version && python3 --version && gh --version

What you should see: Version numbers for each tool (the exact numbers don’t matter, as long as you see them).

1.3 Install Claude Code


npm install -g @anthropic-ai/claude-code

What you should see: A progress indicator, then a success message.

Verify it works:


claude --version

What you should see: A version number like 1.x.x.

If something went wrong: If you see “permission denied,” avoid sudo. Use a user-level npm global directory instead:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

1.4 Log In to Claude Code


claude

This opens Claude Code for the first time. It will ask you to log in with your Anthropic account.

What you should see: A prompt to authenticate. Follow the instructions on screen — you’ll either be directed to a web page to log in, or asked to paste an API key.

Once logged in, you should see: A welcome message and a prompt where you can type. Type /quit to exit for now.

1.5 Log In to GitHub


gh auth login

Follow the prompts:

Choose “GitHub.com”
Choose “HTTPS”
Choose “Login with a web browser”
Copy the code shown, open the URL, and paste it

What you should see: “Successfully logged in as [your-username]“

1.6 Download the System Files


gh repo clone YOUR-USERNAME/super_agents ~/super_agents

What you should see: Progress as files are downloaded, ending with the repository being cloned to your home folder.

If something went wrong: If you see “repository not found,” make sure you have access to the repository. Contact the person who sent you this link.

Checkpoint

Let’s verify everything from this step:


claude --version && gh auth status && ls ~/super_agents

What you should see:

Claude Code version number
Your GitHub login confirmed
A list of files and folders in the super_agents directory

All good? Move on to Step 2: Set Up Your Vault.

Something wrong? Check the Troubleshooting page or ask Claude for help — just type claude in your terminal and describe what went wrong.