How to Install Claude Code: Setup Guide (2026)
By the Chatgbot Team · Published August 17, 2026
To install Claude Code, you need three things first: an active Claude account or plan, Node.js on your machine, and a terminal. Once those are ready, you run Anthropic's official install command, sign in with your Claude account, then start the tool inside a project folder.
Claude Code is Anthropic's command line coding assistant. It lives in your terminal, reads your project files, and helps you write, edit, and debug code through conversation. This guide walks you through the full setup at a high level so you can get from zero to a working install.
The exact command can change between versions, so the safest source is always Anthropic's official documentation. Below are the general steps, in order, and how to fix the issues that trip people up most often.
What you need before you install
Claude Code is a developer tool, so a little preparation saves time. Make sure you have each of these in place before you install.
- A Claude account or plan. You authenticate with your Anthropic account. Depending on your setup, that can be a paid Claude plan or API access billed through the Anthropic Console.
- Node.js. Claude Code runs on Node, so you need a current, supported version installed. If you are unsure, install the latest long term support release.
- A terminal. Any standard terminal works: the built in Terminal on macOS or Linux, or a modern terminal on Windows. Claude Code also runs well inside your editor's integrated terminal.
If you want to understand the tool itself before installing, read what Claude Code is first. It explains what the assistant does and who it is for.
Step by step: the general install flow
The install is short. Here is the sequence at a high level, without pinning exact commands that may change between releases.
- Install via the package manager. Claude Code is distributed as a package you install from the terminal. Follow the current official install command from Anthropic's docs rather than copying an old command from a forum, since the recommended method is updated over time.
- Authenticate with your account. The first time you launch it, Claude Code prompts you to sign in. It opens a browser or gives you a link to connect your Claude account. Complete that step and return to the terminal.
- Run it in a project folder. Move into the folder of the project you want to work on, then start Claude Code there. It reads the files in that directory so it can answer questions with real context about your code.
That is the whole path. Prerequisites, install, sign in, open a project. Everything after that is fine tuning.
First run and connecting your project
When you launch Claude Code inside a project for the first time, it looks at the folder you are in. Always start it from the root of the project you care about, not your home directory, so it sees the right files.
On the first run you can ask it to summarize the codebase, explain a file, or make a small change. Claude Code asks for permission before it edits files or runs commands, so nothing happens without your approval. This permission step is a safety feature, so expect to confirm actions as you go.
If your project has setup notes, a package file, or a README, Claude Code uses them to understand how the project is built. The more context it has, the more useful its answers become.
IDE and editor integration
Many people run Claude Code inside their editor instead of a separate window. Popular editors offer integration so the assistant sits next to your code.
- Integrated terminal. The simplest option is to open your editor's built in terminal and run Claude Code there. No extra setup is needed beyond the base install.
- Editor extensions. Some editors have a dedicated Claude Code extension or plugin that adds a panel and shortcuts. Check your editor's marketplace and Anthropic's docs for the current, supported integration.
Running it beside your editor lets you review suggested edits and keep working without switching windows.
Common setup issues and how to fix them
Most install problems fall into three buckets. Here is how to spot and solve each one.
Authentication problems
If sign in fails or loops, confirm you are using the correct Claude account and that your plan or API access is active. Sign out and back in, and make sure your browser can open the login link the terminal gives you. Corporate networks sometimes block the callback, so try a personal connection if you are stuck.
Permission errors during install
If the install fails with a permission denied message, it usually means the package manager cannot write to a system folder. The fix is to install in a way that does not require elevated system access, such as configuring your package manager to use a user owned directory. Avoid forcing the install with broad admin rights, since that can cause more problems later.
Command not found (PATH issues)
If you install successfully but your terminal says the command is not found, the install location is likely missing from your PATH. Close and reopen the terminal first, since that often fixes it. If it persists, add the install directory to your PATH and reload your shell profile.
| Symptom | Likely cause | First fix to try |
|---|---|---|
| Sign in loops or fails | Wrong account or inactive plan | Confirm account and plan, sign in again |
| Permission denied on install | No write access to system folder | Install into a user owned directory |
| Command not found | Install path missing from PATH | Reopen terminal, then update PATH |
How to verify it works
Once installed, a quick check confirms everything is wired up correctly.
- Check the version. Run the version command to confirm the tool is installed and on your PATH.
- Confirm you are signed in. Launch Claude Code and make sure it does not prompt you to authenticate again. If it starts cleanly, your account is connected.
- Ask a simple question. Open a project and ask Claude Code to describe a file or the folder structure. A useful, specific answer means it is reading your project correctly.
If all three pass, your setup is complete and you can start using it for real work. For a sense of what the tool costs across plans, see the Claude Code pricing guide.
Chat with Claude without any setup
Claude Code is built for developers who live in the terminal. If you just want to talk to Claude, brainstorm, or get help with writing and simple coding questions, you do not need to install anything.
Chatgbot includes Claude for chat right in your browser and app, alongside other leading models like GPT, DeepSeek, Qwen, and GLM. You can switch models mid conversation and skip the setup entirely. Claude Code, the Claude API, and Anthropic's other developer tools are separate products you use through Anthropic directly, but for everyday chat with Claude, Chatgbot is the fastest way in. If you are weighing tools, our roundup of the best AI for coding compares the options.
Frequently asked questions
Do I need to know how to code to install Claude Code? You need enough comfort to open a terminal and run a couple of commands, but you do not need to be an expert. If terminals feel unfamiliar, using Claude in a chat app is an easier starting point.
Is Claude Code free? Access is tied to your Claude account or API usage, so costs depend on your plan and how much you use it. Check the current pricing on Anthropic's site and in our pricing guide for details.
What operating systems does Claude Code support? It runs on macOS, Linux, and Windows, since it is built on Node.js and works from a standard terminal. Follow the official docs for any platform specific notes.
Why does Claude Code ask permission before editing? That is by design. Claude Code asks before it changes files or runs commands so you stay in control of your project and nothing happens without your approval.
The easy way to chat with Claude
Installing Claude Code is straightforward once your prerequisites are in place: get your account, Node.js, and terminal ready, run the official install command, sign in, and open a project. If you hit a snag, it is almost always authentication, permissions, or PATH, all of which have simple fixes. For chatting with Claude alongside GPT, DeepSeek, and more, without any install, try Chatgbot.