Claude Code is Anthropic’s terminal-based AI coding agent. It reads your entire codebase, writes and edits files, runs commands, creates commits, and handles complex multi-step tasks — all from the command line.

GridTerm is a multi-terminal workspace that lets you run Claude Code in multiple terminals simultaneously. This guide walks you through setting up both tools together for maximum productivity.

Prerequisites

Claude Code installed and authenticated (npm install -g @anthropic-ai/claude-code, then claude to log in)
GridTerm installed (get it here — $67 one-time, Windows & macOS)

Step 1: Open your first grid

Launch GridTerm. By default, you’ll see a single terminal. Click the grid selector in the toolbar and choose 2x2. You now have four terminals visible at once.

Each terminal is a full shell — PowerShell on Windows, zsh on macOS. Everything you can do in a normal terminal works here.

Step 2: Launch Claude Code

In the top-left terminal, cd to your project directory and type claude. Claude Code will start, index your codebase, and wait for a prompt.

Do the same in the top-right terminal. Now you have two Claude Code sessions running side by side on the same project.

Step 3: Prompt in parallel

Give the first session a task:

Refactor the auth middleware to use JWT verification instead of session tokens

Immediately switch to the second session and give it a different task:

Write unit tests for the user registration endpoint

Both agents are now working simultaneously. While one refactors, the other writes tests. When either finishes, review the output and prompt the next task.

This is the core of the multi-agent workflow: parallel prompting with sequential review.

Step 4: Use the file browser

Claude Code modifies files as it works. You’ll want to inspect those changes.

Open the sidebar in GridTerm (click the folder icon or press the sidebar toggle). Navigate to your project directory. Click any file to open it in the built-in tabbed editor with syntax highlighting.

When Claude Code mentions a file path in its output, you can Ctrl+click (or Cmd+click on macOS) the path to open it directly in the editor. No copy-pasting, no switching windows.

Step 5: Set up screenshots

Claude Code accepts images. This is useful for sharing error messages, UI bugs, design mockups, or anything visual.

GridTerm’s screenshot system works like this:

Press your screenshot hotkey (Ctrl+Shift+7 on Windows, Cmd+Shift+7 on macOS)
Select the screen region you want to capture
The screenshot is saved and copied to your clipboard
Paste it into Claude Code with Ctrl+V (or Cmd+V)

That’s it. Two seconds from capture to agent context. Customize the hotkey in Settings if you want a different shortcut.

Step 6: Save a workspace

Once your layout is dialed in, save it as a workspace so you can reload it instantly.

A good Claude Code workspace configuration:

Terminal	Directory	Auto-command
Top-left	~/projects/myapp	`claude`
Top-right	~/projects/myapp	`claude`
Bottom-left	~/projects/myapp	`npm run dev`
Bottom-right	~/projects/myapp	(empty — for git, tests)

Give the workspace a name like “MyApp — Claude Code” and save it. Tomorrow, open GridTerm, load the workspace, and you’re right back where you left off — agents launching automatically, dev server starting, everything in place.

Step 7: Scale up

Once you’re comfortable with 2x2, try 2x3 or 3x3. More terminals means more agents running in parallel.

A power-user 3x3 layout:

6 terminals running Claude Code on different tasks
1 terminal running the dev server
1 terminal for git operations
1 terminal for manual testing

With 6 agents in parallel, you can chew through a backlog of refactoring tasks, bug fixes, and feature work at a pace that would take a single agent hours.

Tips

Use notes. GridTerm has built-in markdown notes. Keep a running list of tasks to prompt next, observations from code review, or context you want to share across agents.
Use global search. When Claude Code references a file and you need to find it fast, GridTerm’s global search indexes your entire filesystem. Type a filename and jump straight to it.
Start small. Two Claude Code sessions is already a major upgrade from one. Add more as you get comfortable managing parallel agents.

What’s next

How to run multiple AI agents at once — Deep dive into parallel agent workflows
Best terminal for Claude Code — Why grid layouts are essential for agent work
GridTerm vs tmux — How GridTerm compares to traditional terminal multiplexers

Get GridTerm — $67 one-time purchase