Build This Now
Build This Now
What Is Claude Code?Claude Code InstallationClaude Code Native InstallerYour First Claude Code Project
speedy_devvkoen_salo
Blog/Handbook/Core/Terminal as Main Thread

Terminal as Main Thread

Open a second terminal tab while Claude Code grinds through a long task. Run parallel sessions as a CPU scheduler. tmux, VS Code, and iTerm2 layouts included.

Stop configuring. Start building.

SaaS builder templates with AI orchestration.

Published Mar 25, 2026Handbook hubCore index

Problem: A Claude Code request is running long and your hands, eyes, and brain are all idle. That's the real cost, not the wall clock.

Quick Win: Open a second terminal tab, fire claude in it, and hand it a related task while the first keeps going. You just upgraded from worker to scheduler.

You Are the CPU Scheduler

Idleness used to only cost you. Now it also wastes the Claude sessions you could have been running in parallel.

Picture your setup as a tiny operating system. The bottleneck is your attention, not whatever Claude can crunch. You coordinate. Claude executes.

Setting Up Parallel Terminals

The pattern needs more than one terminal window. Here is the concrete setup per shell:

VS Code (easiest):

# Split terminal: Ctrl+Shift+5 (or Cmd+Shift+5 on Mac)
# Each pane runs its own claude instance

tmux (most powerful):

# Create new session with splits
tmux new-session -s dev
# Split horizontally: Ctrl+b "
# Split vertically: Ctrl+b %
# Navigate panes: Ctrl+b arrow-keys

iTerm2 on Mac:

# Cmd+D for vertical split
# Cmd+Shift+D for horizontal split

Every pane hosts its own claude process with its own context.

The Parallel Pattern

One blocked task at a time is the old shape. The new shape looks like this:

# Terminal 1: Working on refactor
claude
> refactor the auth module to use JWT
 
# YOU: Don't wait! Switch to Terminal 2
claude
> write integration tests for the payment flow
 
# Terminal 3: Documentation
claude
> update the API docs for the new endpoints

Three Claude sessions are alive at once. Your job is to watch, steer, and stitch the outputs together.

Practical Coordination

Development Pipeline

Three terminals map cleanly onto a single feature:

TerminalTaskWhy Parallel
1Fix build errorsBlocking issue
2Code review changesIndependent analysis
3Prepare deploy checklistCan start early

Session Handoffs

The output of one Claude can become the input of another:

# Terminal 1 completes refactor, saves to file
> save the refactored auth to src/auth-new.ts
 
# Terminal 2 picks up
> write tests for src/auth-new.ts

Your filesystem is the handoff bus between sessions.

Context Isolation

Contexts do not bleed across panes, and that separation is the point:

  • A long back-and-forth in one session stays there
  • Each terminal can hold its own specialty
  • Your effective context window multiplies across the set

Optimizing Your Terminal

Parallel sessions get you most of the way. A tuned terminal strips out the friction eating the rest.

Multi-Line Input with Shift+Enter

Longer prompts want a newline that does not submit. Shift+Enter handles that natively in iTerm2, WezTerm, Ghostty, and Kitty. On other shells, run /terminal-setup from within Claude Code and the wire-up lands on VS Code, Alacritty, Zed, and Warp.

Universal fallback: type \ then press Enter, and any terminal accepts the newline. The terminal setup guide walks through the rest.

Notification Setup

Once several sessions are live, spotting the moment any one of them finishes really matters. For iTerm 2, walk into Preferences, then Profiles, then Terminal. Flip on "Silence bell" and, under Filter Alerts, pick "Send escape sequence-generated alerts." Set your delay and a native macOS alert lands each time Claude wraps up.

Other terminals reach the same outcome via custom notification hooks that run your own logic on completion. Perfect pairing: focus on one session, and another taps you on the shoulder when it needs you back.

Vim Mode

Already live in vim? Run /vim from inside Claude Code and the input line picks up modal editing. Normal, insert, and visual modes all work, plus h/j/k/l movement, word motions, text objects, yank, and paste. Toggle it via /config. The keybindings guide has every shortcut. The interactive mode guide ties slash commands, mode switching, and session controls into one story.

Custom Status Line

Pin a small info strip below your prompt to watch the active model, context usage, git branch, or session cost without leaving Claude. Drop it in through settings, or call /statusline and Claude generates one. The strip updates live as the conversation moves, and pays off fast the moment more than one session is open.

When Things Go Wrong

Error: the pane grid feels chaotic Fix: Start with two terminals and nothing more. Only add a third after two has turned into muscle memory.

Error: you forget which pane is doing what Fix: Label your tmux windows, or lean on VS Code's terminal naming feature. A simple mental map helps: left=feature, middle=tests, right=docs.

Your Throughput Multiplier

Ramp your parallel count on a timeline:

  • Week 1: 2 concurrent sessions, comfortable
  • Week 2: 3 sessions, switching smoothly
  • Week 3: 4-5 sessions for complex features

Raw speed is not the goal. Never letting your attention sit idle on a wait is.

Try This Now

  1. Open three terminal windows
  2. Run claude in each
  3. Start three related but distinct tasks
  4. Practice switching between them as each responds

You stop being a user and start being an orchestrator. ClaudeFast's Code Kit bakes this same coordination into /team-build, a command that reads one plan file and spawns its parallel sub-agents from it. Prompt wiring, context boundaries, and result rollup all happen inside the command.

Next: Read the context management piece to sharpen each session, the planning modes guide for queued work, and the sub-agent design guide for hands-off coordination.

Advanced: Stack this with auto-planning strategies and feedback loops for a development setup that runs in lockstep.

Continue in Core

  • 1M Context Window in Claude Code
    Anthropic flipped the 1M token context window on for Opus 4.6 and Sonnet 4.6 in Claude Code. No beta header, no surcharge, flat pricing, and fewer compactions.
  • AGENTS.md vs CLAUDE.md Explained
    Two context files, one codebase. How AGENTS.md and CLAUDE.md differ, what each one does, and how to use both without duplicating anything.
  • Auto Dream
    Claude Code cleans up its own project notes between sessions. Stale entries get pruned, contradictions get resolved, topic files get reshuffled. Run /memory.
  • Auto Memory in Claude Code
    Auto memory lets Claude Code keep running project notes. Where the files sit, what gets written, how /memory toggles it, and when to pick it over CLAUDE.md.
  • Auto-Planning Strategies
    Auto Plan Mode uses --append-system-prompt to force Claude Code into a plan-first loop. File operations pause for approval before anything gets touched.
  • Autonomous Claude Code
    A unified stack for agents that ship features overnight. Threads give you the structure, Ralph loops give you the autonomy, verification keeps it honest.

More from Handbook

  • Agent Fundamentals
    Five ways to build specialist agents in Claude Code: Task sub-agents, .claude/agents YAML, custom slash commands, CLAUDE.md personas, and perspective prompts.
  • Agent Harness Engineering
    The harness is every layer around your AI agent except the model itself. Learn the five control levers, the constraint paradox, and why harness design determines agent performance more than the model does.
  • Agent Patterns
    Orchestrator, fan-out, validation chain, specialist routing, progressive refinement, and watchdog. Six orchestration shapes to wire Claude Code sub-agents with.
  • Agent Teams Best Practices
    Battle-tested patterns for Claude Code Agent Teams. Context-rich spawn prompts, right-sized tasks, file ownership, delegate mode, and v2.1.33-v2.1.45 fixes.

Stop configuring. Start building.

SaaS builder templates with AI orchestration.

On this page

You Are the CPU Scheduler
Setting Up Parallel Terminals
The Parallel Pattern
Practical Coordination
Development Pipeline
Session Handoffs
Context Isolation
Optimizing Your Terminal
Multi-Line Input with Shift+Enter
Notification Setup
Vim Mode
Custom Status Line
When Things Go Wrong
Your Throughput Multiplier
Try This Now

Stop configuring. Start building.

SaaS builder templates with AI orchestration.