Setting Up Beam for Claude Code Development
Claude Code has changed how many developers work. Instead of manually writing code, you describe what you want and Claude builds it. But if you're running multiple Claude Code sessions across different projects, things get messy fast.
This guide shows you how to set up Beam as your command center for Claude Code development — organized, efficient, and keyboard-driven.
Why You Need a Better Setup
A typical Claude Code workflow involves:
- Multiple projects, each with its own Claude Code session
- Dev servers running alongside your AI sessions
- Git operations, tests, and build commands
- Maybe SSH connections to staging/production
In a regular terminal app, this means 15+ tabs all named "zsh" with no way to quickly find anything. You waste time hunting for the right tab instead of coding.
Beam fixes this with workspaces (grouped terminals by project), layouts (save and restore your entire setup), and keyboard navigation (jump anywhere instantly).
Step 1: Install Beam
Download Beam from getbeam.dev and drag it to your Applications folder. Launch it, and you'll see your first workspace with a terminal ready to go.
Step 2: Create Workspaces for Each Project
The key concept in Beam is the workspace — a separate floating window that contains tabs for a specific project or context.
1Press ⌘N to create a new workspace.
2Press ⌘I to rename it (e.g., "Backend API").
3Repeat for each project you're working on.
Example Setup
- Workspace 1: "Backend API" — Your Node/Python/Go API project
- Workspace 2: "Frontend" — Your React/Vue/Next.js app
- Workspace 3: "Infrastructure" — Docker, K8s, deployment scripts
Step 3: Set Up Tabs Within Each Workspace
Each workspace can have multiple tabs. For a Claude Code workflow, I recommend this structure:
Backend API Workspace
- Tab 1: "Claude" — Your Claude Code session (
claude) - Tab 2: "Server" — Dev server running (
npm run dev) - Tab 3: "Git" — Git operations and commits
To create tabs:
- ⌘T — New tab
- ⌘⇧I — Rename current tab
Now when Claude Code makes changes, you can quickly switch to your Server tab to see the results, then to Git to commit.
Step 4: Use Split Panes for Side-by-Side Views
Sometimes you want to see Claude Code output while watching your server logs. Split panes let you do this within a single tab.
- ⌘D — Split vertically (side by side)
- ⌘⇧D — Split horizontally (top/bottom)
- ⌘\ — Label the split pane
- ⌘⌥W — Close a split
Pro Tip: Claude + Logs Side by Side
Create a split pane with Claude Code on the left and tail -f on your log file on the right. Watch Claude make changes and see the server respond in real-time.
Step 5: Save Your Layout
Once you have your workspaces, tabs, and splits arranged perfectly, save it as a layout:
1Press ⌘S to save layout.
2Give it a name like "Full Stack Dev" or "Claude Code Setup".
Tomorrow, when you start working, press ⌘⇧L to load your layout. Everything is restored exactly as you left it — workspaces, tabs, positions, even the terminal history.
Step 6: Master the Keyboard Shortcuts
The real power of Beam is keyboard navigation. Once you learn these, you'll never hunt for a terminal again:
| Shortcut | Action |
|---|---|
| ⌘1 - ⌘9 | Jump to workspace 1-9 |
| ⌘P | Quick switcher (fuzzy search everything) |
| ⌘⌥← / ⌘⌥→ | Jump between workspaces |
| ⌘⇧← / ⌘⇧→ | Switch tabs within workspace |
| ⌘⌥↑ / ⌘⌥↓ | Navigate between split panes |
Step 7: Optimize Your Claude Code Workflow
Here are some workflow tips specifically for Claude Code users:
Name Your Claude Sessions by Task
Instead of generic names, use task-specific names:
- "Claude: Auth System" — Working on authentication
- "Claude: API Endpoints" — Building REST endpoints
- "Claude: Bug #142" — Fixing a specific issue
Use Separate Workspaces for Separate Contexts
Don't mix projects in one workspace. When Claude is working on your backend, you don't want to accidentally run frontend commands in that terminal.
Keep a "Scratch" Workspace
Create a workspace called "Scratch" for quick one-off commands, testing snippets, or exploring new ideas. Keep your project workspaces clean.
Save Multiple Layouts
Create different layouts for different modes:
- "Deep Work" — Just your main project, minimal distractions
- "Full Stack" — Frontend + Backend + Infrastructure
- "Code Review" — Git-focused layout for reviewing PRs
Example: My Daily Claude Code Setup
Here's the exact setup I use for full-stack development with Claude Code:
Workspace 1: "API" (⌘1)
Tab 1: Claude Code session for backend work
Tab 2: Server running (npm run dev)
Tab 3: Database CLI (psql)
Workspace 2: "Web" (⌘2)
Tab 1: Claude Code session for frontend
Tab 2: Next.js dev server
Tab 3: Storybook for components
Workspace 3: "Git" (⌘3)
Tab 1: Git status and commits
Tab 2: GitHub CLI (gh pr list)
Workspace 4: "Deploy" (⌘4)
Tab 1: Production SSH
Tab 2: Logs streaming
Tab 3: Deployment scripts
I save this as a layout called "Full Stack". Every morning, I press ⌘⇧L, select "Full Stack", and I'm ready to work in seconds.
Conclusion
Claude Code is powerful, but it's even better when you're not fighting your terminal setup. With Beam:
- Workspaces keep your projects separated
- Tabs organize your workflow within each project
- Split panes let you see Claude Code and results simultaneously
- Layouts save your entire setup for instant restoration
- Keyboard shortcuts keep you in flow state
Your terminal is your IDE now. Make sure it's organized like one.
Ready to Level Up Your Claude Code Workflow?
Download Beam free and organize your AI coding sessions. Workspaces, layouts, and keyboard navigation — everything you need for the terminal era.
Download Beam Free