Claude Code

Getting Started with Claude Code

Everything you need to install, configure, and run your first successful Claude Code session.

Prerequisites

Node.js 18+

Required for Claude Code installation

Git

For version control integration

Claude account

Sign up at claude.ai

Installation

1

Install Claude Code CLI

Install globally to make the claude command available system-wide

$ npm install -g claude-code
2

Authenticate

Follow prompts to authenticate with your Claude account

$ claude auth login
3

Verify installation

Confirm Claude Code is installed and accessible

$ claude --version

Your first session

1

Navigate to your project

Open terminal and cd into your project directory

cd ~/projects/my-app
2

Start Claude Code

Launch Claude in your project context

claude
3

Describe your task clearly

Be specific about what you want to accomplish

I need to add input validation to the login form. Check for empty fields and valid email format.
4

Request a plan first

Ask Claude to outline the approach before making changes

Can you create a plan for this before implementing?
5

Review and approve

Read through the plan, ask questions, then approve or adjust

That looks good. Let's proceed with the implementation.
6

Verify changes

Review diffs, run tests, and ensure everything works

git diff to see changes, npm test to validate

Good first tasks

Understand existing code

"Explain how the authentication system works in this codebase"

When joining a new project or codebase

Fix a simple bug

"The login button doesn't work when email is empty. Can you fix this?"

When you have a clear, isolated issue

Add a small feature

"Add a character counter to the bio text area that shows '250 characters remaining'"

When you want to add simple, well-defined functionality

Write tests

"Add unit tests for the validateEmail function with edge cases"

When you need test coverage for existing code

Essential tips

Start small

Begin with simple tasks to build confidence and understand how Claude Code works before tackling complex changes

Be specific in prompts

Vague requests lead to vague results. Include constraints, requirements, and examples

Always review changes

Never blindly accept code. Use git diff and understand what changed before committing

Iterate with feedback

If the first result isn't perfect, provide specific feedback rather than starting over

Use plan mode

For anything beyond trivial changes, request a plan first to catch issues early

Common beginner mistakes

Trying to do too much at once

Solution: Break large tasks into smaller, sequential steps. Complete and verify each before moving on

Not providing enough context

Solution: Share error messages, requirements, constraints, and examples to help Claude understand fully

Skipping the review step

Solution: Always review diffs and run tests. Trust but verify every change

Working without version control

Solution: Always use git. Commit working code before asking Claude to make changes

Keyboard shortcuts

Ctrl+C

Exit current operation

Ctrl+D

End input / Exit Claude

Up/Down arrows

Navigate command history

Next steps