# 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 β](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers)** β it helps others discover it too.
---
## Choose Your Path
| Who you are | Your guide |
|---|---|
| ποΈ **Tech Lead / Engineering Manager** | [Deploying Claude Code across your team β](docs/for-tech-leads.md) |
| π **CTO / Decision Maker** | [ROI, security posture, team adoption β](docs/for-cto.md) |
| πΌ **CIO / CEO** | [Budget, risk, what to ask your tech team (3 min) β](docs/for-cio-ceo.md) |
| π¨ **Product Manager / Designer** | [Vibe coding, working with AI-assisted dev teams β](docs/for-product-managers.md) |
| βοΈ **Writer / Ops / Manager** | [Claude Cowork Guide (separate repo) β](https://github.com/FlorianBruniaux/claude-cowork-guide) |
| π¨βπ» **Developer (all levels)** | You're in the right place β read on β |
| π§ **Career pivot / new AI role** | [AI Roles & Career Paths β](guide/ai-roles.md) |
---
## The Golden Rules
1. **Verify trust** β Claude Code can generate 1.75Γ more logic errors than human-written code ([ACM 2025](https://dl.acm.org/doi/10.1145/3716848)). Test everything. Use `/insights` and peer review for production paths.
2. **Vet your MCPs** β 15 vulnerabilities tracked, 655 malicious skills in supply chain. Run the 5-min audit checklist before trusting any MCP server.
3. **Manage context pressure** β At 70% context, precision drops. At 90%+, responses become erratic. Run `/compact` at 70%, `/clear` at 90%.
4. **Start simple, scale when proven** β Basic CLAUDE.md first. Add agents and skills only after 2 weeks of proven need in production.
5. **Methodologies matter more with AI** β TDD/SDD/BDD are not optional. AI accelerates bad code as fast as good code.
> Full reference: [Cheat Sheet](./guide/cheatsheet.md) Β· [Security Guide](./guide/security-hardening.md)
---
## Quick Start
```bash
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):
```bash
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:
```json
{
"mcpServers": {
"claude-code-guide": {
"type": "stdio",
"command": "npx",
"args": ["-y", "claude-code-ultimate-guide-mcp"]
}
}
}
```
β [MCP Server README](./mcp-server/README.md) β 12 tools, 8 slash commands `/ccguide:*`, Haiku agent
---
## What's Inside
| Section | What you get |
|---------|-------------|
| [Ultimate Guide](./guide/ultimate-guide.md) | 22,000+ lines β the complete reference across 10 sections |
| [Cheat Sheet](./guide/cheatsheet.md) | 1-page printable daily reference |
| [Templates](./examples/) | 222 production-ready templates β agents, commands, hooks, skills |
| [Whitepapers](./whitepapers/) | 11 focused whitepapers (FR + EN) β architecture, security, privacy, teams |
| [Quiz](./quiz/) | 271 questions, 4 profiles, instant feedback with doc links |
| [Visual Diagrams](./guide/diagrams/) | 41 Mermaid diagrams β master loop, multi-agent topologies, security threats |
| [Security DB](./examples/commands/resources/threat-db.yaml) | 15 vulnerabilities + 655 malicious skills tracked |
| [Methodologies](./guide/methodologies.md) | TDD, SDD, BDD, GSD β full workflow guides with rationale |
| [Architecture](./guide/architecture.md) | How Claude Code works internally (context flow, tool orchestration) |
| [Claude Code Releases](./guide/claude-code-releases.md) | Condensed official changelog with highlights |
| [Resource Evaluations](./docs/resource-evaluations/) | 115 evidence-based assessments (5-point scoring) |
| [AI Roles & Career Paths](./guide/ai-roles.md) | 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/](./whitepapers/) Β· [Recap Cards (57 A4 reference cards)](./whitepapers/recap-cards/)
---
## Ecosystem
**cc-copilot-bridge** routes Claude Code through GitHub Copilot Pro+ for flat-rate access β [GitHub](https://github.com/FlorianBruniaux/cc-copilot-bridge)
**Complementary tools**: [everything-claude-code](https://github.com/affaan-m/everything-claude-code) (production configs) Β· [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) (curation) Β· [skills.sh](https://skills.sh/) (marketplace)
**Community**: π«π· [Dev With AI](https://www.devw.ai/) β 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon
---
## Contributing & License
**Contributing** β Corrections, quiz questions, methodologies, resource evaluations all welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) Β· [GitHub Issues](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/issues) Β· [Discussions](../../discussions)
**Guide License**: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) Β· **Templates**: [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) (copy-paste freely, no attribution needed)
**Author**: [Florian Bruniaux](https://florian.bruniaux.com) β Founding Engineer @ [MΓ©thode Aristote](https://methode-aristote.fr) Β· [GitHub](https://github.com/FlorianBruniaux) Β· [LinkedIn](https://www.linkedin.com/in/florian-bruniaux-43408b83/)
---
*Version 3.32.2 | Updated daily Β· Mar 9, 2026 | [cc.bruniaux.com](https://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.