Claude Code est un agent de codage en ligne de commande développé par Anthropic. Il lit votre code source, modifie des fichiers, exécute des commandes et se connecte aux API LLM en arrière-plan. Ce guide couvre l’ensemble de la documentation CLI : comment le configurer, quels indicateurs et commandes slash sont disponibles, comment écrire des commandes slash personnalisées et comment router ses appels API vers Novita AI au lieu du point de terminaison Anthropic par défaut.
Qu’est-ce que Claude Code ?
Claude Code est un outil de codage agentic disponible sous forme de CLI, d’extension VS Code, de plugin JetBrains, d’application de bureau et d’interface navigateur. Toutes ces surfaces partagent le même moteur sous-jacent : Claude Code se connecte à une API LLM en arrière-plan, lit votre projet et exécute des tâches en plusieurs étapes comme l’écriture de tests, le refactoring dans plusieurs fichiers, la création de pull requests et la gestion de git.
La CLI est la surface la plus flexible. Elle suit les conventions Unix — vous pouvez lui envoyer des logs via pipe, l’exécuter en CI avec l’indicateur -p ou l’enchaîner avec d’autres outils. La configuration se trouve dans des fichiers (CLAUDE.md, .claude/settings.json, variables d’environnement), ce qui garantit un comportement prévisible dans des contextes automatisés.
Sous le capot, Claude Code envoie chaque requête à un point de terminaison API compatible Anthropic. Par défaut, ce point de terminaison est api.anthropic.com, mais vous pouvez le rediriger vers n’importe quel fournisseur compatible Anthropic — y compris Novita AI — avec une seule variable d’environnement.
Configuration de Claude Code
Installation
La méthode recommandée sur macOS, Linux et WSL est l’installateur natif :
curl -fsSL https://claude.ai/install.sh | bash
Sur Windows PowerShell :
irm https://claude.ai/install.ps1 | iex
Les installations natives se mettent à jour automatiquement en arrière-plan.
Si vous préférez npm, Node.js 18 ou supérieur est requis :
node --version # doit être 18 ou supérieur
npm install -g @anthropic-ai/claude-code
Homebrew (macOS) suit le canal de version stable :
brew install --cask claude-code
Homebrew ne se met pas à jour automatiquement. Exécutez brew upgrade claude-code lorsque vous souhaitez obtenir la dernière version.
Premier lancement
Accédez à un répertoire de projet et lancez la session interactive :
cd your-project
claude
Lors de la première utilisation, Claude Code vous invite à vous connecter. Après l’authentification, il lit votre projet et attend vos instructions.
Configuration du projet
Exécutez /init dans n’importe quel nouveau dépôt pour générer un fichier CLAUDE.md de démarrage. Claude Code lit CLAUDE.md au début de chaque session, c’est donc l’endroit idéal pour les normes de codage, les bibliothèques préférées, les notes d’architecture et les listes de vérification de revue.
/init
Après /init, utilisez /memory pour modifier le fichier ou activer la mémoire automatique, qui enregistre les observations de Claude sur votre projet entre les sessions.
Référence des commandes CLI
Les commandes shell de premier niveau de Claude Code démarrent des sessions, gèrent l’authentification et traitent les tâches en arrière-plan. Voici une liste partielle des plus utiles :
| Commande | Description |
|---|---|
claude |
Démarrer une session interactive dans le répertoire actuel |
claude "query" |
Démarrer une session avec une invite initiale |
claude -p "query" |
Exécuter une requête et quitter (mode non interactif / SDK) |
cat file | claude -p "query" |
Envoyer le contenu d’un fichier vers une requête |
claude -c |
Continuer la session la plus récente dans le répertoire actuel |
claude -r "name" "query" |
Reprendre une session par nom ou ID |
claude update |
Mettre à jour vers la dernière version |
claude install stable |
Installer ou réinstaller une version spécifique |
claude auth login |
Se connecter à votre compte Anthropic |
claude auth login --console |
Se connecter avec la facturation par clé API au lieu d’un abonnement |
claude auth status |
Afficher le statut d’authentification |
claude agents --json |
Ouvrir la vue des agents, afficher les sessions actives au format JSON |
claude mcp |
Configurer les serveurs MCP |
claude daemon status |
Vérifier l’état du superviseur de sessions en arrière-plan |
Si vous faites une erreur de frappe sur une sous-commande, Claude Code suggère la correspondance la plus proche : claude udpate affiche Did you mean claude update?.
Référence des indicateurs CLI
Les indicateurs modifient le comportement de Claude Code pour une session. Passez-les après claude lors de toute invocation. Voici une sélection des indicateurs les plus couramment nécessaires :
| Indicateur | Effet |
|---|---|
-p, --print |
Mode non interactif ; affiche la réponse et quitte |
-c, --continue |
Charger la conversation la plus récente |
-r, --resume |
Reprendre une session par ID ou nom |
--model |
Définir le modèle pour cette session (sonnet, opus, haiku ou un ID de modèle complet) |
--permission-mode |
Démarrer dans un mode de permissions : default, plan, auto, acceptEdits, bypassPermissions |
--add-dir |
Accorder l’accès à un répertoire supplémentaire |
--system-prompt |
Remplacer entièrement l’invite système |
--append-system-prompt |
Ajouter à l’invite système par défaut |
--max-turns |
Limiter les tours agentiques en mode -p |
--max-budget-usd |
Plafonner les dépenses API en mode -p |
--output-format |
Format de sortie en mode -p : text, json, stream-json |
--bg |
Démarrer en tant qu’agent en arrière-plan, revenir immédiatement |
--worktree, -w |
Démarrer dans un worktree git isolé |
--bare |
Ignorer la découverte automatique des hooks, compétences, plugins, MCP pour des appels scriptés plus rapides |
--verbose |
Afficher la sortie complète tour par tour |
--mcp-config |
Charger les serveurs MCP à partir d’un fichier JSON |
--effort |
Définir l’effort de raisonnement : low, medium, high, xhigh, max |
La combinaison --print + --output-format json est le modèle standard pour les scripts. Pour les pipelines CI avec contraintes budgétaires, combinez-la avec --max-budget-usd et --max-turns.
Documentation des commandes slash
Les commandes slash s’exécutent dans une session active. Tapez / pour voir tout ce qui est disponible, ou / suivi de lettres pour filtrer. Les commandes ne fonctionnent qu’au début d’un message.
Gestion de session et de contexte
| Commande | Objectif |
|---|---|
/clear |
Commencer une nouvelle conversation ; la session précédente reste accessible via /resume |
/compact |
Résumer la conversation pour libérer de l’espace dans le contexte |
/context |
Visualiser l’utilisation du contexte et voir les suggestions d’optimisation |
/resume |
Rouvrir une session précédente par nom ou depuis un sélecteur |
/branch |
Bifurquer la conversation pour essayer une direction différente |
/rewind |
Revenir en arrière sur le code et la conversation jusqu’à un point de contrôle |
Configuration du projet
| Commande | Objectif |
|---|---|
/init |
Générer un CLAUDE.md de démarrage pour le projet |
/memory |
Modifier les fichiers CLAUDE.md et gérer la mémoire automatique |
/mcp |
Gérer les connexions aux serveurs MCP de manière interactive |
/agents |
Configurer les paramètres des sous-agents |
/permissions |
Définir les règles d’autorisation, de demande et de refus pour les outils |
/hooks |
Voir les configurations de hooks |
Flux de développement
| Commande | Objectif |
|---|---|
/plan |
Entrer en mode planification avant un changement important |
/model |
Changer le modèle actif |
/effort |
Ajuster le niveau d’effort de raisonnement |
/diff |
Ouvrir le visualiseur de différences interactif |
/code-review [--fix] |
Examiner le diff actuel ; --fix applique les constatations |
/security-review |
Analyse de sécurité approfondie sur les modifications en attente |
/batch <instruction> |
Décomposer un changement important et l’exécuter dans des worktrees parallèles |
/background |
Détacher la session pour l’exécuter en tant qu’agent en arrière-plan |
Utilitaires
| Commande | Objectif |
|---|---|
/help |
Afficher les commandes disponibles |
/doctor |
Diagnostiquer les problèmes d’installation et de configuration |
/usage |
Afficher le coût de la session et l’utilisation du forfait |
/export |
Exporter la conversation en texte brut |
/config |
Ouvrir les paramètres ou définir une valeur directement : /config thinking=false |
/skills |
Lister les compétences disponibles |
Commandes slash personnalisées
Les commandes slash personnalisées — désormais appelées compétences — vous permettent de conditionner des procédures réutilisables que votre équipe peut partager.
Comment créer une commande personnalisée
Créez un répertoire sous .claude/skills/ (niveau projet) ou ~/.claude/skills/ (personnel, disponible dans tous les projets) :
mkdir -p .claude/skills/review-pr
Créez un fichier SKILL.md dans ce répertoire :
---
description: Examiner une PR GitHub ouverte pour les problèmes de sécurité et les lacunes de couverture de tests. Utiliser lorsque l'utilisateur demande de revoir une PR ou de vérifier la qualité d'une pull request.
---
## Instructions
Examiner la pull request en suivant ces priorités :
1. Identifier les éventuelles vulnérabilités de sécurité : risques d'injection, lacunes d'authentification, exposition de données.
2. Vérifier la couverture de tests pour les nouveaux chemins de code.
3. Signaler toute absence de gestion d'erreurs aux limites du système.
Résumer les constatations en trois sections : Sécurité, Couverture, Autres. Utiliser ✓ pour les vérifications réussies et ⚠ pour les problèmes.
Ceci crée une commande /review-pr que vous pouvez invoquer directement :
/review-pr
Claude charge également la compétence automatiquement lorsque vous posez une question qui correspond à la description.
Emplacements et priorité des compétences
Les compétences suivent un ordre de priorité : l’entreprise prévaut sur le personnel, le personnel prévaut sur le projet. Les compétences de projet se trouvent dans .claude/skills/. Les compétences personnelles (disponibles dans tous vos projets) vont dans ~/.claude/skills/.
~/.claude/skills/ → personnel, tous les projets
.claude/skills/ → ce projet uniquement
Les commandes personnalisées dans .claude/commands/ fonctionnent toujours. Un fichier .claude/commands/deploy.md et une compétence .claude/skills/deploy/SKILL.md créent tous deux /deploy et se comportent de la même manière.
Injection de contexte dynamique
Les compétences peuvent injecter des données en direct avant que Claude ne voie l’invite. Le préfixe ! exécute une commande shell et intègre sa sortie :
---
description: Résumer les modifications non validées et signaler les risques.
---
## Diff actuel
!`git diff HEAD`
## Instructions
Résumer les modifications en points. Signaler les risques : gestion d'erreurs manquante, valeurs codées en dur, chemins non testés.
Lorsque vous exécutez cette compétence, Claude Code exécute git diff HEAD et remplace cette ligne par la sortie réelle du diff. Claude voit l’état réel de l’arbre de travail plutôt que de devoir le demander via des appels d’outils.
Utiliser Novita AI comme backend LLM
Claude Code achemine tout le trafic API via la variable d’environnement ANTHROPIC_BASE_URL. En la définissant sur le point de terminaison compatible Anthropic de Novita AI, vous accédez à une large gamme de modèles — notamment les variantes DeepSeek, Kimi, Qwen et GLM — à un coût par jeton nettement inférieur à celui du point de terminaison Anthropic par défaut.
Obtenir votre clé API Novita AI
Créez un compte Novita AI pour recevoir des crédits d’essai gratuits. Accédez à la page de gestion des clés, cliquez sur Create New Key et copiez immédiatement la clé.
Définir les variables d’environnement
Sur Mac et Linux :
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Votre clé API Novita>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
Sur Windows (Invité de commandes) :
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Votre clé API Novita>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Pour rendre ces variables persistantes sur Mac/Linux, ajoutez les lignes export à ~/.bashrc ou ~/.zshrc.
ANTHROPIC_SMALL_FAST_MODEL contrôle le modèle léger que Claude Code utilise pour les tâches internes rapides comme les recherches de fichiers et les résumés rapides. En le définissant sur le même ID de modèle, vous conservez tout le trafic sur un seul compte de facturation.
Démarrer Claude Code
Une fois les variables d’environnement en place, lancez Claude Code normalement :
cd your-project
claude
Claude Code se connecte au point de terminaison de Novita AI avec le modèle que vous avez spécifié. La session interactive fonctionne de manière identique — tous les indicateurs CLI, commandes slash et compétences personnalisées se comportent de la même manière, quel que soit le backend utilisé.
Pour les scripts et la CI, la même approche s’applique :
cat logs.txt | claude -p "find any error patterns" --output-format json
L’API LLM de Novita AI prend en charge le format complet des messages Anthropic, y compris l’utilisation d’outils, les sorties structurées et le streaming, de sorte que toutes les fonctionnalités de Claude Code fonctionnent sans modification.
Agent Sandbox pour une exécution isolée
Si vous construisez des pipelines automatisés sur Claude Code, l’Agent Sandbox de Novita AI fournit des environnements d’exécution isolés, basés sur Firecracker, pour exécuter les agents par programmation. Ceci est pertinent pour les workflows CI, les agents en arrière-plan et toute configuration multi-agents où vous avez besoin d’un isolement d’exécution plutôt que d’exécuter directement sur votre machine de développement.
Claude Code en tant qu’outil IDE
Claude Code s’intègre directement dans les éditeurs, c’est ce que les gens veulent dire lorsqu’ils disent « claude code is an ide » — ce n’est pas un IDE autonome mais un agent de codage qui s’intègre dans votre environnement existant.
VS Code et Cursor
Installez l’extension Claude Code à partir du Marketplace VS Code (recherchez « Claude Code ») ou depuis le marché Cursor. Après installation, ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P), tapez « Claude Code », et sélectionnez Open in New Tab.
L’intégration VS Code ajoute une revue de diff en ligne, des mentions de fichiers avec @, une revue de plan avant les modifications et l’historique des conversations directement dans le panneau de l’éditeur. Vous pouvez également utiliser Claude Code dans le terminal intégré en parallèle de l’extension.
JetBrains
Installez le plugin Claude Code depuis le Marketplace JetBrains et redémarrez votre IDE. Le plugin nécessite que la CLI soit installée séparément. Il fournit une visualisation interactive des diffs et le partage du contexte de sélection dans IntelliJ IDEA, PyCharm, WebStorm et autres IDE JetBrains.
Application de bureau et web
L’application de bureau Claude Code (macOS et Windows) vous permet de visualiser les diffs, d’exécuter plusieurs sessions côte à côte et de planifier des tâches récurrentes. L’interface web sur claude.ai/code exécute des sessions dans le navigateur sans configuration locale, utile pour les dépôts que vous n’avez pas localement ou pour lancer des tâches de longue durée que vous pouvez surveiller à distance.
FAQ
Qu’est-ce que ANTHROPIC_BASE_URL et pourquoi est-ce important ?
ANTHROPIC_BASE_URL indique à Claude Code à quel point de terminaison API envoyer les requêtes. La valeur par défaut est api.anthropic.com. En la définissant sur https://api.novita.ai/anthropic, tout le trafic est acheminé vers le point de terminaison compatible Anthropic de Novita AI, où vous pouvez utiliser des modèles alternatifs à différents niveaux de prix. Aucune modification de code ni plugin n’est requis — juste la variable d’environnement.
Quelle est la différence entre les indicateurs CLI et les commandes slash ?
Les indicateurs CLI (comme --model, --permission-mode, --max-turns) sont définis lorsque vous lancez le binaire claude depuis votre shell. Ils configurent la session avant qu’elle ne commence. Les commandes slash (comme /model, /plan, /compact) s’exécutent dans une session active et modifient le comportement en cours de conversation.
Puis-je utiliser Claude Code sans abonnement Claude ?
Oui. claude auth login --console vous connecte avec la facturation par clé API de la console Anthropic, qui utilise un paiement par jeton plutôt qu’un abonnement. Si vous acheminez vers Novita AI via ANTHROPIC_BASE_URL, vous n’avez besoin que d’un compte Novita AI — votre compte Anthropic n’est pas facturé.
En quoi les commandes slash personnalisées diffèrent-elles de CLAUDE.md ?
Le contenu de CLAUDE.md est chargé au début de chaque session et reste dans le contexte tout au long. Les compétences (commandes personnalisées) ne sont chargées que lorsqu’elles sont invoquées, de sorte qu’un document de référence long n’ajoute aucun coût de jeton jusqu’à ce que vous en ayez réellement besoin. Utilisez CLAUDE.md pour les faits que Claude doit toujours connaître — normes de codage, commandes de construction, notes d’architecture. Utilisez les compétences pour les procédures que vous exécutez à la demande — listes de vérification pour revue de PR, étapes de déploiement, workflows de génération de tests.
Claude Code fonctionne-t-il en CI ?
Oui. Utilisez claude -p "query" --output-format json pour le mode non interactif avec sortie structurée. Ajoutez --max-budget-usd pour plafonner les dépenses et --max-turns pour limiter le temps d’exécution. L’indicateur --bare ignore la découverte automatique des hooks, compétences et plugins pour un démarrage plus rapide dans les contextes scriptés. Claude Code s’intègre également à GitHub Actions et GitLab CI/CD via des modèles de workflow officiels.
Novita AI est une plateforme cloud d’IA qui offre aux développeurs un moyen simple de déployer des modèles d’IA via une API simple, tout en fournissant des GPU cloud abordables et fiables pour construire et passer à l’échelle.
