How to use Claude Code: install, sign in and first task

In brief

To use Claude Code, install it from a terminal, open a project folder, type claude and sign in with a paid Claude plan or Console account, as of November 2026. The free claude.ai plan has no Claude Code, Pro costs $20 a month, and only the native installer updates itself by default, not Homebrew or WinGet.

Whizi doesn’t connect to Claude Code.

How do you use Claude Code for the first time?

You install it, move into a project folder, run claude, sign in through your browser and type what you want in plain English. That takes six steps and one paid account. Anthropic's quickstart, read on 15 November 2026, gives the order below.

A terracotta Claude starburst glowing at the end of a glass tube on a charcoal plinth, a chrome cursor bar blinking beside it, and a rainbow glass keyboard key in the foreground under warm rim light.
  1. Open a terminal. On Windows, PowerShell shows PS C:\ in the prompt and CMD shows C:\.
  2. Run the install command for your system (the next section lists all of them). Open a new terminal window when it finishes.
  3. Check it with claude --version. A working install prints a version number followed by (Claude Code).
  4. Move into your project with cd /path/to/your/project, then run claude.
  5. Sign in. The quickstart says "Claude Code prompts you to log in on first use." Follow the browser prompts, and type /login later if you need to switch accounts.
  6. Ask a question before you change anything, such as what does this project do?, then try a small edit like add a hello world function to the main file. Approve the change when Claude asks.
Claude Code starts at $20 a month, and the free plan has none
Freeno Claude Code$0Probilled monthly$20Pro$200 billed up front$17 a monthMax5x Pro usage per window$100Ultra10x Pro weekly usage$200each square is $10 a month at claude.com/pricing, November 2026

Claude reads your files as it needs them, so you don't paste code in. Anthropic's advice for beginners is to talk to it like a colleague and be specific. Swap "fix the bug" for "fix the login bug where users see a blank screen after entering wrong credentials". Press Shift+Tab any time to change how much Claude may do without asking.

Which account do you need to use Claude Code?

You need a paid Claude plan or a Claude Console account. Anthropic's setup page says plainly: "The free claude.ai plan does not include Claude Code access." Pro, Max, Ultra, Team and Enterprise all work, and so does a Console account with pre-paid API credits. Companies can also route it through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry.

Way to sign inWhat it costsGood for
Claude Free$0, Claude Code not includedChatting only
Claude Pro$20 a month, or $200 billed up frontThe baseline usage allowance
Claude MaxFrom $100 a month5x Pro usage per window
Claude Ultra$200 a monthWeekly usage at 10x Pro, per the pricing page
Claude ConsolePre-paid API credits, billed per tokenPay-as-you-go; a Claude Code workspace is created in the Console on first login
Bedrock, Google Cloud, FoundryBilled by your cloud providerCompany setups

Prices are from the pricing page and the quickstart on 15 November 2026, before tax. The page notes that "Price and plans are subject to change at Anthropic's discretion." One quirk matters if you hold both kinds of access. If the ANTHROPIC_API_KEY environment variable is set and you approve the key when Claude Code asks, it skips the login prompt. Which plan to buy, and where the API beats each one, is worked out in Claude Code pricing. What the five-hour and weekly windows do is in Claude Code usage limit.

Claude Code also isn't available everywhere. The setup page ties it to Anthropic's supported countries, and the install troubleshooting page says an App unavailable in region message means your country isn't covered.

How do you install Claude Code on Windows, Mac and Linux?

Use the native installer unless you have a reason not to. It is the one Anthropic marks as recommended, and it is the only route that keeps itself current. These are the commands as Anthropic prints them on its setup page, read on 15 November 2026:

SystemCommandUpdates itself?
macOS, Linux, WSL`curl -fsSL https://claude.ai/install.sh \bash`Yes
Windows PowerShell`irm https://claude.ai/install.ps1 \iex`Yes
Windows CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdYes
Homebrewbrew install --cask claude-codeNo, run brew upgrade claude-code
WinGetwinget install Anthropic.ClaudeCodeNo, run winget upgrade Anthropic.ClaudeCode
npmnpm install -g @anthropic-ai/claude-code@latestNeeds a writable npm global directory

Debian, Fedora, RHEL and Alpine also have signed apt, dnf and apk repositories, which don't auto-update either. On Homebrew and WinGet you can opt in by setting CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE to 1, and Claude Code then runs the upgrade for you.

Check the setup before you start. Claude Code needs macOS 13.0 or later, Windows 10 version 1809 or later (or Windows Server 2019), Ubuntu 20.04 or later, Debian 10 or later, or Alpine Linux 3.19 or later, plus 4 GB of RAM and an internet connection. Git is optional. On native Windows, Git for Windows is recommended so Claude can use the Bash tool. Without it, Claude falls back to PowerShell. The npm route needs Node.js 22 or later, and Anthropic warns against running it with sudo.

Two commands keep you out of trouble afterward. claude doctor prints read-only diagnostics for your install and settings without starting a session. claude update applies an update right away. Anthropic also publishes a stable channel that runs about a week behind latest and skips releases with major regressions. Pick it with "autoUpdatesChannel": "stable" in settings.json if you'd rather not run the newest build.

Can you use Claude Code in VS Code, the desktop app or the browser?

Yes. Claude Code runs in your terminal, in VS Code and JetBrains, in a desktop app and on the web, and Anthropic says each surface connects to the same engine, so your CLAUDE.md files, settings and MCP servers carry across. Most surfaces need a Claude plan or a Console account, as of November 2026.

WhereHow to startCatch
TerminalInstall, then claudeThe full feature set
VS CodeSearch "Claude Code" in Extensions (Ctrl+Shift+X on Windows and Linux, Cmd+Shift+X on Mac), publisher ID anthropic.claude-codeNeeds VS Code 1.94.0 or later
JetBrainsInstall the Claude Code plugin from the JetBrains Marketplace and restartThe CLI must be installed separately
Desktop appDownload for macOS or Windows (Linux is in beta on Ubuntu and Debian), sign in, click the Code tabA paid subscription is required; the CLI isn't needed
WebOpen claude.ai/code in a desktop browser or the Claude app for iOS and AndroidRuns in the cloud, no local setup

The VS Code detail catches people out. The extension bundles its own copy of the CLI for its chat panel, but Anthropic's page says "Installing the extension does not put claude on your shell PATH." If you also want claude in the integrated terminal, run the standalone install above. To open the extension, click the Spark icon in the editor toolbar once a file is open, or run "Open in New Tab" from the Command Palette. Other editors that read the same marketplace, such as Cursor, have their own install link on the VS Code page.

Phone use works through the web surface and Remote Control. Anthropic's overview says you can keep a local session going from your phone or any browser with Remote Control, or start a long task on the web or the Claude mobile app and pull it into your terminal with claude --teleport. Teleport requires a claude.ai subscription.

What commands and settings should you learn first?

Learn five shell commands, three session commands and the permission modes, and skip the rest until you need them. Anthropic's quickstart lists the daily ones, and the CLI reference has the full set.

Where you type itCommandWhat it does
ShellclaudeStarts an interactive session
Shellclaude "fix the build error"Starts with a first prompt
Shellclaude -p "explain this function"Runs once and exits
Shellclaude -cContinues the latest conversation in this folder
Shellclaude -rResumes an earlier conversation
Session/helpLists commands
Session/clearStarts a new conversation, and /resume brings the old one back
Session/exitQuits, as does Ctrl+D twice

Permission modes decide how often Claude asks. Anthropic's best-practices page says "Interactive terminal and VS Code sessions start in auto mode," where a separate classifier checks actions before they run. The permission-modes page lists six values for --permission-mode: default, acceptEdits, plan, auto, dontAsk and bypassPermissions. Anthropic's warning for the last one is to use it only in isolated environments such as containers or VMs. For the commands that matter day to day, and what /init does, see Claude Code commands. Plan mode, where Claude proposes before it edits, has its own page: Claude Code plan mode.

Three habits come straight from Anthropic's best-practices page. Run /init once and it drafts a CLAUDE.md for your project, and the page says to keep that file short because every line costs attention on every task. Press Esc the moment Claude drifts. And after two failed corrections, run /clear and write a better prompt, because a third correction mostly adds to a conversation that already holds two failed attempts. MCP, the way Claude Code reaches tools like Jira or Google Drive, is a longer topic that Claude Code MCP covers.

What errors do you hit first, and how do you fix them?

The most common failure is claude not being found right after a clean install. Anthropic's installation troubleshooting page maps each message to a fix, and these are the ones people meet first, as of November 2026:

What you seeWhat it meansFix
command not found: claude or 'claude' is not recognizedThe install folder isn't on your PATHOpen a new terminal, then add ~/.local/bin (macOS, Linux) or %USERPROFILE%\.local\bin (Windows) to PATH
The token '&&' is not a valid statement separatorYou ran the CMD command in PowerShellUse `irm https://claude.ai/install.ps1 \iex` instead
'irm' is not recognized as an internal or external commandYou ran the PowerShell command in CMDUse the CMD command from the table above
syntax error near unexpected token '<' or a 403The script came back as a web pageUsually a proxy or network filter; see the troubleshooting page
App unavailable in regionClaude Code isn't offered in your countryCheck Anthropic's supported countries
OAuth error or 403 Forbidden at loginAuthentication failedType /login and sign in again

On macOS and Linux the PATH fix is echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc for zsh, then source ~/.zshrc. Bash users write to ~/.bashrc instead. A terminal that was already open keeps its old PATH, and a terminal inside an editor takes its PATH from the editor, so quit and reopen the editor. If you only installed the VS Code extension, there is no claude to find, because the extension keeps a private copy.

When the install is healthy but something still feels off, run claude doctor first. It checks the install, validates your settings files and prints suggested fixes. Anthropic says it reports on the last auto-update attempt too.

What if you want Claude without a coding plan?

If what you want is Claude's answers rather than an agent that edits your repo, a chat app costs less and needs no terminal. Whizi doesn't run Claude Code, and it doesn't touch your files or run commands. What it does is put Claude, GPT and Gemini in one app, so you can paste a stack trace or a function and ask each model for its take.

The Pro plan's first week costs $1.99. The free plan gives 10 messages a day on Whizi AI, Auto and Claude Haiku 5.5, with no card. Free doesn't include the larger Claude, GPT or Gemini models. Pick Claude Code when you want edits made across a project and tests run for you, and a chat app when you want an explanation, a review or a draft you'll paste in yourself.

Workflow checklist
  • Sign up for a paid Claude plan or a Console account first, because the free claude.ai plan has no Claude Code
  • Install with the native command for your system, then open a new terminal and run claude --version
  • Run claude in the project folder, sign in through the browser and ask what the project does before you edit anything
  • Run claude doctor if the install misbehaves, and claude update if you installed with the native installer and want the newest build now
  • If you installed with Homebrew or WinGet, schedule the upgrade command yourself, since neither updates on its own
  • Press Esc when Claude drifts, and run /clear after two failed corrections
Common questions

Frequently asked questions

How do I use Claude Code in the terminal?

Install it with the command for your system, run claude inside your project folder and sign in when the browser opens. Then type a request in plain English, such as what does this project do. Claude Code reads your files as needed and asks before it edits, unless your permission mode says otherwise.

How do I use Claude Code for free?

You can't on a free Claude account. Anthropic's setup page says the free claude.ai plan does not include Claude Code. You need Pro at $20 a month or higher, or a Console account with pre-paid API credits which bills per token.

Do I need to install Claude Code to use it in VS Code?

No for the chat panel, yes for the terminal. The VS Code extension, publisher ID anthropic.claude-code, bundles its own copy of the CLI. It does not put claude on your PATH, so install the standalone CLI too if you want to run claude in the integrated terminal.

How do I use Claude Code on my phone?

Use the web or Remote Control. Claude Code runs at claude.ai/code and in the Claude app for iOS and Android, and Remote Control lets you keep a local session going from your phone. Neither needs local setup on the phone. Anthropic says most surfaces need a Claude subscription or a Console account.