TaskPeace

How to use Claude Code on multiple computers

Two laptops and a desktop. Or five people, each with their own Claude account. They all need one source of truth — but the obvious answer, syncing a folder, is the one that breaks. Here's what to use instead.

The short answer: don't sync files — share a queue and a git remote. Git holds the canonical code; every machine keeps a fast local clone; one shared, leased task queue stops two machines doing the same work. Setup is one command per machine.
Open the board — free →

Why syncing a folder is the wrong instinct

Putting your repo in Dropbox, iCloud Drive or OneDrive looks like the answer: every machine sees the same files. In practice it's the worst option for agent work.

What goes wrong: no file locking — an agent writes a file while the sync daemon rewrites it underneath, and edits vanish mid-session · node_modules and build output get synced, so you push gigabytes to move kilobytes of real change · conflicts produce file (conflicted copy).ts instead of a merge · .git itself can be corrupted by two machines touching it at once.

The deeper issue: these tools resolve conflicts by duplicating. Git resolves them by merging. When two agents are writing code in parallel, that difference is everything.

The two architectures that actually work

ApproachHow it worksBest when
Git remote as truth
(recommended)
Each machine has its own local clone. Pull before working, push after. A shared queue coordinates who does what. Multiple people · multiple accounts · working offline · anything team-shaped.
One host, others SSH in One always-on machine holds the files; other computers connect to it. There is only ever one filesystem. A solo operator with one strong desktop who wants zero sync and 24/7 runs.

Both give you one source of truth. The difference is where it lives — in the remote, or on one host. What they share is the thing that matters: no file is ever written by two machines at once.

Set it up

  1. Push every repo to git. GitHub or GitLab — the remote is now canonical, not any one laptop. If work only exists locally, commit and push it first; that's the step people skip and regret.
  2. Clone locally on each machine. Onto real local disk, never into a synced folder. Local disk is what keeps builds, git and file-watching fast.
  3. Connect each machine to the shared queue. Once per computer:
    curl -fsSL https://taskpeace.com/install.sh | bash
  4. Sign in on each machine. Run claude, then /login. Same account or different ones — coordination doesn't depend on it.
  5. Work the queue. Each session calls get_next_task, which leases the task. Because the queue is server-side, a task taken by the laptop is already invisible to the desktop.
  6. Pull before, push after. The habit that keeps the source of truth true.

Why a shared queue solves this and a shared folder doesn't

The queue lives on a server, not on a machine. That single fact is what makes it work across computers with no extra setup:

For teams

The same model scales to people. Each teammate works on their own machine with their own Claude account and their own clone; the shared board is what makes them one team rather than several people guessing.

One gotcha worth knowing

Sessions auto-detect which project they're in from the working directory. If teammates keep the repo at different paths, that detection can miss — pass project explicitly, or set each project's working directory to match. Two minutes of setup that saves a confused afternoon.

Frequently asked questions

Can I use Claude Code on multiple computers at once?

Yes. Local clone per machine, git remote as the source of truth, one shared leased queue so no two machines take the same task.

Can I just use Dropbox or iCloud?

Not recommended. No locking, so live agent writes can be lost; it syncs build output; and conflicts duplicate files instead of merging. Git merges properly.

How do I stop two computers doing the same task?

Leasing, plus claim_paths for the files. Both are server-side, so they work across machines with no extra configuration.

Does each computer need its own Claude account?

Each signs in separately — same account or different. Coordination comes from the queue, not the login.

What about a shared network drive?

Slow for builds, git and file watching, and risky under concurrent writes. Prefer git — or the one-host-plus-SSH model, where there's still only one filesystem.

Run a fleet free →   Multiple sessions on one machine →