| title | Home |
|---|---|
| nav_order | 0 |
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
📂 View source & contribute on GitHub — docs, examples, and full guide in one repo.
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
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
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
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
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.
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.
Essential foundations for all users
Sections Covered: 0. Introduction - Getting Started - Gentle onboarding for first-time users
-
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)
-
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
-
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)
Comprehensive coverage of CLI workflows and VS Code extension
Sections Covered:
-
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)
-
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
-
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
-
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
-
Advanced CLI Patterns
- Multi-repository workflows
- Monorepo navigation
- Parallel execution patterns
- Tool integration (git, docker, kubectl)
- Terminal multiplexing
- Remote execution (SSH, cloud shells)
-
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
Programmatic integration and custom agents
Sections Covered: 8. 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
-
Building Agents with Agent SDK
- Agent SDK architecture
- Codebase understanding & file editing
- Multi-agent orchestration
- Custom agent patterns
- Performance monitoring
- Real-world examples
-
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
Production deployment and infrastructure automation
Sections Covered: 11. 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
-
Architecture & System Design
- Microservices architecture
- API design automation
- Database schema design
- Event-driven patterns
- Architecture Decision Records (ADRs)
- Technical debt analysis
-
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
Advanced techniques for optimal results
Sections Covered: 14. Advanced Prompt Engineering - Chain-of-thought for complex features - Multishot examples - XML tags for structure - Role-based prompting - Constraint specification - Output format control
-
Context Management & Optimization
- Token budget management
- Prompt caching optimization
- Relevant context selection
- Multi-document reasoning
- Contextual embeddings
- CLAUDE.md best practices
-
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
Specialized workflows and team patterns
Sections Covered: 17. Domain-Specific Workflows - Frontend (React, Next.js, screenshot-to-code) - Backend (APIs, databases, auth) - Data Engineering (ETL, SQL optimization) - ML/AI (pipelines, deployment)
-
Team Collaboration Patterns
- Shared configuration management
- Team skills repositories
- Code review workflows
- Onboarding automation
- Pair programming with Claude
- Productivity metrics
-
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)
Complete reference and solutions
Sections Covered: 20. Complete Reference Guide - CLI command reference - API parameter reference - Agent SDK API docs - Skills API reference - Prompt templates library
-
Troubleshooting & Common Issues
- Authentication issues
- Extended thinking problems
- Context window overflow
- MCP connection failures
- Performance issues
- Cost overruns
-
Productivity Benchmarks & ROI
- Real-world metrics
- Time savings by task type
- Cost analysis
- ROI calculations
- Comparison with alternatives
-
Best Practices & Anti-patterns
- What makes good prompts
- Common failure modes
- Anti-patterns to avoid
- Code review checklist
-
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
Too many options is overwhelming. Choose ONE path based on your immediate goal:
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
Goal: Daily workflow mastery
Time: 4 hours (split across multiple sessions)
For: Individual developers wanting comprehensive knowledge
Hour 1: Foundations (60 min)
- Part 0: Introduction: Getting started (if not completed)
- Part 1, Sections 01-03: Mental models, setup, workflows
- Checkpoint: Can explain when to use CLI vs Extension vs API
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)
- Part 7, Section 20: Complete reference guide & prompt library
- Part 6, Section 17: Choose your domain (frontend/backend/data/ML)
- Checkpoint: Have saved 10+ prompts for daily use
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)
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
Answer these questions:
-
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)
-
Are you rolling this out to a team?
- Yes → Path 3 (2 hour team enablement)
- No → Path 1 or 2 (individual use)
-
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.
| 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 |
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
- Claude API Docs: platform.claude.com/docs
- Claude Code: claude.com/claude-code
- Agent SDK: github.com/anthropics/claude-agent-sdk-typescript
- Skills Repository: github.com/anthropics/skills
- Anthropic Cookbook: github.com/anthropics/anthropic-cookbook
- Discord: anthropic.com/discord
- Twitter: @anthropicai
- GitHub: github.com/anthropics
- License: CC BY 4.0
- Contributions: Welcome via PR
Start reading: Part 1: Fundamentals & Core Concepts →
All parts: 0. Introduction - Getting Started ← Start here if new to Claude Code
- Fundamentals & Core Concepts
- Tools Mastery (CLI & VS Code Extension)
- Advanced API & Agent Development
- Enterprise & DevOps Integration
- Prompt Engineering & Context Mastery
- Domain-Specific & Team Collaboration
- Reference, Troubleshooting & Future
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 →