User manual¶
A simple, jargon-free guide to install and start using Claude Code.
1. Install (one command)¶
Open your terminal and paste the command for your system:
- Mac / Linux:
curl -fsSL https://claude.ai/install.sh | bash - Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
When it finishes, close and open a new terminal.
2. Check that it installed¶
It should print a version number. If it says "command not found", open a new terminal or check Troubleshooting.
3. Sign in¶
Go to your project folder and type:
The first time, the browser opens to sign in with your Claude account (Pro, Max, Team or Enterprise — the free plan doesn't include Claude Code). Accept and you're done.
4. Using it¶
Once inside, Claude Code works like a chat in your terminal that can also read and edit your code and run commands in your project. Type what you need in plain language, for example:
- "Explain what this project does."
- "Fix the bug in the login function."
- "Add tests to this file."
Useful commands within the session:
/login— sign in again./help— see the help.- To exit:
Ctrl + Cor type/exit.
5. If something doesn't work¶
- Open a new terminal and try
claude --versionagain. - On Mac, verify you have macOS 13 or later (
sw_vers). - Check Troubleshooting.