All guides

Start here · Lesson 1.1

Claude Code Mac Setup in 6 Steps, No Docker

Rafay Korai · 6 min read · 2026-11-04

The official instructions for Claude Code are written for people who already live in a terminal. If you can open Terminal on a Mac but nothing more, it is easy to stall at the first screen.

This guide goes slowly. Six steps, what each one does, what you should see, and what to do if it does not work. You do not need Docker.

You need a Mac, an account that can use Claude Code, and some unhurried time. The install is a one time job.

Before you start

  • A Mac running macOS 13.0 or later, which is the minimum in Anthropic's setup docs, with at least 4 GB of RAM and an internet connection.
  • An account that can use Claude Code: a Claude Pro, Max, Team or Enterprise subscription, a Claude Console account, or a supported cloud provider. Check Anthropic's site for current details.
  • A folder with something real in it that you want help with.

Install steps change from time to time. If anything below differs from what you see, trust the current instructions at Anthropic's documentation over this page.

The six steps

  1. Open TerminalPress Command and Space, type Terminal and press Enter, as Anthropic's terminal guide describes. A window with a text prompt opens. This is where you type commands.
  2. Run the installerCopy the install command from Anthropic's Claude Code setup page and paste it into Terminal, then press Enter. At the time of writing, the recommended native install for macOS is curl -fsSL https://claude.ai/install.sh | bash, but copy it from the official page, not from here or a third party, in case it has changed.
  3. Wait for it to finishThe docs say the command shows no progress while it downloads, so leave the window open. When the prompt comes back, it is done.
  4. Check it installedOpen a new Terminal window, type claude --version and press Enter. If you see a version number, it worked.
  5. Go to your folderType cd, a space, then drag your project folder from Finder into the Terminal window and press Enter. This tells Terminal where to work.
  6. Start it and sign inType claude and press Enter. Follow the prompts to sign in through your browser. If the browser does not open, the docs say to press c to copy the login URL. Once signed in, you can type your first request.

What you should see

After step six, Claude Code shows a prompt where you type in plain words. Try: "Look at this folder and tell me what is in it. Do not change anything." If it describes your files, you are set up.

The permission prompts

Claude Code asks before it does things like editing a file or running a command. You will see a question with choices.

  • Yes allows that one action.
  • No refuses it. You can add a comment explaining why by pressing Tab.
  • Some prompts also offer "Yes, and don't ask again" for a kind of action. For a command, Anthropic's docs say that is saved per project folder and command, and for file edits it lasts until the session ends. Be cautious with it until you trust the tool.

Newer versions may start in a different permission mode, such as auto mode, where a separate classifier model reviews actions instead of you. Anthropic's permission docs explain each mode, so check which one you are in.

Read each prompt the first few times. They teach you what it is doing. If you do not understand a command it wants to run, say no and ask it to explain.

If something goes wrong

Command not found. Open a new Terminal window and try again. If it still fails, the install folder may not be on your PATH yet, and Anthropic's installation troubleshooting page explains the fix.

Sign in does not open. Press c in Terminal to copy the login URL, then paste it into your browser yourself.

It says you do not have access. Check that your plan includes Claude Code, or that your account is linked correctly.

It is working in the wrong folder. Exit with Ctrl and C twice when nothing is running (the first press clears the prompt, the second exits), change folder with cd, and start again.

If you are stuck, paste the exact error message into a normal AI chat and ask what it means. Error text is usually enough to find the fix.

Keep it safe from day one

  • Open it only in folders you are happy for it to work in.
  • Keep passwords and private keys out of the folder.
  • Work on a copy of anything you cannot replace.
  • Read what it plans to do before you say yes.

What to do next

Setup is only the start. A good order is a small read only job, then a memory file, then a proper brief. The Claude Code tutorial explains what to do with it once it runs.

A few extra tips for a smooth first run

Keep Terminal open while you work, and make the window a comfortable size so you can read the output. If you are unsure what a message means, copy it into an ordinary AI chat and ask for a plain explanation.

Pick a calm time for the first session, not five minutes before a deadline. The goal on day one is only to see it describe a folder and to read a few permission prompts. Speed comes later.

How to stop and restart

You can end a session at any time. Press Ctrl and C twice, or Ctrl and D twice, as the docs list for exiting. When you come back, change to the same folder and start it again. If you keep a memory file in that folder, it will read it again at the start, so you pick up where you left off.

Updating later

Anthropic's docs say native installations update automatically in the background, while Homebrew and WinGet installs do not. Check the documentation for the current way to update.

Questions people ask

Do I need Docker to run Claude Code?

No. You install it directly and run it in Terminal. Docker is optional and not needed to get started.

How long does setup take?

It varies with your connection and account. Allow some unhurried time, including signing in.

Do I need to know how to code?

No. You only need to open Terminal, paste a command and type in plain words.

Does it work on Windows?

Yes. Anthropic lists Windows 10 version 1809 or later, with PowerShell or CMD install commands. This guide covers Mac, and the lesson follows the Mac steps.

Next step

Watch all six steps done on screen in Lesson 1.1, which takes 26 minutes and goes beyond setup into memory, Gmail and rules.

Go deeper with the lesson

This guide gives you the idea. Lesson 1.1, Set up AI to do real work for you takes you through it step by step, in plain words, so you can do it for your own business.