Claude Code est un agent de codage en ligne de commande d’Anthropic qui lit votre codebase, édite des fichiers, exécute des commandes et se connecte aux API LLM en arrière-plan. Ce guide couvre la configuration, les indicateurs, les commandes slash, les commandes personnalisées et le routage des appels API vers Novita AI. Pour connecter des bases de données, des navigateurs ou des exécuteurs de code, utilisez le guide de configuration de Claude MCP séparé pour la configuration CLI et JSON.
Qu’est-ce que Claude Code ?
Claude Code est un outil de codage agentique disponible sous forme de CLI, d’extension VS Code, de plugin JetBrains, d’application de bureau et d’interface navigateur. Toutes les surfaces partagent le même moteur sous-jacent : Claude Code se connecte à un backend d’API LLM, lit votre projet et exécute des tâches en plusieurs étapes comme l’écriture de tests, le refactoring entre 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, l’exécuter en CI avec l’indicateur -p, ou la chaîner avec d’autres outils. La configuration se trouve dans des fichiers (CLAUDE.md, .claude/settings.json, variables d’environnement), ce qui la rend prévisible dans des contextes automatisés.
Sous le capot, Claude Code envoie chaque requête à un point de terminaison d’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 publication stable :
brew install --cask claude-code
Homebrew ne se met pas à jour automatiquement. Exécutez brew upgrade claude-code lorsque vous souhaitez la dernière version.
Premier lancement
Naviguez vers un répertoire de projet et lancez la session interactive :
cd votre-projet
claude
Lors de la première utilisation, Claude Code vous invite à vous connecter. Après l’authentification, il lit votre projet et attend des 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 révision.
/init
Après /init, utilisez /memory pour éditer le fichier ou activer la mémoire automatique, qui enregistre les observations que Claude fait 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 le travail en arrière-plan. Une liste partielle des plus utiles :
| Commande | Description |
|---|---|
claude |
Démarrer une session interactive dans le répertoire courant |
claude "requête" |
Démarrer une session avec une invite initiale |
claude -p "requête" |
Exécuter une requête et quitter (mode non interactif / SDK) |
cat fichier | claude -p "requête" |
Envoyer le contenu d’un fichier dans une requête |
claude -c |
Continuer la session la plus récente dans le répertoire courant |
claude -r "nom" "requête" |
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 session en arrière-plan |
Si vous faites une faute de frappe dans 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. 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 permission : default, plan, auto, acceptEdits, bypassPermissions |
--add-dir |
Accorder l’accès à un répertoire supplémentaire |
--system-prompt |
Remplacer complètement 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 pour le mode -p : text, json, stream-json |
--bg |
Démarrer comme 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 tour par tour complète |
--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 à l’intérieur d’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 |
Démarrer une nouvelle conversation ; la session précédente reste dans /resume |
/compact |
Résumer la conversation pour libérer de l’espace dans la fenêtre de contexte |
/context |
Visualiser l’utilisation du contexte et voir les suggestions d’optimisation |
/resume |
Rouvrir une session précédente par nom ou à partir d’un sélecteur |
/branch |
Forker 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 |
Éditer 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 interactif |
/code-review [--fix] |
Réviser le diff actuel ; --fix applique les constatations |
/security-review |
Passage de sécurité approfondi sur les changements en attente |
/batch <instruction> |
Décomposer un changement important et l’exécuter en worktrees parallèles |
/background |
Détacher la session pour qu’elle s’exécute comme agent en arrière-plan |
Utilitaires
| Commande | Objectif |
|---|---|
/help |
Afficher les commandes disponibles |
/doctor |
Diagnostiquer les problèmes d’installation et de paramètres |
/usage |
Afficher le coût de la session et l’utilisation du plan |
/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épétables que votre équipe peut partager.
Comment créer une commande personnalisée
Créez un répertoire sous .claude/skills/ (au niveau du 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 test. Utilisez lorsque l'utilisateur demande de réviser une PR ou de vérifier la qualité d'une pull request.
---
## Instructions
Examinez la pull request avec ces priorités :
1. Identifier les vulnérabilités de sécurité : risques d'injection, lacunes d'authentification, exposition de données.
2. Vérifier la couverture de test pour les nouveaux chemins de code.
3. Signaler les erreurs de gestion manquantes aux limites du système.
Résumez les résultats en trois sections : Sécurité, Couverture, Autre. Utilisez ✓ 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 demandez quelque chose qui correspond à la description.
Emplacements et priorité des compétences
Les compétences suivent un ordre de priorité : l’entreprise remplace le personnel, le personnel remplace 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ésumez les modifications en points. Signalez les risques : erreurs de gestion manquantes, 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.
Utilisation de Novita AI comme backend LLM
Claude Code achemine tout le trafic API via la variable d’environnement ANTHROPIC_BASE_URL. La définir sur le point de terminaison compatible Anthropic de Novita AI vous donne accès à une large gamme de modèles — notamment DeepSeek, Kimi, Qwen et les variantes GLM — à un coût par token nettement inférieur à celui du point de terminaison Anthropic par défaut.
Obtenez votre clé API Novita AI
Inscrivez-vous pour un compte Novita AI pour recevoir des crédits d’essai gratuits. Accédez à la page Gestion des clés, cliquez sur Créer une nouvelle clé et copiez la clé immédiatement.
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 les rendre 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. Le définir sur le même ID de modèle maintient tout le trafic sur un seul compte de facturation.
Démarrer Claude Code
Avec les variables d’environnement en place, lancez Claude Code normalement :
cd votre-projet
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 CI, la même approche s’applique :
cat logs.txt | claude -p "trouver les modèles d'erreur" --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 des 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’isolation d’exécution plutôt que de fonctionner directement sur votre machine de développement.
Claude Code comme outil IDE
Claude Code s’intègre directement aux éditeurs, ce qui explique pourquoi les gens disent que “claude code est un 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 depuis le Marketplace VS Code (recherchez “Claude Code”) ou depuis le marketplace Cursor. Après l’installation, ouvrez la Palette de commandes (Cmd+Maj+P / Ctrl+Maj+P), tapez “Claude Code”, et sélectionnez Ouvrir dans un nouvel onglet.
L’intégration VS Code ajoute la révision de diff en ligne, les mentions @-fichier, la révision 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é à côté 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 de diff interactive et un partage de 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 à 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 utiliser pour envoyer les requêtes. La valeur par défaut est api.anthropic.com. La définir sur https://api.novita.ai/anthropic achemine tout le trafic 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 ou plugin n’est nécessaire — seulement 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 son démarrage. Les commandes slash (comme /model, /plan, /compact) s’exécutent à l’intérieur d’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 une tarification au paiement par token plutôt qu’un abonnement. Si vous routez 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 se charge au début de chaque session et reste dans le contexte tout au long. Les compétences (commandes personnalisées) ne se chargent que lorsqu’elles sont invoquées, donc le matériel de référence long n’ajoute aucun coût de token jusqu’à ce que vous en ayez réellement besoin. Utilisez CLAUDE.md pour les faits du projet 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 de révision de PR, étapes de déploiement, workflows de génération de tests.
Claude Code fonctionne-t-il en CI ?
Oui. Utilisez claude -p "requête" --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 avec 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 notre API simple, tout en fournissant également un cloud GPU abordable et fiable pour construire et passer à l’échelle.
