AI Field Guide
Chapter Six

App, Terminal,
and Cowork

The real differences between the five places Claude Code lives — and what Cowork actually is, now that it's a third tab next to Chat and Code.
Compiled 14 July 2026 · you run 96% desktop app, 4% terminal — this chapter is about the 4%

Chapter SixWhere you actually are


Your split, from your own transcripts

1,262 prompts in the desktop app. 56 in the terminal. Ninety-six to four.

That is a defensible choice — the desktop app is genuinely the better daily driver for what you build. But a small number of things are terminal-only, and one of them is currently blocking a project you've already built.

Chapter SixThe five surfaces


Claude Code runs on the terminal CLI, the desktop app, the web (claude.ai/code), the VS Code extension, and the JetBrains plugin. They share one engine — CLAUDE.md, settings, skills and MCP servers carry across all of them.

The thing that surprises everyone: sessions do NOT sync

The desktop app, the web app, and the IDE extensions each maintain their own separate session history. You cannot start something in the terminal and pick it up in the app. This is architectural, not a bug — and it's why your work is effectively siloed in whichever surface you started it.

What only the terminal can do

CapabilityWhy it matters to you
claude setup-tokenThis is what's blocking your AI Brief right now. See below.
Headless modeclaude -p "prompt", with --output-format jsonRun once, capture structured output, exit. The foundation of every automation you've wanted to build. Your cron jobs need this.
Pipingcat build.log | claude -p "find the root cause"Stream data through Claude without writing files
--worktree / -wIsolated git worktrees for parallel agents — you juggle six live projects daily
--bareSkip all hooks, skills, plugins and MCP for reproducible CI runs
Interactive dialogs — /permissions, /config, /agents, /doctor, /hooksSome of these open panels that simply don't exist elsewhere
Your AI Brief is blocked on a terminal command

Your memory file says it plainly: "BLOCKED on user running claude setup-token → .env for headless auth." The launchd timer fires every morning at 07:12 into a wall.

claude setup-token is terminal-only. It cannot be run from the desktop app. This is the clearest possible example of why the 4% matters: a finished, deployed project has been silently failing every single day because the one command that unblocks it lives in a surface you don't open.

Open a terminal. Run it. The project starts working.

What only the desktop app can do

To be fair to your choice — these are real, and they're why you're there:

The recommendation

Stay in the desktop app. It suits how you work — visual, preview-heavy, screenshot-driven. Don't migrate.

But keep a terminal open for four things: claude setup-token (once, today), headless claude -p for anything scheduled, --worktree when you're juggling projects, and the /doctor and /hooks dialogs when you set up the automation from Chapter Five.

This is not "the terminal is better." It's "four specific capabilities live there, and one of them is costing you a working product."

Chapter SixWhat Cowork actually is


You asked about "Claude co-work." It's Cowork, and it is a genuinely separate product — a third tab in the desktop app, alongside Chat and Code.

Chat is conversational. Code is Claude Code. Cowork is autonomous task execution for work that isn't coding — it runs unattended, on a schedule or in the background, and you review the results afterwards.

The statistic that defines it

Anthropic's own figure: more than 90% of Cowork usage is not software development. It's business operations and content creation — reports, documents, spreadsheets, research, content pipelines.

This is why it exists as a separate tab rather than a Claude Code feature. It is not aimed at you-the-developer. It is aimed at you-the-founder.

 Claude ChatClaude CodeClaude Cowork
ForConversation, draftingCoding, files, terminalBusiness automation, async work
ExecutionInteractiveInteractive, or headlessAutonomous — you set it, it runs
RunsAnthropic's serversYour machine (or cloud)Anthropic's cloud sandbox
Survives you closing it?NoNoYes
ScheduledNoVia RoutinesYes, natively
ToolsSearch, artifactsFull dev stack, MCP, local filesDocs, Sheets, Slack, email, cloud storage
Typical userEveryoneEngineersOps, marketing, PMs

Where Cowork would genuinely earn its place in your week

Here's the honest read. If 90% of your work is building, Cowork mostly sits unused — Claude Code is your tool. But you are not only a developer, and a specific slice of what you do is exactly what Cowork is for:

Where Cowork is the wrong tool

It cannot reach your local machine, your private MCP servers, or your databases. It's a cloud sandbox. Real-time debugging, production deploys, and anything needing your local filesystem stay in Claude Code — no exceptions.

Verdict on Cowork

It's already included in your plan. There is no extra cost and no setup — it's a tab you have never clicked.

Try exactly one thing on it: move the AI Brief refresh there. It's the project most obviously shaped like a Cowork job, it's currently broken in a way Cowork would sidestep entirely, and it would tell you in one afternoon whether the tool deserves a permanent place in your week.

Chapter SixA note on what I could not verify


Claude Code ships fast, and surface-by-surface feature parity is the single hardest thing to pin down accurately — the docs lag the changelog, and third-party write-ups are frequently wrong. Treat the fine-grained parity claims in this chapter as directionally right but worth checking against the docs before you build a workflow on them.

The four things I am confident about, because they are load-bearing here: sessions do not sync across surfaces; claude setup-token and headless -p are terminal-only; the preview pane is a desktop-app feature; and Cowork is a separate product included in your existing plan.

Sources. Claude Code docs (code.claude.com) — desktop, web, VS Code, JetBrains, sessions, permission modes, headless, worktrees, costs · Claude Cowork product page and July 2026 web/mobile launch announcement · TechCrunch. Surface parity details change frequently; verify against the docs before depending on them.