Phase 1 (repo): update machine-readable/llms.txt (v3.8.0→3.32.2, 87→238 templates, 9.6K→22.7K lines), create root llms.txt per llmstxt.org convention, create llms-full.txt (~20KB: cheatsheet, template list, FAQ), sync mcp-server/content/llms.txt. Phase 4 (README): replace invisible HTML keyword comment with visible mini-FAQ (5 Q&A) for GEO crawlers. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
9.2 KiB
Claude Code Ultimate Guide
6 months of daily practice distilled into a guide that teaches you the WHY, not just the what. From core concepts to production security, you learn to design your own agentic workflows instead of copy-pasting configs.
If this guide helps you, give it a star ⭐ — it helps others discover it too.
Choose Your Path
| Who you are | Your guide |
|---|---|
| 🏗️ Tech Lead / Engineering Manager | Deploying Claude Code across your team → |
| 📊 CTO / Decision Maker | ROI, security posture, team adoption → |
| 💼 CIO / CEO | Budget, risk, what to ask your tech team (3 min) → |
| 🎨 Product Manager / Designer | Vibe coding, working with AI-assisted dev teams → |
| ✍️ Writer / Ops / Manager | Claude Cowork Guide (separate repo) → |
| 👨💻 Developer (all levels) | You're in the right place — read on ↓ |
| 🧭 Career pivot / new AI role | AI Roles & Career Paths → |
The Golden Rules
- Verify trust — Claude Code can generate 1.75× more logic errors than human-written code (ACM 2025). Test everything. Use
/insightsand peer review for production paths. - Vet your MCPs — 15 vulnerabilities tracked, 655 malicious skills in supply chain. Run the 5-min audit checklist before trusting any MCP server.
- Manage context pressure — At 70% context, precision drops. At 90%+, responses become erratic. Run
/compactat 70%,/clearat 90%. - Start simple, scale when proven — Basic CLAUDE.md first. Add agents and skills only after 2 weeks of proven need in production.
- Methodologies matter more with AI — TDD/SDD/BDD are not optional. AI accelerates bad code as fast as good code.
Full reference: Cheat Sheet · Security Guide
Quick Start
npm install -g @anthropic-ai/claude-code
cd your-project
claude
Three commands that matter on day one: /help (discover features), /init (create CLAUDE.md), /compact (free context space).
Personalized onboarding (no setup needed):
claude "Fetch and follow the onboarding instructions from: https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md"
MCP Server — use this guide from any Claude Code session without cloning:
{
"mcpServers": {
"claude-code-guide": {
"type": "stdio",
"command": "npx",
"args": ["-y", "claude-code-ultimate-guide-mcp"]
}
}
}
→ MCP Server README — 12 tools, 8 slash commands /ccguide:*, Haiku agent
What's Inside
| Section | What you get |
|---|---|
| Ultimate Guide | 22,000+ lines — the complete reference across 10 sections |
| Cheat Sheet | 1-page printable daily reference |
| Templates | 222 production-ready templates — agents, commands, hooks, skills |
| Whitepapers | 11 focused whitepapers (FR + EN) — architecture, security, privacy, teams |
| Quiz | 271 questions, 4 profiles, instant feedback with doc links |
| Visual Diagrams | 41 Mermaid diagrams — master loop, multi-agent topologies, security threats |
| Security DB | 15 vulnerabilities + 655 malicious skills tracked |
| Methodologies | TDD, SDD, BDD, GSD — full workflow guides with rationale |
| Architecture | How Claude Code works internally (context flow, tool orchestration) |
| Claude Code Releases | Condensed official changelog with highlights |
| Resource Evaluations | 84 evidence-based assessments (5-point scoring) |
| AI Roles & Career Paths | 13 roles mapped — from Prompt Engineer to Harness Engineer, with career matrix and salary benchmarks |
Whitepapers
11 whitepapers in French and English, covering: foundations, prompting, customization, security in production, architecture, team deployment, privacy & compliance, reference guide, agent teams, learning with AI, and budget optimization.
Coming soon — currently in private access. Public release planned.
→ Browse whitepapers/ · Recap Cards (57 A4 reference cards)
Ecosystem
cc-copilot-bridge routes Claude Code through GitHub Copilot Pro+ for flat-rate access — GitHub
Complementary tools: everything-claude-code (production configs) · awesome-claude-code (curation) · skills.sh (marketplace)
Community: 🇫🇷 Dev With AI — 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon
Contributing & License
Contributing — Corrections, quiz questions, methodologies, resource evaluations all welcome. See CONTRIBUTING.md · GitHub Issues · Discussions
Guide License: CC BY-SA 4.0 · Templates: CC0 1.0 (copy-paste freely, no attribution needed)
Author: Florian Bruniaux — Founding Engineer @ Méthode Aristote · GitHub · LinkedIn
Version 3.32.2 | Updated daily · Mar 9, 2026 | cc.bruniaux.com
FAQ
What is the Claude Code Ultimate Guide? The most comprehensive community guide for Claude Code (Anthropic's CLI for AI-assisted development). 22,760+ lines of documentation, 238 production-ready templates for agents, hooks, skills, and commands. Free and open-source (CC BY-SA 4.0).
How many templates are included? 238 production-ready templates across: agents (backend-architect, security-auditor, code-reviewer), commands (/pr, /commit, /generate-tests), hooks (bash + PowerShell: secrets-scanner, dangerous-actions-blocker), and skills (pdf-generator, tdd-workflow, landing-page-generator).
Is this guide free? Yes. The guide is CC BY-SA 4.0 (share with attribution). Templates are CC0 (copy-paste freely, no attribution). No paywall, no login.
How is this different from the official Anthropic docs? The official docs explain what Claude Code does. This guide teaches you how to use it effectively in production: security hardening, custom agents, event hooks, CI/CD integration, multi-agent workflows, and real-world patterns built from 6+ months of daily practice.
What topics does it cover? Claude Code tutorial, anthropic CLI, AI coding assistant, claude code MCP servers, custom agents, claude code hooks, reusable skills, agentic coding workflows, AI pair programming, TDD/SDD/BDD with AI, context window management, data privacy with Anthropic, claude code architecture, team adoption, security hardening.