Home / Resources / Claude Code

Installation guide

Install Claude Code

Install the CLI, sign in to your provider account, and start working from a project folder.

Last reviewed:

Before you begin

  • A terminal, an internet connection, and a project folder.
  • Access to Claude Code through an eligible Claude account, Claude Console, or a supported organization setup.

Authentication and access are managed directly by each provider.

Install your CLI

The native installer is the recommended starting point. Homebrew is an alternative for macOS users who already use it.

Choose one installation method. Copy the command for your system and run it in your own terminal.

macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows · PowerShell
irm https://claude.ai/install.ps1 | iex
macOS · Homebrew
brew install --cask claude-code

Check the installation

After installation, open a new terminal window. A working installation prints its version.

Terminal
claude --version

Sign in and start

Open a terminal in a project folder you want to work with, then start the CLI:

Terminal
claude

Follow the sign-in instructions shown by Claude Code. Complete account authentication in the provider’s own flow. For a managed account, use the method your organization supplies.

Try your first task

Begin by asking for an explanation of the project. Review the response before requesting edits.

Explain the structure of this project without modifying files.

If something goes wrong

Command not found

Open a fresh terminal. If the command is still missing, follow the PATH instructions in the official setup guide.

Wrong Windows shell

The Windows command here is for PowerShell. In WSL, use the Linux command.

Need an installation diagnosis?

Run the diagnostic command below and follow its reported findings.

Terminal
claude doctor

Keep it up to date

Native installations update automatically. For the Homebrew method shown above, use brew upgrade claude-code. The setup reference covers other methods and release channels.

Official sources

These are independent guides to the providers’ tools. ORQST integration availability follows the product roadmap.

Another useful guideInstall Codex CLIAll resources