Claude Code on the Mac

Written & tested for accuracy by a developer (not AI) · Updated June 2026

Claude Desktop and Claude Code

How to choose Claude Desktop, Claude Code, or Cowork on Mac. Which is the best product, what each can do, and differences among them. Which to select for coding.

Anthropic moves at a breakneck pace to introduce new products and consolidate features. That's resulted in a confusing array of product names and product features. Kudos to you if you've kept it all straight; otherwise, here's what you need to know, with advice from experienced developers.

  • claude.ai is Anthropic's AI chat product in a web browser, a competitor to OpenAI's ChatGPT
  • Claude Desktop is a powerful macOS app that combines the AI chat product and Anthropic's AI coding assistant, Claude Code
  • claude is the command that runs Claude Code in a terminal application

This article explains the differences and shows you the best way to work with Claude.

What to do right now

If you want to get the most from Claude, use my FREE Mac app to set up either the Claude Desktop app or the Claude Code terminal tool. If you are a software developer, install both. For developers or non-developers, my app adds the skills, MCP servers, and starter projects you need, and verifies Claude Code is working. Here are all the details about the app before you download. Then:

Installing a Claude app is one step in setting up your Mac. For the rest, see the Mac setup guide.

Explaining the differences

Here's where the confusion emerges:

  • The four current Claude AI models (LLMs, or large language models) are named Fable, Opus, Sonnet, and Haiku, and vary in power and price. Free users can chat with Sonnet and Haiku, but not Opus or Fable.
  • With a paid plan, you can chat with any of the Claude AI models three ways on a Mac, in either a web browser, the Claude Desktop app, or the claude command-line tool.
  • Claude Code, the coding assistant, is available two ways on a Mac, in both the terminal (with a CLI, or command-line interface) and in the Claude Desktop app (with a GUI, graphical user interface). It needs a paid plan. You can choose any of the four Claude AI models to run Claude Code.
  • Until recently, Cowork was a separate tab in the Claude Desktop app. It worked directly with files on your computer and used connected apps such as Gmail. Now Anthropic merged it with chat.
  • Despite the name, Claude Code isn't just for coding. Non-developers use it for any projects that require working directly with files, such as research or reports, as they did with Cowork.

In technical terms, Claude Code is a harness, not a model (LLM) or an app. A harness gives the model capabilities, such as reading files and running commands, asks your permission before risky steps, and repeats the cycle of thinking and acting until the task is done. The AI model supplies the intelligence. The harness turns it into an AI agent that works on your tasks.

Here's what matters

Amid the confusion, take away these insights:

  • If you have a paid plan and are not coding, use the Claude Code tab in the Claude Desktop app to work on any projects where you write files to guide AI. Claude Code (in the Desktop or terminal) can read any file in a project folder to gain its context, or working memory.
  • Most software developers install both the Claude Desktop app and the Claude Code command-line tool, switching between the GUI app and CLI tool depending on a task (or mood).
  • Don't bother with claude.ai in the web browser, unless you are away from your computer. Download the Claude Desktop macOS app. It is faster and more full-featured.
  • Claude Code is also available in many code editor apps, such as Zed, VS Code, or JetBrains, but the Claude Desktop macOS app, combined with a Markdown editor, is sufficient for everything unless you are writing code line by line yourself.

Claude Code CLI or Claude Desktop?

Claude Code and Claude Desktop are easy to confuse, because the two overlap. Claude Code is a tool. Claude Desktop is an app that runs it. You can also install Claude Code as a command-line tool that runs in any macOS terminal application, or access it from some code editors. To avoid confusion, I refer to Claude Code in the terminal as Claude Code CLI, the command-line interface version of Claude Code.

Claude Desktop is Anthropic's desktop application for macOS and Windows, with a Linux version in beta. It has two parts:

  • Claude, for both conversation and bigger tasks. You type into one message box. Claude decides whether the task needs a quick answer or a longer piece of work, such as a report, a set of slides, or a spreadsheet. This used to be two tabs, Chat for general conversation and Cowork for longer work that Claude did on its own.
  • Code, which is Claude Code with a graphical interface. A Code tab session can work with the files on your Mac, run in the cloud, or connect to another computer over SSH.

Claude Code vs Cowork

Claude Code and Cowork each provide AI agents. Each works through a task in steps, uses tools, and creates files, rather than only answering a question. They were built for different kinds of work:

  • Claude Code was built for software. It works in a project folder you choose. It reads the folder's files, edits them, and runs commands and tests, in your terminal or in the Desktop app's Code tab.
  • Cowork, now available in every Claude chat conversation, was built for everyday knowledge work. It drafts documents, slides, and spreadsheets, researches on the web, and works with the apps you've connected, such as Google Drive, Gmail, or Slack. Longer tasks keep running in the cloud after you close your laptop. A task that uses files or apps on your Mac needs Claude Desktop open.

If you write software, use Claude Code. If you don't, which tab you choose depends on the tasks you do. For a quick question or a one-off document, start a conversation in Claude. For a project you will come back to, using files that guide the AI, use the Code tab, as I recommend above.

When to use Claude Code CLI or Claude Desktop

Which you use will depend on your use case:

  • If you "live in the terminal," install the Claude Code CLI and start it with claude in your project folder. See Install Claude Code on Mac.
  • If you prefer a graphical app, install Claude Desktop and use the Code tab. It includes Claude Code, so you only need to set up software tools and sign in to your Anthropic account.
  • Or install both the Claude Desktop app and the Claude Code CLI. The two can run at the same time on the same project. They share your CLAUDE.md, settings, hooks, skills, and MCP servers. Each keeps its own list of sessions, though you can bring a CLI session into the Desktop app.

Either way, you need to set up software tools first. See What's Needed to Run Claude Code.

Compare Claude Code and Claude Desktop at a glance

Here are the differences in brief:

  • What each one is. Claude Code is the AI coding tool that reads your codebase, edits files, and runs commands. Claude Desktop is a desktop application with two parts: Claude, for conversation and bigger tasks, and the Code tab, which is Claude Code with a graphical interface.
  • Where Claude Code runs. The terminal CLI is scriptable, suited to automation and continuous integration (CI) on servers. The same tool also runs in code editors, in the Desktop app's Code tab, on the web at claude.ai/code, and in the Claude app for iPhone and Android.
  • How to start coding. With the CLI, you go to your project folder in a terminal and type claude. With the app, you open it, click the Code tab, and choose a project folder.
  • What you install. Both install with Homebrew (recommended for developers) or with Anthropic's own installer. Claude Desktop installs with brew install --cask claude. The Claude Code CLI installs with brew install --cask claude-code@latest. For step-by-step instructions, see Install Claude Code on Mac and Brew Install Claude Code.
  • Where configuration and MCP servers live. The CLI uses ~/.claude/, ~/.claude.json, a project .claude/ folder, a project CLAUDE.md, and a project .mcp.json. The app uses that same shared configuration and also reads its own file at ~/Library/Application Support/Claude/claude_desktop_config.json. To write a CLAUDE.md file, see Agent Instructions. To add MCP servers, see Add MCP Servers to Claude.
  • Which platforms are supported. The CLI runs on macOS, Windows, and Linux. The desktop app runs on macOS and Windows, with a Linux version in beta for Ubuntu and Debian.
  • What each is best for. The CLI suits terminal workflows, scripting, and CI. The Desktop app is the more full-featured choice. Its Code tab runs several coding sessions side by side and keeps their history. Its Claude side handles conversation and the bigger tasks Cowork used to do.

Set up MCP servers in the right config file

MCP servers connect AI agents to services they can't reach on their own, such as web searches and macOS apps. Claude Code and Claude Desktop keep them in different files, so a server you add in one place doesn't always appear in the other:

  • Servers in ~/.claude.json, where claude mcp add puts them, and servers in a project's .mcp.json file work in both the terminal CLI and the Desktop app's Code tab.
  • Servers in the Desktop app's own file, claude_desktop_config.json, work in the app's Claude conversations and in Code tab sessions that run on your Mac. If a server has the same name in both places, the Code tab uses the one in claude_desktop_config.json.

The terminal CLI doesn't read claude_desktop_config.json. To copy the servers you added in the Desktop app into the CLI, run:

$ claude mcp add-from-claude-desktop

For step-by-step setup in both, see Add MCP Servers to Claude.

You will need a paid plan for Claude Code

Claude Code, in the terminal CLI or the Desktop app's Code tab, is included in all paid Claude plans, according to Anthropic's pricing page. The terminal CLI also works with an Anthropic Console account, which bills by usage. The Free plan doesn't include Claude Code, so clicking the Code tab on a free account prompts you to upgrade. Free users can still have conversations with Claude, on the web or in the Desktop app. Plan names and prices change, so check the current plans at claude.com/pricing.

Continue setting up your Mac

Don't miss the full visual roadmap and checklist that shows how to set up a Mac for software development, with all the essential tools and settings you might not yet know about.