Skip to content

Installing Claude Code

Next - let’s install Claude Code on your computer. We’ll be using the Claude Code desktop app, which includes everything you need to start building.

  1. Go to claude.ai/download (or the official Claude Code download page)
  2. Click “Download for Windows/Mac”
  3. The installer will download (usually to your Downloads folder)
  1. Open the downloaded file from your Downloads folder
  2. Follow the installation wizard
  3. Click “Install” and wait for the installation to complete
  4. Click “Finish” when done
  1. Open the downloaded .dmg file from your Downloads folder
  2. Drag the Claude Code app to your Applications folder
  3. Open Applications and double-click Claude Code
  4. If you see a security warning, click “Open” to confirm
✅ Checkpoint

Claude Code is now installed on your computer!

Before we start, we need to connect Claude code to Github. You need to navigate to Claude’s settings and connect Github.

You will need to authenticate your github login and then you should be taken to the Integrations > Applications >Claude page. Here you can make a choice to select all repositories access or only the one you are working on at this moment.

If you choose to ‘Select repository’, you can select the one you have just created.

You can find more information about the Github Integration on Claude's help site.

Check your Applications folder. If Claude Code is there but won’t open, right-click it and select “Open” to bypass the security warning.

Installation stuck or won’t complete (Windows)

Section titled “Installation stuck or won’t complete (Windows)”

Try running the installer as Administrator:

  1. Right-click the installer file
  2. Select “Run as administrator”
  3. Follow the installation steps again

This can happen with downloaded apps. Try:

  1. Open Terminal
  2. Run: xattr -cr /Applications/Claude\ Code.app
  3. Try opening Claude Code again

Close Command Prompt completely and reopen it. The installation needs a fresh window to work.

Claude Code is installed and Github has been setup so now you are ready to go! Next, you’ll choose a project to build with Claude Code.