How to install Claude Code on Mac and Windows — no developer experience required.
Claude Code is the fastest way to run a real AI coding agent on your own machine. This guide walks through the full install on Mac and Windows, your first prompt, enabling auto mode so the agent can take action without confirming every step, and what to actually build once you're running.
- You need a paid Claude plan (Pro, Max, Team, or Enterprise) or an Anthropic API key — the free Claude.ai plan doesn't include Claude Code. The install takes under 10 minutes on both Mac and Windows.
- The fastest path is Anthropic's native installer — no Node.js needed. On Mac/Linux: curl -fsSL https://claude.ai/install.sh | bash. On Windows (native, no WSL): irm https://claude.ai/install.ps1 | iex.
- Auto mode lets the agent take actions — read files, write code, run commands — without asking you to confirm every step. It's the mode you want for real work.
- The best first project after install: point it at a file you want improved and describe the goal in plain English. You don't need to write code yourself.
What is Claude Code and who is it for?
Claude Code is Anthropic's command-line AI coding agent. Unlike Claude in the browser, Claude Code runs on your own computer — it can read files, edit code, run terminal commands, and carry out multi-step tasks without you having to copy-paste anything between windows. It's built for developers, but the install process is the same for anyone, and you don't need to write code to get value out of it immediately.
The most common non-developer uses: editing and improving existing HTML or document files, running optimization scripts against your own content, automating repetitive file tasks, and directing it to make changes to a website or project one plain-English instruction at a time. The agent handles the technical steps; you provide the goal.
What separates Claude Code from the web interface is that it has direct access to your filesystem. It can open a file, rewrite it, save it, and run a check — all in one instruction. That loop — read, change, verify — is what makes it genuinely useful for optimization work rather than just answering questions.
How do I install Claude Code on Mac?
Open the Terminal app and run one command: curl -fsSL https://claude.ai/install.sh | bash. That's the native installer Anthropic now recommends, and it needs no Node.js and no Homebrew. The whole thing takes about 5 minutes the first time. Per Anthropic's official setup docs (verified June 15, 2026), Claude Code requires macOS 13.0 or later and 4 GB+ of RAM.
Step 1 — Run the installer
Open the Terminal app (find it in Applications → Utilities, or press Command + Space and type "Terminal"). Paste this command and press Enter:
curl -fsSL https://claude.ai/install.sh | bash
The installer downloads the Claude Code binary, puts it on your system path, and keeps itself updated in the background. Prefer Homebrew? brew install --cask claude-code works too (you'll update it yourself with brew upgrade claude-code).
Step 2 — Verify and launch
Confirm it installed by typing claude --version and pressing Enter — you should see a version number. Then type claude and press Enter to start it. The first time, it opens a browser window to log in with your Anthropic account (or you can paste an API key). If anything looks off, claude doctor checks your setup.
Alternative: install with npm
If you already have Node.js (version 18 or later, per Anthropic's docs) or prefer the package-manager route, you can install Claude Code globally with npm instead:
npm install -g @anthropic-ai/claude-code
Don't have Node? Install it first with Homebrew (brew install node), then run the npm command above. Either way, you finish by typing claude to launch. Anthropic advises against sudo npm install -g — if you hit permission errors, the native installer above sidesteps them entirely.
How do I install Claude Code on Windows?
Open PowerShell and run irm https://claude.ai/install.ps1 | iex. Claude Code now runs natively on Windows — you no longer need WSL. Per Anthropic's setup docs (verified June 15, 2026), native Windows requires Windows 10 (build 1809) or later; WSL is still supported and is the path to choose if you want a Linux toolchain or sandboxed command execution.
Option A — Native Windows (recommended)
Open PowerShell (search for it in the Start menu — you do not need to run it as Administrator) and run:
irm https://claude.ai/install.ps1 | iex
That downloads and installs Claude Code, then keeps it updated automatically. When it finishes, type claude and press Enter to launch, and follow the browser login prompts. Installing Git for Windows is optional but recommended — it lets Claude Code use the Bash tool; without it, Claude Code uses PowerShell for shell commands.
Option B — WSL (for Linux toolchains)
If you want a full Linux environment inside Windows, open PowerShell as Administrator and run wsl --install, then restart when prompted. Open the Ubuntu app that appears in your Start menu, complete its setup, and inside the Ubuntu terminal run the same native installer as Mac and Linux:
curl -fsSL https://claude.ai/install.sh | bash
Then type claude to launch and follow the login prompts. You run and launch Claude Code inside the WSL terminal, not from PowerShell.
Before you set Claude Code loose on your content, a 12-point check tells you what to fix first. Free, email only.
Take the free assessmentWhat happens on your first run, and how do you enable auto mode?
You land in an interactive session scoped to your current folder, and you turn on auto mode by approving permissions when Claude Code asks. The first time you type claude and log in, Claude Code reads your current directory — the folder your terminal is in — as the working context. Everything it does is relative to that folder unless you tell it otherwise.
By default, Claude Code runs in a cautious mode where it asks permission before taking actions (reading files, making edits, running commands). This is sensible for first use, but for real optimization work you want auto mode, where it can carry out a full instruction end-to-end without interrupting you at every step.
The recommended way to enable auto mode is to grant permissions through the in-session prompt when Claude Code asks — you can allow a tool for the rest of the session in one keystroke. There is also a blanket --dangerously-skip-permissions flag that skips every confirmation; the name is Anthropic's own warning, so reserve it for a throwaway copy of a project you can afford to lose. For everyday editing of your own local HTML and content files the risk is low — Claude Code is changing files just as a text editor would, and you can undo any change with git. For anything touching live servers, production databases, or external systems, review each proposed action first.
A good first prompt to test that everything is working: navigate to a folder that has a text or HTML file in it, type claude, and then at the prompt write something like: "Read the file landing-page.html and list the five things you'd improve about the headline section, in order of expected impact." You should see Claude Code read the file and give you a specific, file-grounded response — not a generic answer. If it does, your install is working correctly.
Useful Claude Code commands to know
| What you type | What it does |
|---|---|
| claude | Start an interactive session in the current folder |
| claude -p "instruction" | Run a single non-interactive task and exit (good for scripts) |
| /clear (in session) | Clear the conversation context and start fresh |
| /cost (in session) | Show estimated token cost for the current session |
| Escape key | Cancel the current in-progress action |
What should marketers build first with Claude Code?
Start by pointing it at one real file with a concrete goal — a landing page to improve, an email sequence to audit, or a keep-the-winner optimization loop. The most common mistake after installing Claude Code is using it like a chat assistant — asking it questions and reading the answers. That misses its advantage entirely. Claude Code is most powerful when you give it a goal and a file, and let it take the action itself.
Here are the three starting projects that produce immediate results for non-developers:
- Landing page headline optimizer. Navigate to your site's HTML file and ask Claude Code to generate five headline variants for a specific section, explain the hypothesis behind each, and output them as a ready-to-test list. You evaluate, pick the best two, tell it to swap them in.
- Email sequence auditor. Put your welcome emails in a folder and ask Claude Code to read all of them, identify the weakest CTA in each, and suggest a replacement with a brief rationale. No code required — it's working on plain text files.
- Autoresearch loop runner. This is the most powerful use: a program.md instruction file that tells Claude Code to propose a change, apply it, score it against a baseline, keep it if it wins and revert if it doesn't — then repeat. The Playbook has 12 templates with this loop pre-written.
The common thread: you write a plain-English instruction, Claude Code handles the implementation. Your job is to define the goal and evaluate the outputs — the agent does the iteration. That division of labor is the whole point, and the Autoresearch Playbook gives you 12 loop templates that already encode the right instruction structure, scoring logic, and safety limits so you're not starting from a blank program.md.
Frequently asked questions
Do I need a paid Claude subscription to use Claude Code?
Yes — the free Claude.ai plan does not include Claude Code. Per Anthropic's setup docs, you need a paid plan (Pro, Max, Team, or Enterprise) or an Anthropic Console/API account, which lets you pay per token without a subscription. Claude Pro at $20/month is the cheapest entry point; Max gives you more headroom for heavier use. Note the June 15, 2026 billing change: interactive terminal use draws from your normal plan, while programmatic use (the Agent SDK, claude -p in scripts, Claude Code in CI) runs on a separate monthly agent credit that then bills at standard API rates.
Is Claude Code safe to run on my files?
In auto mode, Claude Code can edit files and run terminal commands. Run it on a copy of your project first until you're comfortable with what it does. For local HTML and text files, the risk is low — if it makes a change you don't like, you undo it with git or by reverting the file. Never point it at a live production server in auto mode without understanding what commands it might run.
How is Claude Code different from Claude in the browser?
Claude in the browser is a conversation interface — it can generate and discuss content, but you have to copy the output and do something with it yourself. Claude Code runs on your machine and can take actions directly: open a file, edit it, run a script, check the output. The loop is complete without you in the middle. That's the difference between a tool that gives you answers and one that gets things done.
Can I use Claude Code without knowing how to code?
Yes. The install requires running two commands in a terminal, but after that you communicate with Claude Code in plain English. You describe what you want — "improve the headline on this page," "review these emails and suggest better subject lines," "apply this change and tell me if it made the page faster" — and it handles the implementation. No coding knowledge required to get value from it on text and content tasks.