Setup Commands
Copy and paste each command into your terminal. Run them in order from top to bottom.
1. Prerequisites
Install Apple's command line developer tools (required for Homebrew).
Xcode CLI Tools
xcode-select --install
2. Homebrew (Package Manager)
Homebrew is the easiest way to install developer tools on macOS.
Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Fix Homebrew PATH (Apple Silicon Macs)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && eval "$(/opt/homebrew/bin/brew shellenv)"
3. Node.js
Node.js is required to install and run the AI agents.
Install Node.js
brew install node
Fix NPM prefix (avoids permission errors)
npm config set prefix /opt/homebrew
4. Install an AI Agent
Pick the agent you want to install. You only need one to get started.
Install
npm install -g @anthropic-ai/claude-code
Install
npm install -g @google/gemini-cli
Install
npm install -g @openai/codex
5. VS Code Shell Command
Install the code . command so you can open VS Code from the terminal. VS Code must be installed first (see Prerequisites).
1
Open VS Code
2
Press Cmd + Shift + P to open the Command Palette
3
Type Shell Command: Install 'code' command in PATH and select it
4
Restart your terminal. You can now run code . to open the current folder in VS Code.
1. Node.js
Download and install from nodejs.org (choose the LTS version). Or install via winget:
Install Node.js via winget
winget install OpenJS.NodeJS.LTS
2. Verify Installation
Close and reopen your terminal, then check that Node.js is installed:
Check Node.js version
node --version
Check NPM version
npm --version
3. Install an AI Agent
Pick the agent you want to install. You only need one to get started.
Install
npm install -g @anthropic-ai/claude-code
Install
npm install -g @google/gemini-cli
Install
npm install -g @openai/codex
4. VS Code Shell Command
Install the code . command so you can open VS Code from the terminal. VS Code must be installed first (see Prerequisites).
1
Open VS Code
2
Press Ctrl + Shift + P to open the Command Palette
3
Type Shell Command: Install 'code' command in PATH and select it
4
Restart your terminal. You can now run code . to open the current folder in VS Code.