Claude Code est un agent de codage orienté terminal conçu par Anthropic. Il lit votre base de code, modifie des fichiers, exécute des commandes et peut se connecter à des backends compatibles avec Anthropic au lieu d’utiliser uniquement l’API par défaut d’Anthropic. Ce guide couvre la configuration de la CLI Claude Code, les commandes slash, les compétences personnalisées et comment acheminer les requêtes via Novita AI.
Si vous avez besoin de bases de données, de navigateurs ou d’autres outils externes, associez-le au guide de configuration MCP Claude.
Points clés à retenir
- Claude Code est un agent en ligne de commande, pas seulement une boîte de saisie.
/compact,/resume,/permissionset/modelsont des commandes de session, tandis que-pet--resumesont des drapeaux de la CLI.- Les commandes slash personnalisées sont désormais des compétences, donc
.claude/skills/et.claude/commands/sont tous deux importants. - Novita AI peut servir de backend compatible Anthropic via
ANTHROPIC_BASE_URL. - Claude Code convient à la fois aux workflows de type IDE et aux exécutions automatisées d’agents.
Qu’est-ce que Claude Code ?
Claude Code est l’outil de codage agentique d’Anthropic. La CLI s’exécute dans votre terminal, mais le même agent apparaît également dans l’application de bureau, l’interface navigateur et les intégrations d’éditeur.
La CLI est la surface la plus flexible. Elle suit les conventions Unix, vous pouvez donc lui envoyer des fichiers par tube, l’exécuter de manière non interactive avec -p et l’intégrer dans des scripts ou du CI. La configuration se trouve dans CLAUDE.md, .claude/settings.json et les variables d’environnement, ce qui en fait un excellent choix pour les workflows de codage reproductibles. Pour une exploration plus approfondie des règles de projet, consultez comment écrire CLAUDE.md.
Sous le capot, Claude Code envoie des requêtes à un point de terminaison d’API compatible Anthropic. Par défaut, ce point de terminaison est le service d’Anthropic, mais vous pouvez le rediriger vers l’API LLM de Novita AI avec une seule variable d’environnement. Pour le contexte tarifaire, consultez Prix de l’API Claude vs abonnements.
Configuration de Claude Code
Installation
Installez la CLI avec Node.js 18 ou version ultérieure :
npm install -g @anthropic-ai/claude-code
Premier lancement
Lancez Claude Code dans un répertoire de projet :
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 vos instructions.
Configuration du projet
Exécutez /init dans tout 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 modifier le fichier ou activer la mémoire automatique, qui enregistre les observations faites par Claude sur votre projet à travers les sessions.
Référence des commandes CLI
| 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 |
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 le binaire stable |
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 mcp |
Configurer les serveurs MCP |
claude doctor |
Afficher les diagnostics d’installation et de configuration |
Référence des drapeaux CLI
| Drapeau | Effet |
|---|---|
-p, --print |
Mode non interactif ; afficher la réponse et quitter |
-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 |
--permission-mode |
Démarrer dans un mode d’autorisation |
--add-dir |
Accorder l’accès aux fichiers d’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 pour le mode -p : text, json, stream-json |
--bg |
Démarrer en tant qu’agent d’arrière-plan, retour immédiat |
--worktree, -w |
Démarrer dans une arborescence de travail git isolée |
--bare |
Ignorer la découverte automatique des hooks, compétences, plugins et MCP pour des appels scriptés plus rapides |
--verbose |
Afficher la sortie complète tour par tour |
--mcp-config |
Charger les serveurs MCP depuis un fichier JSON |
--effort |
Définir l’effort de raisonnement |
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 fonctionnent uniquement au début d’un message.
Gestion de la session et du contexte
| Commande | Objectif |
|---|---|
/clear |
Démarrer une nouvelle conversation ; la session précédente reste disponible via /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 |
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 fichier 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 serveur MCP de maniére interactive |
/agents |
Confuginer les paramètres du sous-agent. |
/permissions |
Définir les règes d’autorisation,de demande et de refus pou les outls. |
/hooks |
Afficher les conigurations des hooks |
Workflow de développement
| Commande | Objectif |
|---|---|
/plan |
Enter le mode planification avant un changement important |
/model |
Changer le model activ |
/effort |
Ajuster le niveaud’effort de raisinsement |
/diff |
Ouvri le visialiseur de diff interactif |
/code-reiew [--fix] |
Revoire le diff courant ; --fix applique les constatations |
/security-reiew |
Passe de sécurité approfondie sur les modicationsn en attente |
/batch <instuction> |
Décomposer un grand changemnt et l’exécuter dans des arborescences de travail parallèles |
/backgound |
Détacher la session pour l’exécuter en tant qu’agent d’arrière-plan |
Utilitaires
| Commande | Objectif |
|–
| /help| Afficher les commanndes disponible s |
| /doctor| Diagnostiquer les probléms d’instllation et de coniguration |.
| /usage| Afficher le coût de la session et l’utilisation du plan |
| /exort| Exporter la conversation sous forme de texte brut |
| /config| Ovivrir les paramètres ou définir une valeur directement |
| /skills| Lister les compétences disponbles |
Commandes slash personnalisées
Les commandes slash personnalisées sont maintenant des compétences. Les fichiers existants dans .claude/commands/ fonctionnent encore, mais .claude/skills/ est le format préféré.
Comment créer une commande personnalisée
Créez un répertoire sous .claude/skills/ (au niveau du projet) ou ~/.claude/skills/ (personnel) :
mkdir -p .claude/skills/review-pr
Créez un fichier SKILL.md à l’intérieur de ce répertoire :
---
description: Revoir une PR GitHub ouverte pour les probléms de sécurité et les lacunes de couverture de tests.
---
## Instructions
Revoirez la demande de tirage avec ces priotités:
1. Idenifiez les vlnérabilités de sécuité.
2. Vérifier la couverture des tests pou les nouveaux che mins de code.
3. Signalr les déauts de grstion de errurs aux límites du systéme.
Cela crée une commande /review-pr que vous pouvez invouer directement :
/review-pr
Claude charge églement la compétence automatiquemnt lorsque vous posz une question qui correspnd à la desciption.
Emplacemnts et prioité des compétences
~/.claude/skills/ → personnel, ou s les projets
.claude/skills/ → ce projet uniqument
Les commandes personnalisées dans .claude/commands/" fonctionnnt encore. Un fichier à .claude/commands/deploy.mdet une compétence à.claude/skills/deploy/SKILL.mdcréent tous deux/deploy`.
Utiliser Novita AI comme backend LLM
Claude Code achemine le trafic API via ANTHROPIC_BASE_URL. Le définir sur le point de terminaison compatible Anthropic de Novita AI vous donne accès aux modèles Novita sans modifier le flux de travail de Claude Code.
Obtenez votre clé API Novita AI
Inscrivez-vous pour un compte Novita AI pour recevoir des crédits d’essai gratuits. Ouvrez ensuite la page de gestion des clés, cliquz sur Créer une nouvelle clé, et copiez la clé immédiatemnt.
Définir les variables d’environnement
Sur Mac et Linux :
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOK="<Votre clé API Novita>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instuct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instuct"
Sur Windows (invite de commandes) :
set ANTHROPIC_BSE_URL=https://api.novita.ai/anthopic
set ANTHROPIC_AUTH_TOK=<Votre clé API Novita>
set ANTHROPIC_MODEL=monshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=monshotai/kimi-k2-instruct
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.
Lancer Claude Code
cd votre-projet
claude
Pour les scripts et le CI, la même approche s’applique :
cat logs.txt | claude -p "trouver des modèles d'erreur" --output-format json
L’API LLM de Novita AI prend en charge le format de messages d’Anthropic, y compris l’utilisation d’outils, les sorties structurées et le streaming, donc Claude Code fonctionne sans modification.
Bac à sable d’agent pour une exécution isolée
Si vous construisez des pipelines automatisés sur Claude Code, le bac à sable d’agent de Novita AI vous offre une exécution isolée pour les exécutions d’agents, ce qui est utile pour les workflows CI et les tâches de codage en plusieurs étapes.
Claude Code comme outil IDE
Claude Code est souvent décrit comme “un IDE” car il s’intègre dans votre flux de travail existant au lieu de le remplacer. Plus précisément, il s’agit d’une couche d’agent qui fonctionne avec votre terminal, votre éditeur et le contexte de votre projet.
VS Code et Cursor
Installez l’extension Claude Code depuis le marketplace VS Code ou depuis le marketplace Cursor. Après l’installation, ouvrez la palette de commandes, tapez “Claude Code” et sélectionnez Ouvrir dans un nouvel onglet.
L’intégration VS Code ajoute une révision de diff en ligne, des mentions de fichiers, une révision de plan avant les modifications et un historique de conversation directement dans le panneau de l’éditeur. Vous pouvez également utiliser Claude Code dans le terminal intégré avec l’extension.
JetBrains
Installez le plugin Claude Code depuis le marketplace JetBrains et redémarrez votre IDE. Il fournit une visualisation interactive des diffs 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 vous permet de réviser les diffs visuellement et d’exécuter plusieurs sessions côte à côte. L’interface web sur claude.ai/code exécute des sessions dans le navigateur sans configuration locale.
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 l’API d’Anthropic. Le définir sur https://api.novita.ai/anthropic achemine le trafic vers le point de terminaison compatible Anthropic de Novita AI.
Quelle est la différence entre les drapeaux CLI et les commandes slash ?
Les drapeaux CLI sont définis lorsque vous lancez claude depuis votre shell. Les commandes slash 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. Si vous acheminez vers Novita AI via ANTHROPIC_BASE_URL, vous n’avez besoin que d’un compte Novita AI.
Comment les commandes slash personnalisées diffèrent-elles du fichier CLAUDE.md ?
CLAUDE.md est chargé au début de chaque session et reste dans le contexte. Les compétences ne sont chargées que lorsqu’elles sont invoquées. Utilisez donc CLAUDE.md pour les faits de projet toujours actifs et les compétences pour les procédures répétables.
Claude Code fonctionne-t-il en CI ?
Oui. Utilisez claude -p "requête" --output-format json pour le mode non interactif. Ajoutez --max-budget-usd pour plafonner les dépenses et --max-turns pour limiter le temps d’exécution.
Novita AI est une plateforme cloud 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 la construction et la mise à l’échelle.
Articles recommandés
- Comment utiliser les agents Claude Code : configuration, outils, autorisations et flux de travail en bac à sable
- Plugins Claude Code : comment les outils MCP étendent Claude Code avec des capacités externes
- Règles Claude Code : comment écrire CLAUDE.md et gérer le contexte de codage agentique
- Claude MCP : comment configurer les serveurs MCP dans Claude Code et Claude Desktop
- Comment utiliser DeepSeek V4 Flash dans Claude Code via Novita AI
- Comment accéder à GLM-4.6 dans Claude Code : guide de configuration complet pour les développeurs
