> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Utiliser APIMart dans Claude Code > Guide détaillé sur la configuration et l'utilisation des services API APIMart dans la CLI Claude Code, vous permettant d'accéder à plusieurs modèles d'IA pour une programmation assistée avec une configuration simple. Claude Code Main Interface ## Prérequis Claude Code est un assistant de programmation IA en ligne de commande d'Anthropic qui prend en charge la conversation directe avec l'IA, la génération de code et le débogage dans le terminal. En vous connectant à APIMart, vous pouvez utiliser plusieurs modèles, y compris GPT, Claude et Gemini, dans Claude Code. Avant de commencer, assurez-vous d'avoir : 1. **Obtenu une clé API APIMart** Connectez-vous à la [console APIMart](https://apimart.ai/keys) pour obtenir votre clé API (commence par `sk-`) **Astuce :** si vous n'avez pas encore de compte APIMart, inscrivez-vous d'abord sur [APIMart](https://apimart.ai) et obtenez votre clé API. ## Étape 1 : Installer Claude Code Choisissez l'une des méthodes suivantes pour installer : Installer avec le script officiel : ```bash theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` Ou installer via Homebrew : ```bash theme={null} brew install --cask claude-code ``` Si vous rencontrez des problèmes de permissions, ajoutez `sudo` avant la commande. **PowerShell :** ```powershell theme={null} irm https://claude.ai/install.ps1 | iex ``` **CMD :** ```cmd theme={null} curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd ``` Si vous avez Node.js 18 ou plus récent installé, vous pouvez installer via npm : ```bash theme={null} npm install -g @anthropic-ai/claude-code ``` Fonctionne sur tous les systèmes d'exploitation. ### Vérifier l'installation Après l'installation, exécutez la commande suivante pour confirmer : ```bash theme={null} claude --version ``` Si un numéro de version est affiché (par ex. `1.x.x`), l'installation a réussi. ## Étape 2 : Configurer l'API APIMart Trois méthodes de configuration sont disponibles. Choisissez celle qui convient à votre flux de travail. ### Méthode 1 : Modifier settings.json (recommandée) L'approche la plus stable — configurez une fois et cela persiste. **1. Localiser le répertoire de configuration :** * Windows : appuyez sur `Win + R`, saisissez `%userprofile%\.claude` * macOS : appuyez sur `Command + Shift + G`, saisissez `~/.claude` * Linux : naviguez vers `~/.claude` Si le répertoire n'existe pas, exécutez une fois `claude` dans le terminal et appuyez sur `Ctrl + C` pour quitter — le répertoire sera créé automatiquement. **2. Créez ou modifiez le fichier `settings.json` :** ```json theme={null} { "env": { "ANTHROPIC_BASE_URL": "https://api.apimart.ai", "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx", "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } } ``` | Paramètre | Description | | ------------------------------------------ | ----------------------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Adresse API APIMart, fixée à `https://api.apimart.ai` | | `ANTHROPIC_AUTH_TOKEN` | Votre clé API APIMart (commence par `sk-`) | | `ANTHROPIC_MODEL` | Modèle par défaut à utiliser, choisissez dans la liste des modèles ci-dessous | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Définissez à `1` pour réduire les requêtes réseau non essentielles | Sauvegardez le fichier et redémarrez Claude Code pour appliquer. ### Méthode 2 : Variables d'environnement permanentes Écrivez la configuration dans l'environnement système afin que toutes les fenêtres de terminal la chargent automatiquement. ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc source ~/.zshrc ``` ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.bashrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.bashrc source ~/.bashrc ``` **Option A : Paramètres GUI** 1. Clic droit sur « Ce PC » → « Propriétés » → « Paramètres système avancés » → « Variables d'environnement » 2. Ajoutez de nouvelles variables utilisateur : * `ANTHROPIC_BASE_URL` = `https://api.apimart.ai` * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx` * `ANTHROPIC_MODEL` = `claude-sonnet-4-6-apimart` 3. Redémarrez le terminal **Option B : Commandes PowerShell** ```powershell theme={null} [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.apimart.ai', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-6-apimart', 'User') ``` ### Méthode 3 : Variables d'environnement temporaires Convient aux tests rapides — la configuration est perdue à la fermeture du terminal. ```bash theme={null} export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" export ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```powershell theme={null} $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" $env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" $env:ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```cmd theme={null} set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx set ANTHROPIC_MODEL=claude-sonnet-4-6-apimart set ANTHROPIC_BASE_URL=https://api.apimart.ai claude ``` Les variables d'environnement temporaires ne fonctionnent que dans la fenêtre de terminal actuelle. Vous devrez les redéfinir après avoir changé de fenêtre ou fermé le terminal. ## Étape 3 : Commencer à utiliser ### Vérifier la configuration Lancez Claude Code et envoyez un simple message pour confirmer : ```bash theme={null} claude "Hello" ``` Si vous recevez une réponse de l'IA, la configuration est réussie. Si vous voyez des erreurs `401`, `403` ou autres, consultez la FAQ ci-dessous. ### Modes d'utilisation Claude Code offre deux modes d'interaction : * **Mode interactif** : exécutez `claude` pour une conversation continue, idéal pour les tâches complexes * **Commande unique** : exécutez `claude "votre question"` pour une réponse unique, idéal pour les requêtes rapides ### Modèles pris en charge APIMart prend en charge la série complète de modèles Claude. Vous pouvez basculer avec souplesse selon vos besoins : | Nom du modèle | Caractéristiques | Utilisation recommandée | | ---------------------------- | ---------------------------------- | ---------------------------------------------- | | `claude-opus-4-6` | Capacité globale la plus forte | Architecture complexe, débogage difficile | | `claude-sonnet-4-6` | Performance et vitesse équilibrées | Programmation quotidienne, génération de code | | `claude-opus-4-5-20251101` | Raisonnement avancé | Code complexe, analyse profonde | | `claude-sonnet-4-5-20250929` | Excellente capacité de code | Conception d'algorithmes, optimisation de code | | `claude-haiku-4-5-20251001` | Réponse ultra-rapide | Q\&R rapides, extraits de code | Tous les modèles ci-dessus prennent en charge une version Thinking (raisonnement étendu) — ajoutez `-thinking` à l'ID du modèle, par ex. `claude-opus-4-6-thinking`. Le mode Thinking est idéal pour les tâches complexes nécessitant un raisonnement profond. #### Modèles à prix réduit APIMart APIMart propose des modèles à prix réduit exclusifs à **seulement 20 % du prix officiel**, avec les mêmes capacités. Ajoutez simplement `-apimart` à l'ID du modèle : | Nom du modèle à prix réduit | Caractéristiques | | ------------------------------------ | ---------------------------------- | | `claude-opus-4-6-apimart` | Capacité globale la plus forte | | `claude-sonnet-4-6-apimart` | Performance et vitesse équilibrées | | `claude-opus-4-5-20251101-apimart` | Raisonnement avancé | | `claude-sonnet-4-5-20250929-apimart` | Excellente capacité de code | | `claude-haiku-4-5-20251001-apimart` | Réponse ultra-rapide | Les versions Thinking sont également disponibles, par ex. `claude-opus-4-6-thinking-apimart`, `claude-sonnet-4-6-thinking-apimart`, etc. **Recommandations de modèles :** * 💰 **Meilleur rapport qualité/prix :** `claude-sonnet-4-6-apimart` — meilleur choix pour la programmation quotidienne, seulement 20 % du prix officiel * 🚀 **Haute performance :** `claude-opus-4-6-apimart` — pour les défis de code et d'architecture les plus complexes * ⚡ **Réponse rapide :** `claude-haiku-4-5-20251001-apimart` — quand vous avez besoin d'un retour instantané * 🧠 **Réflexion profonde :** `claude-opus-4-6-thinking-apimart` — quand un raisonnement profond est nécessaire Pour changer de modèle, utilisez la commande `/model` en mode interactif, ou modifiez le champ `ANTHROPIC_MODEL` dans votre configuration et redémarrez. ### Commandes courantes Voici les commandes et raccourcis fréquemment utilisés dans Claude Code : | Commande | Description | | ------------------- | ------------------------------------ | | `claude` | Entrer en mode interactif | | `claude "question"` | Requête unique | | `claude --version` | Vérifier la version | | `/model` | Changer de modèle en mode interactif | | `/help` | Voir les informations d'aide | | `Ctrl + C` | Quitter le mode interactif | ## FAQ ### Q1 : Toujours la page de sélection de connexion après la configuration ? Si « Select login method » apparaît toujours après le démarrage, la configuration n'a pas pris effet. **Étapes de dépannage :** 1. **Utilisation de settings.json** : vérifiez si le chemin du fichier est correct * Windows : `C:\Users\\.claude\settings.json` * macOS / Linux : `~/.claude/settings.json` 2. **Utilisation de variables d'environnement** : assurez-vous d'avoir lancé Claude Code depuis la **même fenêtre de terminal** où vous avez défini les variables 3. **Vérifier le format JSON** : assurez-vous que les crochets, virgules et guillemets sont tous corrects ### Q2 : Erreurs 401 / 403 ? | Code d'erreur | Signification | Solution | | ------------------ | ---------------------------------------- | ---------------------------------------------------------------------------------- | | `401 Unauthorized` | Clé API manquante ou invalide | Vérifiez si la clé est correcte et commence par `sk-` | | `403 Forbidden` | Permissions insuffisantes ou clé expirée | Allez dans la [console](https://apimart.ai/keys) pour vérifier le statut de la clé | Assurez-vous également que `ANTHROPIC_BASE_URL` est défini sur `https://api.apimart.ai`, pas l'adresse officielle d'Anthropic. ### Q3 : Erreur « Unable to connect » ? Cela signifie que Claude Code n'a pas pu se connecter au service API. 1. Vérifiez votre connexion réseau 2. Vérifiez que `ANTHROPIC_BASE_URL` est correctement configuré 3. Si vous utilisez un proxy, assurez-vous qu'il autorise l'accès à `api.apimart.ai` ### Q4 : Erreur « Auth conflict » ? Si vous voyez un message comme : ``` Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set. ``` Cela signifie que vous êtes connecté à claude.ai et avez une clé API définie en même temps, ce qui cause un conflit. **Solution :** exécutez `/logout` en mode interactif de Claude Code pour vous déconnecter de claude.ai, en ne conservant que la configuration de la clé API. ### Q5 : Erreur max\_tokens lors de l'utilisation de modèles non-Claude ? Si vous voyez une erreur comme : ``` max_tokens is too large: 32000. This model supports at most 16384 completion tokens. ``` C'est parce que Claude Code envoie par défaut des requêtes avec les paramètres du modèle Claude (32000 tokens), alors que certains modèles non-Claude (par ex. `gpt-4o`) ont des limites de tokens plus basses. **Solution :** passez à un modèle Claude (par ex. `claude-sonnet-4-6-apimart`), qui est nativement compatible avec Claude Code et ne provoquera pas ce problème. ### Q6 : Réponse lente ? 1. Passez à un modèle plus rapide (par ex. `claude-haiku-4-5-20251001-apimart` ou `claude-sonnet-4-6-apimart`) 2. Raccourcissez vos prompts pour réduire la longueur du contexte 3. Vérifiez l'état de votre réseau ### Q7 : Comment changer de modèle ? Deux façons : 1. **En mode interactif** : saisissez la commande `/model` 2. **Modifier la configuration** : changez le champ `ANTHROPIC_MODEL` dans `settings.json` ou les variables d'environnement, puis redémarrez Claude Code ### Q8 : Claude Code lit-il automatiquement les fichiers locaux ? Non. Claude Code exige que vous référenciez explicitement les fichiers, et demandera confirmation avant d'effectuer des opérations sensibles. Il est recommandé de l'utiliser dans des répertoires de projet dédiés. ### Q9 : Comment analyser des fichiers locaux avec Claude Code ? En mode interactif, vous pouvez référencer les fichiers en : * Saisissant directement le chemin du fichier * Faisant glisser les fichiers dans la fenêtre du terminal * Copiant-collant le contenu du fichier ### Q10 : Comment vérifier l'utilisation et les coûts ? Connectez-vous à la [console APIMart](https://apimart.ai/overview) pour voir : * Statistiques d'appels API * Détails de consommation des tokens * Statistiques et tendances des coûts ## Support Si vous rencontrez des problèmes : * 📚 [Documentation APIMart](https://docs.apimart.ai) * 💬 [Communauté Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Support technique : [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** Inscrivez-vous à APIMart maintenant, obtenez votre clé API et expérimentez l'assistant de programmation multi-modèle dans Claude Code !