Ce hub séquence les concepts qu’un analytics engineer rencontre lors de la première heure avec Claude Code : installation, authentification, exploration du projet et première sortie utile. Claude Code lit dbt_project.yml, parcourt les répertoires de modèles et déduit les conventions à partir du SQL existant plutôt qu’en faisant correspondre des noms de fichiers.
Le parcours d’installation
1. Installation et bases du CLI
Bases du CLI Claude Code couvre l’installation, le lancement de Claude Code et les commandes slash essentielles (/help, /clear, /compact, /model). Commencez ici si vous n’avez jamais exécuté claude auparavant. Le modèle de permission — où Claude demande avant de lire, écrire ou exécuter — est le fondement de la relation de confiance.
2. Authentification
Options d’authentification Claude Code explique les deux chemins : OAuth avec un abonnement Claude Pro/Max (plus simple, commencez par là) et les clés API (pour l’automatisation et le CI/CD ultérieurement). Le détail clé que la plupart des gens manquent : si ANTHROPIC_API_KEY est défini dans votre environnement, il remplace silencieusement votre abonnement.
3. Sélection du modèle
Sélection du modèle Claude Code pour le travail analytique couvre quand utiliser Sonnet vs Opus. Par défaut Sonnet pour le travail quotidien — modèles de base, tests, documentation, débogage simple. Montez à Opus pour le débogage de modèles incrémentaux complexes, la refactorisation de macros imbriquées et les décisions architecturales multi-fichiers.
4. Commandes shell dans Claude Code
Préfixe bang Claude Code pour les commandes shell introduit le préfixe ! pour exécuter des commandes directement sans consommer de tokens. Essentiel pour l’authentification GCP (!gcloud auth login), les vérifications rapides (!dbt ls -s tag:daily) et les opérations git (!git checkout -b feature/new-model).
5. Ligne de statut
Configuration de la ligne de statut Claude Code montre comment afficher votre branche git, le modèle actif et l’utilisation du contexte en un coup d’œil. Une configuration d’une minute qui évite la confusion ambiante sur la branche, le modèle et la quantité de contexte consommée.
Votre première sortie utile
6. Génération de modèles de base
Génération de modèles de base avec Claude Code est la première tâche naturelle. Pointez Claude vers une table source et demandez-lui de créer un modèle de base en suivant vos patterns existants. La sortie respecte vos conventions parce que Claude lit votre code et réplique la structure — pas parce que vous avez décrit le pattern dans l’invite.
Create a base model for [your_source].[your_table] following the patterns in my existing base modelsExaminez le diff. Vérifiez les conventions de nommage. Confirmez que les patterns correspondent. Si quelque chose cloche, dites-le à Claude et il s’ajuste.
Ce qu’il faut ignorer (pour l’instant)
7. CLAUDE.md
CLAUDE.md comme mémoire de projet est la configuration à plus fort impact pour Claude Code — mais vous n’en avez pas besoin lors de votre première heure. Claude lit déjà vos fichiers de projet et découvre les patterns par lui-même. Créez un CLAUDE.md après quelques sessions, lorsque vous remarquez que Claude fait la même erreur deux fois. Construisez-le à partir de vraies frictions, pas à partir de suppositions.
Ce qui vient ensuite
Après la première heure :
- Écrire des tests — Claude identifie les clés primaires et génère des tests d’unicité, de non-nullité et de valeurs acceptées.
- Déboguer une erreur — collez un message d’erreur et Claude trace à travers le modèle et ses dépendances.
- Documenter un modèle — Claude lit le SQL et écrit des descriptions de colonnes qui expliquent la signification des champs.
Le hub Claude Code pour le développement dbt couvre l’ensemble des workflows : TDD, documentation, refactorisation, commandes slash et hooks.
La note ROI de Claude Code pour les analytics engineers donne le calendrier réaliste : plusieurs semaines d’utilisation régulière avant que l’outil économise du temps de manière cohérente.