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.

- Open a terminal. On Windows, PowerShell shows
PS C:\in the prompt and CMD showsC:\. - Run the install command for your system (the next section lists all of them). Open a new terminal window when it finishes.
- Check it with
claude --version. A working install prints a version number followed by(Claude Code). - Move into your project with
cd /path/to/your/project, then runclaude. - Sign in. The quickstart says "Claude Code prompts you to log in on first use." Follow the browser prompts, and type
/loginlater if you need to switch accounts. - Ask a question before you change anything, such as
what does this project do?, then try a small edit likeadd a hello world function to the main file. Approve the change when Claude asks.
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 in | What it costs | Good for |
|---|---|---|
| Claude Free | $0, Claude Code not included | Chatting only |
| Claude Pro | $20 a month, or $200 billed up front | The baseline usage allowance |
| Claude Max | From $100 a month | 5x Pro usage per window |
| Claude Ultra | $200 a month | Weekly usage at 10x Pro, per the pricing page |
| Claude Console | Pre-paid API credits, billed per token | Pay-as-you-go; a Claude Code workspace is created in the Console on first login |
| Bedrock, Google Cloud, Foundry | Billed by your cloud provider | Company 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:
| System | Command | Updates itself? | |
|---|---|---|---|
| macOS, Linux, WSL | `curl -fsSL https://claude.ai/install.sh \ | bash` | Yes |
| Windows PowerShell | `irm https://claude.ai/install.ps1 \ | iex` | Yes |
| Windows CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | Yes | |
| Homebrew | brew install --cask claude-code | No, run brew upgrade claude-code | |
| WinGet | winget install Anthropic.ClaudeCode | No, run winget upgrade Anthropic.ClaudeCode | |
| npm | npm install -g @anthropic-ai/claude-code@latest | Needs 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.
| Where | How to start | Catch |
|---|---|---|
| Terminal | Install, then claude | The full feature set |
| VS Code | Search "Claude Code" in Extensions (Ctrl+Shift+X on Windows and Linux, Cmd+Shift+X on Mac), publisher ID anthropic.claude-code | Needs VS Code 1.94.0 or later |
| JetBrains | Install the Claude Code plugin from the JetBrains Marketplace and restart | The CLI must be installed separately |
| Desktop app | Download for macOS or Windows (Linux is in beta on Ubuntu and Debian), sign in, click the Code tab | A paid subscription is required; the CLI isn't needed |
| Web | Open claude.ai/code in a desktop browser or the Claude app for iOS and Android | Runs 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 it | Command | What it does |
|---|---|---|
| Shell | claude | Starts an interactive session |
| Shell | claude "fix the build error" | Starts with a first prompt |
| Shell | claude -p "explain this function" | Runs once and exits |
| Shell | claude -c | Continues the latest conversation in this folder |
| Shell | claude -r | Resumes an earlier conversation |
| Session | /help | Lists commands |
| Session | /clear | Starts a new conversation, and /resume brings the old one back |
| Session | /exit | Quits, 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 see | What it means | Fix | |
|---|---|---|---|
command not found: claude or 'claude' is not recognized | The install folder isn't on your PATH | Open a new terminal, then add ~/.local/bin (macOS, Linux) or %USERPROFILE%\.local\bin (Windows) to PATH | |
The token '&&' is not a valid statement separator | You ran the CMD command in PowerShell | Use `irm https://claude.ai/install.ps1 \ | iex` instead |
'irm' is not recognized as an internal or external command | You ran the PowerShell command in CMD | Use the CMD command from the table above | |
syntax error near unexpected token '<' or a 403 | The script came back as a web page | Usually a proxy or network filter; see the troubleshooting page | |
App unavailable in region | Claude Code isn't offered in your country | Check Anthropic's supported countries | |
OAuth error or 403 Forbidden at login | Authentication failed | Type /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.
- 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
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.