Claude Code: Complete Technical Guide for Senior Developers

Master Index & Navigation

Author: AI-Generated Technical Guide Maintainer: Viachaslau Kudzinau Version: 2.1 Last Updated: February 2026 Based on: Latest Claude Code, API, and Agent SDK documentation

GitHub
📂 View source & contribute on GitHub — docs, examples, and full guide in one repo.

📖 About This Guide

This comprehensive guide covers everything senior developers need to master Claude Code (CLI), Claude API, Agent SDK, and the complete Claude ecosystem. Structured in 7 logical parts for progressive learning from fundamentals to advanced enterprise patterns.

What This Guide Covers:

  • ✅ Claude Code CLI (terminal automation)
  • ✅ Claude Code VS Code Extension (official by Anthropic)
  • ✅ Claude API integration (extended thinking, vision, batching)
  • ✅ Agent SDK development (programmatic agent building)
  • ✅ Skills system (dynamic knowledge loading)
  • ✅ Model Context Protocol (MCP) integration
  • ✅ Enterprise deployment patterns (AWS, GCP hosting)
  • ✅ DevOps & CI/CD automation
  • ✅ Advanced prompt engineering & context optimization
  • ✅ Real-world workflows and templates

⚠️ Important Note: This guide covers Claude Code (CLI + official VS Code extension by Anthropic). This is NOT a Cursor IDE guide - Cursor is a separate product with its own documentation.

🎯 Start Here

Choose your starting point:

Complete Part 0: Introduction - 15 minutes

  • Understand what Claude Code is
  • Install and run your first commands
  • See why it matters for your workflow
  • Get clear navigation for what’s next

Option 2: Already Installed? Quick Reference

Jump to these commands to get immediate value:

  • Code review: git diff | claude "review"
  • Write tests: claude "write tests for [file]"
  • Debug failures: npm test 2>&1 | claude "explain"

Full command library in Part 0-02

Option 3: Deep Dive Learning Paths

See Pick Your Path below for structured learning:

  • Path 1: Get Results in 15 Minutes
  • Path 2: Master Claude Code in 4 Hours
  • Path 3: Enable Your Team

🎯 Quick Navigation

Tool Selection: Use CLI for automation/CI/CD, VS Code Extension for interactive coding, or both for hybrid workflows. See CLI vs VS Code for detailed comparison.

Performance: Enable streaming, use prompt caching with CLAUDE.md, and leverage parallel operations. Full guide: Performance Optimization.

Workflows: Morning routines, commit checklists, PR preparation, and more in Day-in-the-Life Guide.

Troubleshooting: See Troubleshooting Guide for solutions to common issues.

FAQ: Questions about Claude Code vs Cursor, costs, security, and more in FAQ.

🗂️ Guide Structure

Part 0: Introduction - Getting Started

Start here if you’re new to Claude Code (15 minutes)

What you’ll learn:

  • What Claude Code is (and what it’s not)
  • Your first hands-on win in 5 minutes
  • Why it matters for your workflow
  • Navigation map for the rest of the guide

New users: Complete this section before diving into Part 1. It provides essential context and hands-on validation.

Part 1: Fundamentals & Core Concepts

Essential foundations for all users

Sections Covered:

  1. Introduction - Getting Started - Gentle onboarding for first-time users
  2. Mental Models & Architecture - Understanding Claude’s ecosystem
    • Model family (Claude 4 family: Opus 4.5, Sonnet 4/4.5, Haiku 4.5, plus legacy Sonnet 3.7)
    • Tool selection matrix (CLI vs API vs Agent SDK vs VS Code)
    • Extended thinking architecture
    • Vision capabilities for code
    • Model Context Protocol (MCP) basics
    • Skills system fundamentals
    • Context windows (200K-2M tokens)
  3. Environment & Project Setup - Installation and configuration
    • Claude Code CLI installation (all platforms)
    • VS Code extension setup (beta)
    • API key management (Anthropic, AWS, GCP)
    • Project configuration (CLAUDE.md, .claude/settings.json)
    • MCP server configuration
    • Skills repository setup
    • Enterprise deployment options
  4. Core Workflows - Essential development patterns
    • 7-phase feature development workflow
    • Debugging workflow (analyze → diagnose → fix)
    • Code navigation and comprehension
    • Automated task execution
    • Test-driven development
    • Git workflow integration

Key Takeaways:

  • Choose the right tool for each task (CLI for automation, API for integration, Agent SDK for custom agents)
  • Extended thinking enables deep reasoning (1K-32K+ token budgets)
  • CLAUDE.md is your project’s context anchor
  • MCP connects to external datasources (Drive, Jira, Figma, Slack)

Part 2: Tools Mastery (CLI & VS Code Extension)

Comprehensive coverage of CLI workflows and VS Code extension

Sections Covered:

  1. Terminal Workflows & Command Patterns
    • CLI basics and command structure
    • Interactive vs command mode
    • Natural language commands
    • Piping and Unix composition
    • Session management
    • CLI configuration (settings.json)
  2. CLI Automation & Scripting
    • Scripting in bash/zsh/PowerShell
    • Pre-commit hooks and automation
    • CI/CD integration patterns
    • Batch operations
    • Error handling strategies
    • Non-interactive mode
  3. VS Code Extension Guide
    • Installation and setup
    • Interface overview and keyboard shortcuts
    • Plan Mode (preview changes before applying)
    • Context Rewind (undo conversation + code)
    • Interactive features (inline chat, slash commands)
    • Core workflows (development, debugging, review)
    • Configuration and troubleshooting
  4. CLI vs VS Code Extension
    • Decision matrix for tool selection
    • CLI advantages (scriptability, CI/CD)
    • VS Code advantages (GUI, visual feedback, Plan Mode)
    • Hybrid workflows
    • Scenario-based recommendations
  5. Advanced CLI Patterns
    • Multi-repository workflows
    • Monorepo navigation
    • Parallel execution patterns
    • Tool integration (git, docker, kubectl)
    • Terminal multiplexing
    • Remote execution (SSH, cloud shells)
  6. Commands & Plugins System
    • Custom commands for project workflows
    • Official and community plugins
    • Skills system for domain expertise
    • Creating and publishing plugins
    • Team collaboration patterns

Key Takeaways:

  • CLI enables scriptable, automatable workflows
  • VS Code Extension provides visual feedback and Plan Mode for safe refactoring
  • Pipe outputs directly to Claude for analysis
  • Use CLI in CI/CD for automated reviews, testing, documentation
  • VS Code extension offers GUI convenience but less automation

Part 3: Advanced API & Agent Development

Programmatic integration and custom agents

Sections Covered:

  1. Advanced Claude API Features
    • Extended thinking deep dive (budget optimization)
    • Vision API (screenshots, diagrams, PDFs)
    • Batch processing (cost optimization)
    • Prompt caching (90% cost reduction)
    • Streaming vs non-streaming
  2. Building Agents with Agent SDK
    • Agent SDK architecture
    • Codebase understanding & file editing
    • Multi-agent orchestration
    • Custom agent patterns
    • Performance monitoring
    • Real-world examples
  3. Skills System & Knowledge Extension
    • Skills architecture (progressive disclosure)
    • Official Anthropic skills
    • Creating custom skills
    • Skills composition
    • Domain-specific skills
    • Team skills repositories

Key Takeaways:

  • Extended thinking costs more but dramatically improves complex reasoning
  • Batch API reduces costs by 50% for async workloads
  • Agent SDK enables full programmatic control
  • Skills provide just-in-time knowledge loading

Part 4: Enterprise & DevOps Integration

Production deployment and infrastructure automation

Sections Covered:

  1. DevOps & CI/CD Integration
    • Claude Code in GitHub Actions/GitLab CI
    • Automated code reviews
    • Release automation
    • Infrastructure as Code (Terraform, CDK)
    • Kubernetes manifest generation
    • Security scanning integration
  2. Architecture & System Design
    • Microservices architecture
    • API design automation
    • Database schema design
    • Event-driven patterns
    • Architecture Decision Records (ADRs)
    • Technical debt analysis
  3. Security & Compliance
    • Secure coding practices
    • Vulnerability detection
    • Compliance checking (PCI, HIPAA, SOC2)
    • Secrets management
    • Audit trails
    • Data privacy

Key Takeaways:

  • Automate PR reviews with Claude Code in CI/CD
  • Generate IaC with context awareness
  • Use extended thinking for architecture decisions
  • Enterprise hosting (AWS/GCP) for data control

Part 5: Prompt Engineering & Context Mastery

Advanced techniques for optimal results

Sections Covered:

  1. Advanced Prompt Engineering
    • Chain-of-thought for complex features
    • Multishot examples
    • XML tags for structure
    • Role-based prompting
    • Constraint specification
    • Output format control
  2. Context Management & Optimization
    • Token budget management
    • Prompt caching optimization
    • Relevant context selection
    • Multi-document reasoning
    • Contextual embeddings
    • CLAUDE.md best practices
  3. Multi-Model Strategies
    • Choosing between Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5, and legacy models
    • Model ensemble patterns
    • Cost vs performance trade-offs
    • Latency optimization
    • Fallback strategies

Key Takeaways:

  • Extended thinking for planning, Claude Haiku 4.5 for speed
  • Prompt caching significantly reduces repeated context costs
  • CLAUDE.md provides persistent project context
  • Chain models: Claude Opus 4.5 for architecture, Claude Sonnet 4.5 for implementation

Part 6: Domain-Specific & Team Collaboration

Specialized workflows and team patterns

Sections Covered:

  1. Domain-Specific Workflows
    • Frontend (React, Next.js, screenshot-to-code)
    • Backend (APIs, databases, auth)
    • Data Engineering (ETL, SQL optimization)
    • ML/AI (pipelines, deployment)
  2. Team Collaboration Patterns
    • Shared configuration management
    • Team skills repositories
    • Code review workflows
    • Onboarding automation
    • Pair programming with Claude
    • Productivity metrics
  3. Testing & Quality Assurance
    • Test generation (unit, integration, e2e)
    • Coverage analysis
    • Test data generation
    • Performance testing
    • Security testing
    • Continuous testing

Key Takeaways:

  • Domain-specific skills accelerate specialized work
  • Shared CLAUDE.md templates maintain consistency
  • Automate onboarding documentation
  • Measure productivity gains (time-to-PR, PR count)

Part 7: Reference, Troubleshooting & Future

Complete reference and solutions

Sections Covered:

  1. Complete Reference Guide
    • CLI command reference
    • API parameter reference
    • Agent SDK API docs
    • Skills API reference
    • Prompt templates library
  2. Troubleshooting & Common Issues
    • Authentication issues
    • Extended thinking problems
    • Context window overflow
    • MCP connection failures
    • Performance issues
    • Cost overruns
  3. Productivity Benchmarks & ROI
    • Real-world metrics
    • Time savings by task type
    • Cost analysis
    • ROI calculations
    • Comparison with alternatives
  4. Best Practices & Anti-patterns
    • What makes good prompts
    • Common failure modes
    • Anti-patterns to avoid
    • Code review checklist
  5. Future Roadmap & Migration
    • Upcoming features
    • Migration from other tools
    • Staying current
    • Community resources

Key Takeaways:

  • Copy-paste templates for quick starts
  • Common issues have documented solutions
  • Productivity gains: 30-50% typical
  • Keep configurations in version control

🚀 Start Here: Pick Your Path

Too many options is overwhelming. Choose ONE path based on your immediate goal:

Path 1: “Get Results in 15 Minutes” ⚡

Goal: First win TODAY Time: 15 minutes For: First-time users

Complete Part 0: Introduction

You’ll go from “What is this?” to “I just used it successfully!” with hands-on practice.

✅ Success: You ran Claude Code commands with your own code Next: Part 0-04 provides your customized learning path

Path 2: “Master Claude Code in 4 Hours” 🎓

Goal: Daily workflow mastery
Time: 4 hours (split across multiple sessions)
For: Individual developers wanting comprehensive knowledge

Hour 1: Foundations (60 min)

Hour 2: Tools & Automation (60 min)

  • Part 2, Sections 1-6: CLI mastery, VS Code Extension guide
  • 🛠️ Workshop: Automate your git workflow
  • Checkpoint: Have working pre-commit hook with Claude

Hour 3: Advanced Techniques (60 min)

  • Part 5, Sections 14-15: Prompt engineering, context optimization
  • Part 3, Section 8: Extended thinking, vision, batching
  • 🛠️ Workshop: Master prompt patterns
  • Checkpoint: Know how to optimize costs and context

Hour 4: Reference & Specialization (60 min)

Final Deliverables:

  • ✅ Daily workflow established (morning/commit/PR routines)
  • ✅ Automation scripts working (pre-commit hook minimum)
  • ✅ CLAUDE.md created for your project
  • ✅ Productivity gains: 2-3x faster on common tasks

Next steps: Explore domain-specific workflows (Part 6) or API integration (Part 3)

Path 3: “Enable Your Team in 2 Hours” 👥

Goal: Team adoption plan ready to execute
Time: 2 hours
For: Tech leads, engineering managers, team enablers

Phase 1: Build Business Case (30 min)

  • Part 7, Section 22: ROI calculation and productivity benchmarks
  • Action: Create cost-benefit analysis for leadership
  • Deliverable: ROI presentation showing 30-50% productivity gain

Phase 2: Understand Technical Setup (30 min)

  • Part 1, Section 2: Environment & project setup
  • Part 5, Section 15: Context management & CLAUDE.md
  • Action: Plan API key distribution, security model
  • Deliverable: Technical setup checklist

Phase 3: Design Rollout Plan (45 min)

  • Part 6, Section 18: Team collaboration & adoption playbook
  • Action: Identify pilot team (2-3 early adopters)
  • Deliverable: 4-week adoption timeline with checkpoints

Phase 4: Prepare Training Materials (15 min)

  • Scroll to “Get Your First Win in 5 Minutes” (top of this README)
  • Part 7, Section 20: Prompt library for team
  • Action: Customize quick start for your tech stack
  • Deliverable: Internal training guide (30 min presentation)

Final Deliverables:

  • ✅ ROI presentation for leadership approval
  • ✅ 4-week adoption timeline (pilot → rollout → optimization)
  • ✅ Success metrics defined (PR velocity, test coverage, satisfaction)
  • ✅ Training materials ready for pilot team
  • ✅ Shared CLAUDE.md template for team projects

Rollout Timeline (After This 2-Hour Prep):

  • Week 1: Pilot team (2-3 developers) get first wins
  • Week 2: Pilot shares learnings, others see value
  • Week 3: Rollout to full team with training sessions
  • Week 4: Measure results, iterate, optimize

Next steps: Execute pilot phase, track metrics, share success stories

🎯 Not Sure Which Path?

Answer these questions:

  1. Have you used Claude Code before?
    • No → Start with Path 1 (15 min quick start)
    • Yes, but want to level up → Path 2 (4 hour mastery)
  2. Are you rolling this out to a team?
    • Yes → Path 3 (2 hour team enablement)
    • No → Path 1 or 2 (individual use)
  3. How much time do you have right now?
    • 15 minutes → Path 1
    • 2 hours → Path 3 (if leading team) or first 2 hours of Path 2
    • 4+ hours → Path 2 (full mastery)

Still unsure? Default to Path 1 - you’ll get immediate value and can always come back for depth.

📋 Quick Reference Card

Category Quick Guide See Also
Tools CLI (automation) • VS Code (interactive) • API (integration) • Agent SDK (custom agents) Tool Selection
Models Haiku (speed) • Sonnet (daily work) • Opus (complex reasoning) Model Guide
Commands claude (interactive) • claude "task" (one-shot) • git diff \| claude "review" (piped) CLI Workflows
Cost Tips Create CLAUDE.md (90% savings) • Use Haiku for simple tasks • Batch API (50% off) Optimization Guide
Troubleshooting Check API key • Enable streaming • Narrow context • Use right model Troubleshooting

❓ Questions?

See the comprehensive FAQ covering:

  • Product Scope: Claude Code vs Cursor, tool selection
  • Getting Started: Installation, costs, requirements
  • Technical: Model selection, extended thinking, CLAUDE.md
  • Troubleshooting: Performance, costs, authentication
  • Workflows: Best practices, CI/CD, team collaboration
  • Enterprise: Security, self-hosting, key management
  • Comparisons: Claude Code vs GitHub Copilot and other tools

Need help? Check Troubleshooting Guide or ask in the Anthropic Discord

📚 Additional Resources

Official Documentation

Community

This Guide: 2.1 (February 2026)

  • License: CC BY 4.0
  • Contributions: Welcome via PR

🗺️ Navigation

Start reading: Part 1: Fundamentals & Core Concepts →

All parts:

  1. Introduction - Getting Started ← Start here if new to Claude Code
  2. Fundamentals & Core Concepts
  3. Tools Mastery (CLI & VS Code Extension)
  4. Advanced API & Agent Development
  5. Enterprise & DevOps Integration
  6. Prompt Engineering & Context Mastery
  7. Domain-Specific & Team Collaboration
  8. Reference, Troubleshooting & Future

📝 Version History

v2.1 (February 2026) - Introduction Section Update:

  • ✨ NEW: Part 0 - Introduction & Getting Started (15-minute gentle onboarding)
  • ✨ NEW: “What Is Claude Code?” - Clear positioning and differentiation
  • ✨ NEW: “Your First Win in 5 Minutes” - Hands-on quick start
  • ✨ NEW: “Why Claude Code Matters” - Benefits and productivity gains
  • ✨ NEW: “Reading Map” - Clear navigation paths based on user goals
  • 🔄 UPDATED: README learning paths to reference Part 0
  • 🔄 UPDATED: Guide structure to include Part 0 as entry point
  • 📝 Addresses feedback about overwhelming complexity for first-time users

v1.1 (December 2025) - Productivity & Workflow Update:

  • ✨ NEW: “Get Your First Win in 5 Minutes” section with 7 quick-start commands
  • ✨ NEW: Comprehensive productivity patterns section (context windows, progressive disclosure, model selection)
  • ✨ NEW: Practical daily workflow patterns (morning routine, commit checklist, PR preparation, weekly maintenance)
  • ✨ NEW: Extensive FAQ section (30+ questions covering product scope, getting started, technical, troubleshooting)
  • 🔄 UPDATED: Simplified quick start paths (3 clear paths instead of 5)
  • 🔄 UPDATED: Clarified scope throughout (Claude Code vs Cursor disambiguation)
  • 🔄 UPDATED: Replaced abstract checklists with time-boxed, actionable workflows
  • 📝 Emphasis on workflow-first approach vs feature documentation
  • 📝 Added scope clarification: Official Anthropic tools (CLI + VS Code Extension)

v1.0 (December 2025) - Initial Release:

  • Complete 7-part structure with 24 sections
  • Claude Code CLI comprehensive coverage
  • Agent SDK development patterns
  • Skills system integration
  • Extended thinking optimization
  • Prompt caching strategies
  • Enterprise deployment patterns
  • Real-world examples and templates

This guide is built from the latest Anthropic documentation via Context7 MCP. Bookmark and share!

Master Index New to Claude Code? Start with Part 0 → Continue to Part 1 →
This site uses Just the Docs, a documentation theme for Jekyll.