Claude Code est un agent de codage pensé pour le terminal, développé par Anthropic. Il lit votre base de code, modifie des fichiers, exécute des commandes et peut se connecter à des backends compatibles Anthropic plutôt que d’utiliser uniquement l’API par défaut d’Anthropic. Ce guide couvre la configuration du CLI Claude Code, les commandes slash, les skills personnalisés et la façon de router les requêtes via Novita AI.
Si vous avez besoin de bases de données, de navigateurs ou d’autres outils externes, associez ce guide à celui de la configuration MCP de Claude.
Points clés
- Claude Code est un agent en ligne de commande, pas simplement une boîte de prompt.
/compact,/resume,/permissionset/modelsont des commandes de session, tandis que-pet--resumesont des flags CLI.- Les commandes slash personnalisées sont désormais des skills, donc
.claude/skills/et.claude/commands/comptent tous les deux. - Novita AI peut servir de backend compatible Anthropic via
ANTHROPIC_BASE_URL. - Claude Code convient aussi bien aux flux de travail de type IDE qu’aux exécutions automatisées d’agents.
Qu’est-ce que Claude Code ?
Claude Code est l’outil de codage agentique d’Anthropic. Le CLI s’exécute dans votre terminal, mais le même agent est également présent dans l’application de bureau, l’interface navigateur et les intégrations d’éditeur.
Le CLI est la surface la plus flexible. Il suit les conventions Unix, vous pouvez donc lui envoyer des fichiers via un pipe, l’exécuter de manière non interactive avec -p, et l’intégrer dans des scripts ou des pipelines 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 flux de codage reproductibles.
Sous le capot, Claude Code envoie des requêtes à un endpoint API compatible Anthropic. Par défaut, cet endpoint est le service d’Anthropic, mais vous pouvez le rediriger vers l’API LLM de Novita AI avec une simple variable d’environnement.
Configuration de Claude Code
Installation
Installez le CLI avec Node.js 18 ou une version ultérieure :
npm install -g @anthropic-ai/claude-code
Premier lancement
Lancez Claude Code dans un répertoire de projet :
cd your-project
claude
Au premier lancement, Claude Code vous demande de vous connecter. Après 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épart. 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 revue.
/init
Après /init, utilisez /memory pour modifier 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
| Commande | Description |
|---|---|
claude |
Démarre une session interactive dans le répertoire courant |
claude "query" |
Démarre une session avec un prompt initial |
claude -p "query" |
Exécute une requête puis quitte |
cat file | claude -p "query" |
Envoie le contenu d’un fichier dans une requête |
claude -c |
Continue la session la plus récente dans le répertoire courant |
claude -r "name" "query" |
Reprend une session par nom ou par ID |
claude update |
Met à jour vers la dernière version |
claude install stable |
Installe ou réinstalle le binaire stable |
claude auth login |
Se connecte à votre compte Anthropic |
claude auth login --console |
Se connecte avec la facturation par clé API au lieu d’un abonnement |
claude auth status |
Affiche le statut d’authentification |
claude mcp |
Configure les serveurs MCP |
claude doctor |
Affiche les diagnostics d’installation et de paramètres |
Référence des flags CLI
| Flag | Rôle |
|---|---|
-p, --print |
Mode non interactif ; affiche la réponse puis quitte |
-c, --continue |
Charge la conversation la plus récente |
-r, --resume |
Reprend une session par ID ou par nom |
--model |
Définit le modèle pour cette session |
--permission-mode |
Démarre dans un mode de permissions |
--add-dir |
Accorde l’accès à un répertoire supplémentaire |
--system-prompt |
Remplace entièrement le prompt système |
--append-system-prompt |
Ajoute au prompt système par défaut |
--max-turns |
Limite le nombre de tours agentiques en mode -p |
--max-budget-usd |
Plafonne les dépenses API en mode -p |
--output-format |
Format de sortie pour le mode -p : text, json, stream-json |
--bg |
Démarre comme un agent en arrière-plan et revient immédiatement |
--worktree, -w |
Démarre dans un git worktree isolé |
--bare |
Ignore l’auto-découverte des hooks, skills, plugins et MCP pour des appels scriptés plus rapides |
--verbose |
Affiche la sortie complète tour par tour |
--mcp-config |
Charge les serveurs MCP depuis un fichier JSON |
--effort |
Définit 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 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 | Rôle |
|---|---|
/clear |
Démarre une nouvelle conversation ; la session précédente reste accessible via /resume |
/compact |
Résume la conversation pour libérer de l’espace dans le contexte |
/context |
Visualise l’utilisation du contexte et affiche des suggestions d’optimisation |
/resume |
Rouvre une session précédente par nom ou via un sélecteur |
/branch |
Divise la conversation pour essayer une autre direction |
/rewind |
Rétablit le code et la conversation à un point de contrôle |
Configuration du projet
| Commande | Rôle |
|---|---|
/init |
Génère un CLAUDE.md de départ pour le projet |
/memory |
Modifie les fichiers CLAUDE.md et gère la mémoire automatique |
/mcp |
Gère les connexions aux serveurs MCP de manière interactive |
/agents |
Configure les paramètres des sous-agents |
/permissions |
Définit les règles autoriser, demander et refuser pour les outils |
/hooks |
Affiche les configurations de hooks |
Flux de développement
| Commande | Rôle |
|---|---|
/plan |
Entre en mode plan avant un changement important |
/model |
Change le modèle actif |
/effort |
Ajuste le niveau d’effort de raisonnement |
/diff |
Ouvre le visualiseur de diff interactif |
/code-review [--fix] |
Passe en revue le diff courant ; --fix applique les corrections |
/security-review |
Contrôle de sécurité approfondi sur les changements en attente |
/batch <instruction> |
Décompose un changement important et l’exécute dans des worktrees parallèles |
/background |
Détache la session pour l’exécuter comme agent en arrière-plan |
Utilitaires
| Commande | Rôle |
|---|---|
/help |
Affiche les commandes disponibles |
/doctor |
Diagnostique les problèmes d’installation et de paramètres |
/usage |
Affiche le coût de la session et l’utilisation du plan |
/export |
Exporte la conversation en texte brut |
/config |
Ouvre les paramètres ou définit une valeur directement |
/skills |
Liste les skills disponibles |
Commandes slash personnalisées
Les commandes slash personnalisées sont désormais des skills. Les fichiers existants dans .claude/commands/ fonctionnent toujours, mais .claude/skills/ est le format recommandé.
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 dans ce répertoire :
---
description: Review an open GitHub PR for security issues and test coverage gaps.
---
## Instructions
Review the pull request with these priorities:
1. Identify security vulnerabilities.
2. Check test coverage for new code paths.
3. Flag missing error handling at system boundaries.
Cela crée une commande /review-pr que vous pouvez invoquer directement :
/review-pr
Claude charge également le skill automatiquement lorsque vous demandez quelque chose qui correspond à la description.
Emplacements et priorité des skills
~/.claude/skills/ → personal, all projects
.claude/skills/ → this project only
Les commandes personnalisées dans .claude/commands/ fonctionnent toujours. Un fichier dans .claude/commands/deploy.md et un skill dans .claude/skills/deploy/SKILL.md créent tous deux /deploy.
Utiliser Novita AI comme backend LLM
Claude Code route le trafic API via ANTHROPIC_BASE_URL. En le définissant sur l’endpoint compatible Anthropic de Novita AI, vous accédez aux modèles Novita sans modifier le flux de travail de Claude Code.
Obtenir votre clé API Novita AI
Inscrivez-vous pour un compte Novita AI pour recevoir des crédits d’essai gratuits. Ouvrez ensuite la page 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="<Your Novita API Key>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
Sur Windows (Invité de commandes) :
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/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.
Démarrer Claude Code
cd your-project
claude
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 de messages Anthropic, y compris l’utilisation d’outils, les sorties structurées et le streaming, donc Claude Code fonctionne 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 vous offre une exécution isolée pour les exécutions d’agents, ce qui est utile pour les flux 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 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 », puis sélectionnez Open in New Tab.
L’intégration VS Code ajoute la revue de diff en ligne, les mentions de fichiers, la 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é avec l’extension.
JetBrains
Installez le plugin Claude Code depuis le JetBrains Marketplace et redémarrez votre IDE. Il fournit un affichage interactif des diffs et le partage du contexte de sélection dans IntelliJ IDEA, PyCharm, WebStorm et d’autres IDE JetBrains.
Application de bureau et web
L’application de bureau Claude Code vous permet de revoir visuellement les diffs 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 endpoint API utiliser pour envoyer les requêtes. La valeur par défaut est l’API d’Anthropic. La définir sur https://api.novita.ai/anthropic route le trafic vers l’endpoint compatible Anthropic de Novita AI.
Quelle est la différence entre les flags CLI et les commandes slash ?
Les flags CLI sont définis au lancement de 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 routez vers Novita AI via ANTHROPIC_BASE_URL, vous avez seulement besoin d’un compte Novita AI.
En quoi les commandes slash personnalisées diffèrent-elles de CLAUDE.md ?
CLAUDE.md est chargé au début de chaque session et reste dans le contexte. Les skills ne sont chargés que lorsqu’ils sont invoqués. Utilisez donc CLAUDE.md pour les faits de projet permanents et les skills pour les procédures réutilisables.
Est-ce que Claude Code fonctionne en CI ?
Oui. Utilisez claude -p "query" --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 d’IA qui offre aux développeurs un moyen simple de déployer des modèles d’IA grâce à notre API, tout en fournissant un cloud GPU abordable et fiable pour créer et passer à l’échelle.
