Using Cursor with Claude Code: the two-tool workflow

Many developers do not choose between Cursor and Claude Code. They use Cursor as the place where they read and shape code, then send bounded work to Claude Code. The combination is excellent until both agents become writers in the same working tree.

By the Continuum team. We build a workbench that runs Claude Code, Codex, and their peers, so the model rates quoted here are the ones our own cost analytics ship with.

The short version

Cursor and Claude Code fit different parts of a development loop. Cursor is strongest for interactive editing, Tab predictions, selected rewrites, and reviewing diffs in an editor. Claude Code is a delegated agent that reads files, runs commands, and completes a bounded task from a terminal or other surfaces. Use one writer per working tree, create a separate git worktree for concurrent Agent work, keep shared repository conventions in version control, and use the other tool as an independent reviewer. Their subscriptions and usage limits are independent, which also makes the pair a practical failover.

What you need to know
  • Use Cursor for interactive steering and Claude Code for bounded delegation.
  • Running claude in Cursor’s terminal is convenient, but it does not isolate files.
  • For concurrent work, give each writer a separate git worktree and branch.
  • The highest-value loop is one tool implements, the other reviews.
  • Keep repository facts in committed instruction files and tool-only preferences in tool-specific files.
  • Two subscriptions provide two independent quotas; that is useful only if handoff state is explicit.

Why the combination makes sense

Cursor and Claude Code overlap, but their natural control loops are different. Cursor stays close to the cursor: you read a file, accept a Tab prediction, select a block for Inline Edit, or watch Agent propose changes in the editor. Claude Code starts from an outcome: you describe a task, it explores the repository, edits files, runs commands, and reports back.

Work shapeNatural toolWhy
You know the exact file and editCursorSelection, diff, and surrounding code are already visible
The next change is a mechanical consequenceCursor TabPrediction is faster than explaining the task
A ticket requires repository exploration and testsClaude CodeThe delegated tool loop can research and iterate
You need to steer every few minutesCursor AgentThe editor keeps code and conversation adjacent
You want a task to run while you edit elsewhereClaude Code in another worktreeThe task has its own branch and filesystem
A risky diff needs a second opinionThe tool that did not write itIndependent context reduces author bias
One subscription is at its limitThe funded tool with headroomThe quotas are independent

This is not a claim that one model always codes better. Model rankings move too quickly to build a durable workflow around them. The stable distinction is interaction shape. Use the editor when the valuable thing is your continuous attention. Use the delegated agent when the valuable thing is reclaiming that attention until a review point.

Three workflows that hold up

01

Cursor foreground, Claude Code background

Keep the active bug or design work in Cursor. Give a separate, well-specified task such as tests, migration scaffolding, or a bounded refactor to Claude Code in another worktree. Review its branch when it finishes. This is the best general-purpose setup because the two tasks cannot change the same files accidentally.

02

Implement with one, review with the other

Ask Claude Code to implement, then open the diff in Cursor and use Cursor Agent or your own review. Or make the edit interactively in Cursor and ask Claude Code in read-only or plan mode to inspect the resulting diff. The reviewer should receive the requirements and diff, not the author's entire conversation.

03

Plan interactively, execute as a handoff

Use Cursor to explore requirements and produce a written plan in the repository. End the planning session. Give Claude Code the plan path, exact scope, validation commands, and no-commit boundary. Written state survives tool changes; a chat transcript does not make a good handoff contract.

A fourth pattern, racing both tools on the same hard problem, is useful but expensive. Give each an identical brief in a separate worktree, run the same tests, then compare the diffs. Reserve it for architecture, severe production bugs, or changes whose long-term cost dwarfs two agent runs. Racing routine tasks creates review debt faster than value.

Running Claude Code inside Cursor

The simplest setup is literal: open Cursor's integrated terminal in the repository and run claude. Claude Code sees the same current directory, Git state, environment, and files that Cursor sees. That is convenient for a single sequential workflow. It is not a safety boundary. Cursor Agent, Tab, extensions, you, and Claude Code can all write into the same working tree.

Sequential use in the current Cursor workspace
git status --short
claude

# After Claude Code exits
git status --short
git diff --stat
git diff

Before starting, read the dirty state and decide who owns it. If the tree already contains your edits, tell Claude Code they are user-owned and must be preserved. Better, commit or stash only when that is already authorized by your workflow. Never let an agent “clean up” a dirty tree merely to make its own diff easier to understand.

Safe in one treeUnsafe in one tree
Cursor editing, then Claude Code after Cursor Agent is stoppedCursor Agent and Claude Code editing concurrently
Claude Code performs a read-only reviewBoth tools running formatters over overlapping files
One tool writes while the other only displays the diffAssuming terminal tabs imply filesystem isolation
A small task with a clean ownership handoffTwo tasks that may touch shared config, lockfiles, or generated code

The integrated terminal is therefore a presentation choice. It keeps everything in one window and makes the finished diff easy to inspect. It does not turn the terminal process into a separate environment. Concurrency requires worktrees, containers, remote environments, or another explicit isolation layer.

Worktrees are the concurrency boundary

A git worktree gives another branch its own directory while sharing repository object storage. Cursor can stay open on the main task and Claude Code can write in the second directory. Changes, untracked files, dependency artifacts, and formatter output remain separated by path. The branches can later be reviewed and integrated with ordinary Git operations.

Create a dedicated Claude Code worktree
# From the primary repository
git worktree add ../myapp-claude -b agent/claude-bounded-task

# Open a second terminal or workbench session
cd ../myapp-claude
claude
  1. Start from a deliberate base. Create the worktree from the branch or commit the task should actually modify.
  2. Give the branch one objective. A worktree is isolation, not a license for unrelated cleanup.
  3. Install dependencies inside that worktree when required. Do not assume repository-local build output is safely shared.
  4. Run validation before handoff. The implementer should report exact commands and failures.
  5. Review from outside the author conversation. Open the branch in Cursor or ask a clean Claude Code session to review only the diff and requirements.
  6. Remove the worktree only after integration is resolved. Uncommitted changes and untracked evidence should not disappear for tidiness.

Worktrees do not isolate services outside the directory. Two agents can still use the same database, port, cloud account, simulator, or generated cache. Give parallel test servers different ports and use disposable test data. A filesystem boundary is necessary for code, but it is not a complete environment boundary.

Share repository facts, not every preference

The tools have different instruction systems. Cursor uses project rules and can work with repository instruction files. Claude Code loads CLAUDE.md according to its memory hierarchy. Trying to force every setting into one giant universal file creates context neither tool needs. The better split is a small shared core plus tool-specific operating instructions.

InstructionWhere it belongsExample
Repository factCommitted shared instructionsPackage manager, test command, directory ownership
Safety boundaryCommitted shared instructionsNever run production migrations; preserve user-owned dirty changes
Coding conventionCommitted shared instructions or source lintingError types, naming, test placement
Cursor UI behavior.cursor/rules/When to use a particular Cursor workflow or context source
Claude Code command or permission habitCLAUDE.md or Claude settingsApproved validation command and task-specific tool restrictions
Personal preferenceUncommitted user-level configResponse verbosity, local editor layout

Keep the shared core short and testable. “Use pnpm and run pnpm test” is useful. “Write excellent maintainable code” is ceremony. If a rule can be enforced by a formatter, linter, test, or type checker, put the enforcement there and let both tools discover the same failure. Prose should cover facts the tool cannot infer cheaply.

Avoid contradictory copies. If CLAUDE.md says npm and a Cursor rule says pnpm, the repository has two realities. Pick one canonical statement and make tool-specific files reference or restate only the small subset they need. Review instruction changes like code, because they alter every future agent run.

The independent-review loop

The most valuable reason to pay for two capable tools is not twice as much code generation. It is an implementation and review loop with genuinely different context. The second tool did not spend twenty turns defending the approach it chose, so it is more likely to question assumptions, notice scope creep, and inspect deletions with fresh attention.

01

Freeze the author

Stop the writing session. Record the base commit, branch, dirty state, and validation output. A review while the author keeps changing files is a moving target.

02

Give the reviewer the contract

Provide requirements, explicit non-goals, the diff, and named validation commands. Do not provide a long narrative explaining why every implementation choice was reasonable.

03

Ask for findings, not a rewrite

Require concrete correctness, security, regression, and missing-test findings with file and line evidence. A stylistic alternative is not automatically a defect.

04

Return fixes to the owner

The authoring tool or human applies accepted findings so file ownership remains clear. Re-run the relevant tests and, for high-risk changes, send the new diff through one clean review pass.

A concise cross-tool review prompt
Review the current branch against REQUIREMENTS.md.
Stay read-only. Inspect the diff from <base commit>.
Report only correctness, security, regression, and missing-test findings.
For each finding, cite the file and line, explain the failure path,
and name the smallest verification that would prove the fix.
If there are no substantive findings, say so plainly.

A reviewer should run read-only diagnostics and tests that do not rewrite snapshots or format files. If the project test command mutates the tree, say so and run it only in an isolated review worktree. The review is independent only if it does not silently become a second author.

Quotas, cost, and failover

At entry pricing, Cursor Pro and Claude Pro each sit at $20 a month in the site snapshot, so the common two-tool setup starts around $40 before Cursor on-demand usage or higher Claude tiers. The value is not merely more tokens. You buy two interaction shapes, two model ecosystems, and two independent account limits.

SituationGood failoverBad failover
Cursor third-party allowance emptyMove a bounded task to Claude Code in a clean worktreePoint Claude at a half-edited Cursor Agent tree without context
Claude Code window exhaustedContinue interactive work in Cursor or use Cursor Agent capacityRepeat the entire old Claude transcript in Cursor
Both have capacityAssign by task shape or independent reviewRun both on every trivial task because capacity exists
One tool produced an uncertain diffUse the other read-only as reviewerAsk both to modify the same files until tests pass
Combined spend is unclearTrack subscription headroom and session cost in one viewInfer total cost from one vendor dashboard

Failover works when task state lives in the repository: a plan file, issue description, diff, test output, or a short handoff note. It fails when the only source of truth is a chat window. Write down the current objective and unresolved edge before moving tools. This costs two minutes and prevents the second agent from repeating exploration or undoing a deliberate constraint.

A working operating policy

A small policy for teams using both
1. One writer per working tree.
2. Concurrent writers require separate branches and directories.
3. Every delegated task names scope, non-goals, and validation.
4. User-owned dirty changes are preserved.
5. The author stops before independent review begins.
6. Findings return to the author for fixes.
7. Production credentials and destructive actions require explicit authority.
8. A quota failover includes a written state handoff.
9. Merge remains a human decision.
10. Finished work reports code state and verification state separately.

This policy is intentionally boring. The interesting parts of the workflow are the tasks; the coordination layer should be predictable. Once branch ownership, review ownership, and validation are explicit, developers can choose Cursor or Claude Code per hour without turning tool choice into a ceremony.

Questions people ask

Yes. A common setup uses Cursor for interactive editing and review, with Claude Code handling bounded delegated tasks. Use one writer per working tree and separate worktrees for concurrency.

Yes. Run claude from Cursor’s integrated terminal after installation. It sees the same current directory and files, which is convenient but provides no isolation from Cursor Agent or your own edits.

Sequentially, with an explicit ownership handoff, yes. Concurrently, no. Give each writing agent a separate git worktree and branch.

Edits you can point at, Tab-driven mechanical changes, interactive exploration, and visual diff review. Cursor is strongest when your attention remains in the loop.

Bounded tickets that require repository exploration, commands, tests, and an implementation you can review after the agent reports back.

Yes, or vice versa. Cross-tool review is valuable because the reviewer does not share the author’s full reasoning history. Give it requirements and the diff, require line-backed findings, and keep it read-only.

Keep repository facts and safety boundaries in concise committed instructions. Put Cursor-only workflow in .cursor/rules and Claude Code-specific operation in CLAUDE.md or Claude settings. Avoid contradictory copies.

At the entry tiers the site snapshot puts each at $20 a month, so two subscriptions start around $40 before overage. The return is two workflows, independent review, and independent quotas, not simply twice the generation.

Write a short handoff with objective, current diff, files in scope, validation run, and unresolved step. Start the second tool in a clean or dedicated worktree rather than an ambiguously dirty directory.

Sources

Every figure above was read from these pages on August 2026. Vendors reprice without notice; if you find a stale number, tell us.

  1. Cursor documentation
  2. Cursor Agent overview
  3. Claude Code documentation
  4. Claude Code memory
  5. Git worktree manual
Try it

Two tools.
Clear ownership.

Continuum runs Claude Code, Cursor agent, Codex, and peers in isolated worktrees with live quota gauges, while Cursor remains your editor.

free app · your subscriptions · local-first