Skip to content
Evidence Lab
English
EnglishРусский
Esc
↑↓navigate↵open⌘Jpreview
On this page

Set up Claude Code

Install Claude Code and verify the first project session.

Result

Claude Code is installed through the supported native installer, starts in the intended project folder, passes its diagnostics, and reads the project’s CLAUDE.md.

The current official setup guide lists macOS 13+, Windows 10 1809+ or Server 2019+, Ubuntu 20.04+, Debian 10+, and Alpine 3.19+, with at least 4 GB RAM and an internet connection. Check the source again if you are installing later; requirements can change.

Actions

  1. Confirm access through Claude Pro, Max, Team, Enterprise, or Console and check that the account is approved for the case. The free Claude.ai plan does not include Claude Code access.
  2. On macOS, Linux, or WSL, run curl -fsSL https://claude.ai/install.sh | bash. In Windows PowerShell, run irm https://claude.ai/install.ps1 | iex.
  3. Verify the installation with claude --version, then run claude doctor for installation and configuration diagnostics.
  4. Change to the dedicated project folder and run claude. Follow the browser sign-in prompt unless the approved environment uses another documented authentication route.
  5. Put the project goal, data boundary, input and output locations, checks, and confirmation rules in CLAUDE.md; do not include credentials.
  6. Ask Claude to identify the current folder and restate the project constraints before the first working request.
  7. Run a read-only orientation step and correct any mismatch in file scope or permissions before giving the real task.

Check

claude --version prints a version, claude doctor reports no blocking installation problem, and a fresh session in the project folder correctly states the rules from CLAUDE.md without copied chat context.

If it fails

Preserve the exact diagnostic output without secrets and follow the official setup guide’s installation and login troubleshooting. Check the current folder, shell, operating-system support, and account entitlement separately. Do not paste tokens into chat or replace an approved account with a personal one silently.

Next: Organise the workspace.