Introduction

The Ultimate Claude Code Guide

A comprehensive, self-contained guide to mastering Claude Code - from zero to power user.

Author: Florian BRUNIAUX | Founding Engineer @Méthode Aristote

Written with: Claude (Anthropic)

Reading time: ~30-40 hours (full) | ~15 minutes (Quick Start only)

Last updated: January 2026

Version: 3.32.2

---

Before You Start

This guide is not official Anthropic documentation. It’s a community resource based on my exploration of Claude Code over several months.

What you’ll find:

• Patterns that have worked for me
• Observations that may not generalize to your workflow
• Time estimates and percentages that are rough approximations, not measurements

What you won’t find:

• Definitive answers (the tool is too new)
• Benchmarked performance claims
• Guarantees that any technique will work for you

Use critically. Experiment. Share what works for you.

⚠️ Note (Jan 2026): If you’ve heard about ClawdBot recently, that’s a different tool. ClawdBot is a self-hosted chatbot assistant accessible via messaging apps (Telegram, WhatsApp, etc.), designed for personal automation and smart home use cases. Claude Code is a CLI tool for developers (terminal/IDE integration) focused on software development workflows. Both use Claude models but serve distinct audiences and use cases. More details in Appendix B: FAQ.

---

TL;DR - The 5-Minute Summary

If you only have 5 minutes, here’s what you need to know:

Essential Commands

claude                    # Start Claude Code
/help                     # Show all commands
/status                   # Check context usage
/compact                  # Compress context when >70%
/clear                    # Fresh start
/plan                     # Safe read-only mode
Ctrl+C                    # Cancel operation

The Workflow

Describe → Claude Analyzes → Review Diff → Accept/Reject → Verify

Context Management (Critical!)

Context %	Action
0-50%	Work freely
50-70%	Be selective
70-90%	/compact now
90%+	/clear required

These thresholds are based on my experience. Your optimal workflow may differ depending on task complexity and working style.

Memory Hierarchy

~/.claude/CLAUDE.md       → Global (all projects)
/project/CLAUDE.md        → Project (committed)
/project/.claude/         → Personal (not committed)

Power Features

Feature	What It Does
Agents	Specialized AI personas for specific tasks
Skills	Reusable knowledge modules
Hooks	Automation scripts triggered by events
MCP Servers	External tools (Serena, Context7, Playwright…)
Plugins	Community-created extension packages

The Golden Rules

1. Always review diffs before accepting changes
2. Use /compact before context gets critical
3. Be specific in your requests (WHAT, WHERE, HOW, VERIFY)
4. Start with Plan Mode for complex/risky tasks
5. Create CLAUDE.md for every project

Quick Decision Tree

Simple task → Just ask Claude
Complex task → Use TodoWrite to plan
Risky change → Enter Plan Mode first
Repeating task → Create an agent or command
Context full → /compact or /clear

Now read Section 1 for the full Quick Start, or jump to any section you need.

---

Choose Your Path

The guide has 11 chapters and 22,000+ lines. You don’t need to read everything — here’s what matters for your situation:

I am…	Read this	Skip this	Time
Developer, getting started	Ch.1 → Ch.2 → Ch.3	Ch.9, Ch.11, Appendix	3h
Developer, intermediate	Ch.2.6 → Ch.4 → Ch.5 → Ch.7	Ch.1, Ch.10 ref only	4h
Power user / senior	Ch.9 (Advanced) → Ch.4-8	Ch.1 Quick Start	2h
Tech Lead / EM	Ch.3.5 → Ch.9.17 → Ch.9.20 → Ch.11	Ch.5-6 detail	1h30
Just need a reference	Ch.10.5 Cheatsheet	Everything else	5 min

---

Top 5 sections by ROI

If you only have time for 5 sections:

1. 2.6 Mental Model — Understand how Claude Code thinks (20 min)
2. 3.1 CLAUDE.md — Persistent memory that survives sessions (30 min)
3. 9.1 The Trinity — The core pattern for agentic work (20 min)
4. 7.4 Security Hooks — Automate guardrails you won’t forget (30 min)
5. 10.5 Cheatsheet — Daily reference, bookmark it (5 min)

---

Table of Contents

• 1. Quick Start (Day 1) 🟢 Beginner ⏱ 45 min
  • 1.1 Installation
  • 1.2 First Workflow
  • 1.3 Essential Commands
  • 1.4 Permission Modes
  • 1.5 Productivity Checklist
  • 1.6 Migrating from Other AI Coding Tools
  • 1.7 Trust Calibration
  • 1.8 Eight Beginner Mistakes
• 2. Core Concepts 🟡 Intermediate ⏱ 60 min
  • 2.1 The Interaction Loop
  • 2.2 Context Management
  • 2.3 Plan Mode
  • 2.4 Rewind
  • 2.5 Model Selection & Thinking Guide
  • 2.6 Mental Model
  • 2.7 Configuration Decision Guide
  • 2.8 Structured Prompting with XML Tags
  • 2.9 Semantic Anchors
  • 2.10 Data Flow & Privacy
  • 2.11 Under the Hood
• 3. Memory & Settings 🟢 Beginner ⏱ 30 min
  • 3.1 Memory Files (CLAUDE.md)
  • 3.2 The .claude/ Folder Structure
  • 3.3 Settings & Permissions
  • 3.4 Precedence Rules
  • 3.5 Team Configuration at Scale
• 4. Agents 🟡 Intermediate ⏱ 45 min
  • 4.1 What Are Agents
  • 4.2 Creating Custom Agents
  • 4.3 Agent Template
  • 4.4 Best Practices
  • 4.5 Agent Examples
• 5. Skills 🟡 Intermediate ⏱ 30 min
  • 5.1 Understanding Skills
  • 5.2 Creating Skills
  • 5.3 Skill Template
  • 5.4 Skill Examples
• 6. Commands 🟡 Intermediate ⏱ 30 min
  • 6.1 Slash Commands
  • 6.2 Creating Custom Commands
  • 6.3 Command Template
  • 6.4 Command Examples
• 7. Hooks 🟡 Intermediate ⏱ 45 min
  • 7.1 The Event System
  • 7.2 Creating Hooks
  • 7.3 Hook Templates
  • 7.4 Security Hooks
  • 7.5 Hook Examples
• 8. MCP Servers 🟡 Intermediate ⏱ 40 min
  • 8.1 What is MCP
  • 8.2 Available Servers
  • 8.3 Configuration
  • 8.4 Server Selection Guide
  • 8.5 Plugin System
  • 8.6 MCP Security
• 9. Advanced Patterns 🔴 Advanced ⏱ 3h
  • 9.1 The Trinity
  • 9.2 Composition Patterns
  • 9.3 CI/CD Integration
  • 9.4 IDE Integration
  • 9.5 Tight Feedback Loops
  • 9.6 Todo as Instruction Mirrors
  • 9.7 Output Styles
  • 9.8 Vibe Coding & Skeleton Projects
  • 9.9 Batch Operations Pattern
  • 9.10 Continuous Improvement Mindset
  • 9.11 Common Pitfalls & Best Practices
  • 9.12 Git Best Practices & Workflows
  • 9.13 Cost Optimization Strategies
  • 9.14 Development Methodologies
  • 9.15 Named Prompting Patterns
  • 9.16 Session Teleportation
  • 9.17 Scaling Patterns: Multi-Instance Workflows
  • 9.18 Codebase Design for Agent Productivity
  • 9.19 Permutation Frameworks
  • 9.20 Agent Teams (Multi-Agent Coordination)
  • 9.21 Legacy Codebase Modernization
  • 9.22 Remote Control (Mobile Access)
• 10. Reference 🟢 All levels ⏱ As needed
  • 10.1 Commands Table
  • 10.2 Keyboard Shortcuts
  • 10.3 Configuration Reference
  • 10.4 Troubleshooting
  • 10.5 Cheatsheet
  • 10.6 Daily Workflow & Checklists
• 11. AI Ecosystem: Complementary Tools 🟡 Intermediate ⏱ 20 min
  • 11.1 Why Complementarity Matters
  • 11.2 Tool Matrix
  • 11.3 Practical Workflows
  • 11.4 Integration Patterns
  • For Non-Developers: Claude Cowork
• Appendix: Templates Collection
  • Appendix A: File Locations Reference
  • Appendix B: FAQ

---

1. Quick Start (Day 1)

Quick jump: Installation · First Workflow · Essential Commands · Permission Modes · Productivity Checklist · Migrating from Other Tools · Beginner Mistakes

---

Reading time: 15 minutes

Skill level: Beginner

Goal: Go from zero to productive

Already using Claude Code? Skip to 1.6 Migration guide or go directly to Ch.2 Core Concepts.