Guides

Running several Claude Code sessions without losing track

Give every session one task and its own git worktree, give it a name, and watch all of them from one place: agent view for background sessions, or the sidebar in Claude Desktop. Get an alert only when a session needs you, with the project’s name in it, and review finished sessions in batches. With two or three independent sessions most people keep up; past that, the limit is your attention, not the agents.

The short answer

One task and one worktree per session

Two sessions in the same folder will sooner or later edit the same file. A git worktree gives each session its own checkout of the repository on its own branch. Pass --worktree (or -w) with a name and Claude Code creates it under .claude/worktrees/<name>/ on a branch called worktree-<name>, then starts the session there (worktrees):

claude --worktree feature-auth

When you exit a worktree that has work in it, Claude Code asks whether to keep it and prints the command to return to it. Sessions you dispatch from agent view move into a worktree of their own before they edit anything, and Claude Desktop runs parallel sessions with git isolation as well.

Keep one task per session. A session that fixes a bug, then reviews a pull request, then explores a new library carries all three in its context, and the third task pays for the first two.

Name every session

“Which one was the auth fix?” is the question that eats time with four tabs open. Name each session with /rename as soon as it has a task, and treat sessions like branches: one per line of work. claude --resume then shows the names, and claude --continue picks up the last one. Some terminals also show each session’s state in its tab, working, waiting on you or done, through the Program Status Protocol (OSC 7501), which Claude Code 2.1.295 and later reports on its own.

One place to see them all

Alerts that say which session needs you

A generic “Claude Code needs your attention” doesn’t help with four sessions open. A Notification hook receives the session’s folder, so a few lines of shell put the project name into the banner. The script is in our guide to Claude Code notifications. While agent view is open, two more notification types fire for background sessions: one when a session starts waiting on your input, one when it finishes or fails.

The decision queue

With several agents, your job turns into answering them. One developer running six sessions described the result as “processing a decision queue you accidentally built”. Treat it like a queue on purpose:

How many sessions is too many?

There’s no fixed number, but the warning signs are clear. You reread a diff twice because you forgot what you asked. You approve without reading. You can’t say what each session is doing without looking. In developer threads, people running nine to twelve projects at once describe being exhausted by the evening, and several say they went back to two or three, or to one at a time. Parallel sessions also multiply token usage, so they reach usage limits sooner. When the tiredness doesn’t go away, read AI coding burnout: why agent work wears you out.

If a task is only a side job, such as researching a library or reading logs, a subagent inside your current session is often better than another session: it works in its own context and returns a summary.

All sessions at a glance in the notch

We make Meowdoro, so this is a disclosure as much as a tip. It’s a focus timer around the MacBook notch that lists every Claude Code and Codex session in a small black island: working, waiting for you, finished or failed, grouped by agent, each with its name or what it needs. A click opens the session in Claude Desktop or ChatGPT, or brings forward the app where it runs. Sessions on other machines show up too. Sessions you’ve already seen dim and drop off. During a break the list disappears until the next focus (agents in the island).

Questions

Can I run multiple Claude Code sessions at the same time?

Yes, in separate terminals, in agent view or in Claude Desktop. On the same repository, give each its own worktree so their edits don’t collide.

Can two Claude Code sessions talk to each other?

Yes. With cross-session messaging, Claude can list and message your other Claude Code sessions on the same machine, on another machine or in the cloud (cross-session messaging). For a coordinated team with a shared task list, there are agent teams, an experimental feature that is off by default.

Do parallel sessions share my usage limit?

Yes. They all draw on the same plan, so several busy sessions use it up proportionally faster.

Should I use subagents or separate sessions?

Subagents for side tasks that would flood your conversation with search results or logs. Separate sessions for independent pieces of work you want to steer and review yourself.

Sources: the Claude Code documentation on running agents in parallel, worktrees, agent view, sessions, hooks and best practices, read on October 26, 2026; the Reddit and Hacker News discussions linked above.