Guide · beginner · 10 min · Draft

Orientation: Claude Desktop vs Claude Code

Same brain, two very different bodies. Claude Desktop is a brilliant chat app; Claude Code is an agent with hands — it can traverse your file system, soak up your real context, and write its work to disk. Here's why Code wins for real work, why Desktop is still cool, and when to reach for each.

Same brain, different bodies

This is the framing that makes everything else click: when you compare Claude Desktop and Claude Code, you are not comparing intelligences. It's the same Claude underneath. You're comparing embodiments — what the model is allowed to touch.

  • Claude Desktop embodies Claude as a conversation partner. It lives in a chat window. Things enter its world when you paste them, upload them, or wire up a connector. Things leave its world when you copy them out.

  • Claude Code embodies Claude as a worker on your machine. It lives in your terminal, inside a folder you choose. Its world is your file system, and its output is not a reply — it's a change: files written, edits made, commands run.

That single difference — chat window vs. file system — explains every practical divergence between them.

Why Claude Code wins for real work

It traverses your file system. Point it at a folder and it can list, search, and read everything in it — and navigate outward to wherever else it needs (with your permission). A data room of PDFs, four years of deal memos, a folder of portfolio board decks, your notes vault: it walks the tree itself. In Desktop, you are the file system — dragging documents in one upload at a time, re-establishing context every conversation.

It accesses your real context. Your actual working context isn't in any chat thread — it's in files: the spreadsheet's formulas, the config that explains why something behaves oddly, the folder structure that encodes how your firm thinks. Claude Code reads all of it in place. Better: it can persist context in files — a CLAUDE.md of standing instructions, memory notes it maintains across sessions — so every session starts already knowing how you work. Desktop's Projects feature gestures at this; a file system does it natively.

It writes to disk. This is the big one. Ask Desktop for a memo and you get text in a bubble — the copy-paste is your job, the filing is your job, version one lives nowhere. Ask Code and the memo lands in memos/2026-07-29_acme-series-b.md, in the right folder, alongside a changelog entry, committed to git if you want history. The work product arrives filed. Multiply that by everything: it doesn't describe the fix, it applies it; it doesn't draft the analysis, it writes the analysis and the script that regenerates it next quarter.

It compounds. Because everything lives in files, session two builds on session one's output. Chat conversations end; a workspace accretes.

Nearly everything the Dojo has built — the polling system, the session decks, these very Recipes — was made by describing intent to Claude Code and letting it work across the file system. None of it is buildable in a chat window.

Why Claude Desktop is still cool

Genuinely, not consolation-prize cool:

  • It's the frictionless front door. Zero setup, no terminal, no folder to choose. For a quick question, a gut-check, a "summarize this PDF," opening a terminal is overkill. Desktop is where casual use should happen.

  • Connectors reach where files don't. Through MCP connectors, Desktop talks to your Gmail, Calendar, Drive, CRM — live services rather than local files. "Find the thread where that founder mentioned their burn rate" is a Desktop-shaped question.

  • Artifacts are a lovely medium. Interactive charts, small web apps, polished documents rendered live next to the conversation — great for shareable one-offs.

  • It meets non-technical colleagues where they are. Your ops person or an EA gets real value from Desktop on day one. Prescribing a terminal to everyone is how rollouts die. (Also: your phone. Code has no thumbs-friendly mode.)

  • It's the better reading room. Long thinking-out-loud conversations — talking through a term sheet, pressure-testing a thesis — feel natural in chat and gain nothing from file access.

When to reach for which

SituationReach for
Quick question, gut-check, summarize one documentDesktop
Talking through a decision, drafting from scratchDesktop
Anything touching email / calendar / CRM via connectorsDesktop
On your phone, or helping a non-technical teammateDesktop
Work spanning many files or folders (data rooms, memo archives)Code
Output that should land somewhere and persistCode
Anything repeatable — scripts, pipelines, site changesCode
Building durable context that compounds across sessionsCode

The honest pattern: think in Desktop, work in Code. Many things start as a Desktop conversation and graduate into a Code session the moment they touch real files.

The upgrade path

The only real barrier between you and Claude Code is terminal comfort — and that's a solved problem: How To: Getting Unafraid and Setting Up Your Terminal gets you a terminal you'll actually enjoy in about 25 minutes. Then:

BASH
brew install --cask claude-code
cd ~/some-folder-with-real-files
claude

Ask it to look around. Ask it to organize something. Watch it write a file. The difference between a chat window and an agent in your file system stops being an abstraction in the first five minutes.