Shell
iTerm2 Setup for Claude Code Parallel Sessions
Follow this guide to set up iTerm2 for optimal parallel Claude sessions.
1. Enable System Notifications
Step 1: iTerm2 Preferences
- Open iTerm2
- Press Cmd + , to open Preferences
- Go to: Profiles > Terminal
- Check: "Send Notification Center alerts"
Step 2: macOS Notification Settings
- Open System Settings > Notifications
- Find iTerm2
- Enable: Allow Notifications
- Set style to: Alerts (not Banners - you want them to stay)
2. Set Up Numbered Tabs
Create a Profile for Claude Sessions
- iTerm2 Preferences > Profiles
- Click + to add new profile
- Name it: "Claude Session"
- Under General: Set Badge to show session number
- Under Colors: Choose a distinct color scheme
- Under Terminal: Check "Send Notification Center alerts"
Create 5 Default Tabs
- Open 5 tabs (Cmd + T four times)
- Right-click each tab > Edit Tab Title:
- Tab 1: "Claude 1"
- Tab 2: "Claude 2"
- Tab 3: "Claude 3"
- Tab 4: "Claude 4"
- Tab 5: "Claude 5"
- Window > Save Window Arrangement
- Name it: "Claude Workspace"
Auto-Launch Arrangement
- Preferences > General > Startup
- Set: "Open Default Window Arrangement"
- Preferences > Arrangements
- Set "Claude Workspace" as default
3. Shell Aliases
Add these to your ~/.zshrc for quick access:
# Teleport shortcut
alias ct='claude --teleport'
# Quick numbered session launchers
alias c1='echo "Starting Claude 1..."'
alias c2='echo "Starting Claude 2..."'
4. Keyboard Shortcuts
These are usually default in iTerm2:
| Shortcut | Action |
|---|---|
| Cmd + 1 | Select Tab 1 |
| Cmd + 2 | Select Tab 2 |
| Cmd + 3 | Select Tab 3 |
| Cmd + 4 | Select Tab 4 |
| Cmd + 5 | Select Tab 5 |
| Cmd + T | New Tab |
5. Visual Differentiation
Tab Colors
In each tab:
- Right-click tab
- "Edit Session"
- Under "Colors", set a unique tab color per session
6. Daily Workflow
Morning Startup
- Open your Claude Workspace arrangement
- Tab 1: Main development work
- Tab 2: Tests/verification
- Tab 3-5: Ready for parallel tasks
During the Day
- Poll tabs every 10-15 minutes
- Watch for notifications - Claude waiting for input
- Farm out long tasks with ampersand suffix
- Check claude.ai/code for cloud session status
7. Key Commands
| Command | Purpose |
|---|---|
| claude "task" | Start interactive session |
| claude "task" & | Send to cloud, free terminal |
| claude --teleport | Pull cloud session back |
| claude --resume | Resume last local session |
Verification
Open System Settings > Notifications > iTerm2 and confirm:
- Allow Notifications: ON
- Alert style: Alerts
You should now receive notifications when Claude needs your input across any tab.