Claude Code Complete Guide 2026: Setup, Pricing, Workflows & Best Practices

TL;DR

Claude Code is Anthropic's terminal-native AI coding agent that reads your entire codebase, edits files directly, runs terminal commands, and manages Git workflows — all from your command line. If you are searching for "how to use Claude Code effectively," the short answer is: install it via npm install -g @anthropic-ai/claude-code, authenticate with your Anthropic API key, navigate to any project directory, and run claude. This guide covers everything from zero to production: setup, pricing, model selection, permission configuration, MCP server integration, CI/CD automation, and comparisons with Cursor and GitHub Copilot.

What Is Claude Code?

Claude Code is an agentic coding tool — not just a code completion engine. Unlike traditional AI code assistants that suggest single lines, Claude Code:

• Reads your entire codebase using repo-map technology to understand project architecture
• Edits files directly on disk (with Git safety nets)
• Executes terminal commands (build, test, lint) and reads their output
• Makes atomic Git commits with descriptive messages
• Supports custom slash commands and project-level instructions via CLAUDE.md
• Runs in CI/CD pipelines for automated PR reviews and code generation

Anthropic launched Claude Code as a research preview in early 2025. By June 2026, it powers over 40% of all Claude API token consumption — making it the most adopted coding agent from a frontier AI lab.

Quick Start: 5-Minute Setup

Prerequisites

• Node.js 18+ and npm
• An Anthropic API key (get one at console.anthropic.com)
• macOS, Linux, or WSL2 on Windows

Installation

# Install globally via npm
npm install -g @anthropic-ai/claude-code

# Verify installation
claude --version

# Start in any project directory
cd my-project
claude

On first run, Claude Code will prompt you to authenticate with your API key. You can also set it via environment variable:

export ANTHROPIC_API_KEY="sk-ant-..."

Basic Workflow

1. Navigate to your project root (where .git lives)
2. Run claude to start a session
3. Describe what you want to build or fix in natural language
4. Review proposed changes — Claude Code shows diffs before modifying files
5. Approve or reject each change
6. Commit — Claude Code creates atomic Git commits automatically

Key Commands

Pricing: How Much Does Claude Code Cost?

Claude Code pricing changed significantly in June 2026. Here is the up-to-date breakdown:

API Pay-As-You-Go

A typical coding session with Sonnet 5 costs $2-5/hour of active use. Heavy daily users report $150-400/month in API costs.

Claude Max Subscription (June 2026)

Anthropic introduced Claude Max — a flat-rate subscription for heavy Claude Code users:

• $100/month — Up to 5× Claude Pro usage
• $200/month — Up to 20× Claude Pro usage
• Includes API access, priority during peak hours, and higher rate limits

For most professional developers, the $200/month plan eliminates the anxiety of metered API billing during intensive coding sessions.

Cost Optimization Tips

1. Use /compact frequently — Reduces context window usage by up to 60%
2. Set model via .claude/settings.json — Route simple tasks to Haiku, complex ones to Sonnet/Opus
3. Limit tool permissions — Restrict terminal access to reduce unnecessary operations
4. Batch tasks — Use claude -p "task1; task2; task3" for multi-step one-shot sessions

Permission System: Security by Design

Claude Code operates with a permission control system that requires explicit approval for risky operations. Understanding this system is critical for secure and efficient workflows.

Permission Modes

Tool-Level Permission Rules (v2.1.178+)

Since June 2026, Claude Code supports granular permission rules using the tool(param:value) syntax:

{
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git:*)",
      "Bash(ls:*)",
      "Bash(python:*)",
      "WebSearch",
      "WebFetch"
    ],
    "deny": [
      "Bash(rm:*)",
      "Bash(sudo:*)",
      "Bash(curl:*)",
      "Bash(wget:*)"
    ]
  }
}

This lets you allow npm install but deny rm -rf, or allow git diff but deny git push --force. The full permission rules documentation is in Anthropic's developer docs.

MCP Integration: Extending Claude Code

Claude Code supports the Model Context Protocol (MCP) — a standard for connecting AI agents to external tools and data sources. With MCP, Claude Code can:

• Query databases (PostgreSQL, SQLite, Redis)
• Access APIs (GitHub, Jira, Linear, Slack)
• Read documentation (fetch URLs, search internal wikis)
• Integrate with Docker, Kubernetes, and cloud services

Setting Up MCP Servers

Create ~/.claude/claude_desktop_config.json or .mcp.json in your project root:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "..."
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://localhost/mydb"
      }
    }
  }
}

After configuration, Claude Code automatically discovers MCP tools on startup. You can then say: "Find all open PRs on our repo and summarize them" — and Claude Code will use the GitHub MCP server to fetch and analyze them.

Claude Code in CI/CD: Automated PR Reviews

One of Claude Code's most powerful use cases is automated pull request review in GitHub Actions. Here is a minimal workflow:

name: Claude Code PR Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Claude Code Review
        env:
          ANTHROPIC_API_KEY: ***API_KEY***
        run: |
          npm install -g @anthropic-ai/claude-code
          claude -p "Review this PR diff. Focus on: security vulnerabilities, logic errors, missing edge cases, and performance issues. Output a structured review with severity levels." \
            --output-format stream-json \
            --permission-mode bypassPermissions \
            --max-turns 15

The --permission-mode bypassPermissions flag is essential in CI — without it, Claude Code would hang waiting for interactive approval. Combine this with --output-format stream-json for structured output that your CI pipeline can parse.

Claude Code vs Competitors

Claude Code vs GitHub Copilot

Claude Code vs Cursor

Which One Should You Choose?

• Use Claude Code if you live in the terminal, need CI/CD automation, or want maximum control over the agent's behavior
• Use Cursor if you prefer a GUI, need visual UI editing, or build full-stack apps with real-time preview
• Use Copilot if you want in-editor completions with minimal setup and fixed monthly pricing
• Use all three — many developers combine Copilot for inline completions, Cursor for visual work, and Claude Code for heavy automated tasks

Best Practices: Getting the Most Out of Claude Code

1. Write a Good CLAUDE.md

The CLAUDE.md file in your project root is Claude Code's instruction manual. Treat it as you would a junior developer's onboarding doc:

# CLAUDE.md for MyProject

## Build & Test Commands
- Install deps: `npm install`
- Run dev server: `npm run dev`
- Run tests: `npm test`
- Lint: `npm run lint`
- Type check: `npm run typecheck`

## Code Style
- Use TypeScript strict mode
- Prefer functional components over class-based
- All API routes must have input validation
- Use Zod for schema validation

## Architecture
- Next.js 14 App Router
- PostgreSQL (Prisma ORM)
- Redis for caching
- Tailwind CSS v4

## Important Constraints
- Never use `any` type
- All database queries must use prepared statements
- API responses must follow the ApiResponse<T> wrapper

2. Start Small, Build Trust

Begin with isolated, low-risk tasks:

"Add a unit test for the calculateDiscount function in src/pricing.ts"
"Update the README with the new API endpoint documentation"
"Refactor this 50-line function — extract the validation logic into a separate file"

As you build trust in Claude Code's output, escalate to larger tasks:

"Implement the entire payment webhook handler with Stripe integration"
"Add full-text search to the products listing page with PostgreSQL tsvector"

3. Use Session Management

Claude Code sessions can grow large. Use these commands to manage context:

• /compact — Summarize conversation history to free up context window
• /review — Review all changes made in the current session
• /clear — Start fresh (saves session for later resume)

4. Combine with Other Tools

Claude Code is not a replacement for your entire toolchain. The best workflows combine:

• GitHub Copilot for inline completions while typing
• Claude Code for complex multi-file refactors and automated PR reviews
• Aider for pair-programming sessions with multi-model support
• n8n for automating content workflows triggered by Claude Code output

5. Guard Against Common Pitfalls

• Over-trusting terminal commands — Always review terminal operations before approving. Use permission rules to block dangerous commands.
• Session length — Sessions over 50 turns can degrade in quality due to context pollution. Use /compact frequently.
• API cost creep — Monitor your Anthropic usage dashboard. A single intensive session can cost $20+. Set billing alerts.
• Model selection — Do not default to Opus for simple tasks. Route linting and boilerplate to Haiku.

Project Configuration Reference

.claude/settings.json

{
  "model": "claude-sonnet-5-20260601",
  "permissions": {
    "allow": ["Bash(npm:*)", "Bash(git:*)", "Bash(ls:*)", "WebSearch"],
    "deny": ["Bash(rm:*)", "Bash(sudo:*)", "Bash(docker:*)", "Bash(curl:*)"]
  },
  "maxTurns": 30,
  "contextWindows": 200000
}

Environment Variables

Frequently Asked Questions

See our Claude Code FAQ for detailed answers to: "Does Claude Code work offline?", "Can I use it with Ollama?", "How does billing work with the Max plan?", and more.

Resources

• Claude Code Official Docs
• Claude Code Permission Rules Guide
• Claude Code Billing Migration Guide (June 2026)
• Claude Code vs Cursor vs Copilot Comparison
• Claude Code + DeepSeek V4 Tutorial: 90% Cheaper API Cost
• Build a Custom MCP Server for Claude Code
• Automate PR Reviews with Claude Code + GitHub Actions
• Claude Code for Content Automation