marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader :) https://cc.bruniaux.com/
5 commits 1 branch 0 tags 20 MiB
Find a file
Florian BRUNIAUX 99e2d2246c docs(readme): add disclaimer about AI-generated content 
Clarify that the guide may contain errors since it was largely
AI-generated, and encourage feedback/PRs for improvements.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 15:27:28 +01:00
.gitignore chore: add .gitignore 2026-01-09 15:22:00 +01:00
cheatsheet-en.md docs: add complete Claude Code ultimate guide content 2026-01-09 15:18:49 +01:00
claude-code-ultimate-guide_kimi.pdf docs: add complete Claude Code ultimate guide content 2026-01-09 15:18:49 +01:00
claude-code-ultimate-guide_notebooklm.pdf docs: add complete Claude Code ultimate guide content 2026-01-09 15:18:49 +01:00
english-ultimate-claude-code-guide.md fix: correct license from MIT to CC BY-SA 4.0 2026-01-09 15:25:22 +01:00
LICENSE docs: add complete Claude Code ultimate guide content 2026-01-09 15:18:49 +01:00
README.md docs(readme): add disclaimer about AI-generated content 2026-01-09 15:27:28 +01:00

README.md

The Ultimate Claude Code Guide

From zero to power user — a comprehensive, self-contained guide to mastering Claude Code.

License: CC BY-SA 4.0

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

Contact: LinkedIn

Written with: Claude (Anthropic)

About This Guide

This guide is the result of several months of daily practice and research with Claude Code. I don't claim to be an "expert" — I'm simply sharing what I've learned along the way, humbly hoping to help my peers and evangelize good practices in AI-assisted development.

A significant source of inspiration for this work was Claudelog.com, which I highly recommend for anyone wanting to go deeper.

Important note: This guide was largely generated with the help of AI. As such, it likely contains errors, inaccuracies, or outdated information. I would be delighted to receive any feedback, corrections, or — even better — pull requests to improve it. Don't hesitate to open an issue or submit a PR!

If you find value in this guide, have questions, or want to discuss Claude Code practices, feel free to reach out on LinkedIn.

What's Inside

File Description Reading Time
english-ultimate-claude-code-guide.md Complete guide (4000+ lines) ~2.5 hours
cheatsheet-en.md 1-page printable daily reference 5 minutes
claude-code-ultimate-guide_notebooklm.pdf Audio Deep Dive (NotebookLM podcast) ~1 hour
claude-code-ultimate-guide_kimi.pdf PDF version (Kimi export) ~2.5 hours

Guide Overview

1. Quick Start (Day 1)

Installation, first workflow, essential commands, permission modes.

2. Core Concepts

  • Context Management — The most critical concept (zones, recovery, poisoning)
  • Plan Mode — Safe exploration before changes
  • Rewind — Undo mistakes safely
  • Mental Model — How Claude sees your codebase

3. Configuration

  • CLAUDE.md files (global, project, local)
  • The .claude/ folder structure
  • Settings & permissions
  • Precedence rules

4. Agents

Create specialized AI personas for specific tasks:

  • Code reviewer, debugger, backend architect
  • Tool SEO for better agent discovery
  • Multi-agent orchestration patterns

5. Skills

Reusable knowledge modules:

  • Security Guardian (OWASP, secrets management)
  • TDD (Red-Green-Refactor cycle)
  • Creating your own skills

6. Commands

Custom slash commands:

  • /commit, /pr, problem framer
  • Variable interpolation with $ARGUMENTS

7. Hooks

Event-driven automation:

  • Security blockers (pre-tool use)
  • Auto-formatters (post-tool use)
  • Context enrichers (prompt submit)
  • Activity logging

8. MCP Servers

External tool integrations:

  • Serena — Semantic code navigation
  • Context7 — Library documentation
  • Sequential — Structured reasoning
  • Playwright — Browser automation
  • Postgres — Database queries

9. Advanced Patterns

  • The Trinity (Plan + Think + Agents)
  • CI/CD & IDE integration
  • Tight feedback loops
  • Todo as instruction mirrors
  • Vibe coding & skeleton projects
  • Batch operations

10. Reference

Commands table, keyboard shortcuts, troubleshooting, checklists.

Appendix

Ready-to-use templates for agents, skills, commands, hooks, settings, and prompts.

Quick Start

# Install Claude Code
curl -fsSL https://claude.ai/install.sh | sh

# Start in your project
cd your-project
claude

The 7 Commands You Need

Command Action
/help Show all commands
/status Check context usage
/compact Compress context (>70%)
/clear Fresh start
/plan Safe read-only mode
/rewind Undo changes
Ctrl+C Cancel operation

Context Management (Critical!)

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

The Golden Rules

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

Who Is This For?

  • Beginners: Start with Quick Start (15 min) → be productive immediately
  • Intermediate: Deep dive into Configuration, Agents, Skills
  • Power Users: Advanced Patterns, MCP orchestration, CI/CD integration

Contributing

Found an error? Have a suggestion? Open an issue or PR.

Resources

License

This work is licensed under CC BY-SA 4.0.

You are free to share and adapt this material, provided you give appropriate credit and distribute your contributions under the same license.

Last updated: January 2025 | Version 1.0