Alibaba Cloud Model Studio:Claude Code

Claude Code est un assistant de codage IA en ligne de commande développé par Anthropic. Connectez-le à Alibaba Cloud Model Studio via le paiement à l'utilisation, le Coding Plan, le Token Plan Personal Edition ou le Token Plan Team Edition.

Installer Claude Code

Installation

npm install -g @anthropic-ai/claude-code

Ignorer la vérification de connexion

Modifiez ou créez le fichier ~/.claude.json (chemin Windows : C:\Users\<username>\.claude.json), et définissez hasCompletedOnboarding sur true pour ignorer la vérification de connexion officielle d'Anthropic.

{
  "hasCompletedOnboarding": true
}

Configurer les identifiants d'accès

Créez le fichier ~/.claude/settings.json (chemin Windows : C:\Users\<username>\.claude\settings.json) et ajoutez la configuration correspondant à votre plan de facturation.

Token Plan Personal Edition

Remplacez YOUR_API_KEY par la clé API dédiée au Token Plan Personal Edition. Pour connaître les modèles disponibles, reportez-vous aux modèles pris en charge pour le Token Plan Personal Edition.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

Token Plan Team Edition

Remplacez YOUR_API_KEY par la clé API dédiée au Token Plan Team Edition. Pour connaître les modèles disponibles, reportez-vous aux modèles pris en charge pour le Token Plan Team Edition.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

Coding Plan

Remplacez YOUR_API_KEY par la clé API dédiée au Coding Plan. Pour connaître les modèles disponibles, reportez-vous aux modèles pris en charge pour le Coding Plan.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
    }
}

Paiement à l'utilisation

Remplacez YOUR_API_KEY par la clé API Alibaba Cloud Model Studio. Pour connaître les modèles disponibles, consultez l'API compatible Anthropic.

Définissez ANTHROPIC_BASE_URL selon la région. La clé API doit correspondre à la région sélectionnée :

• Chine du Nord 2 (Pékin) : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
• Singapour : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. Remplacez WorkspaceId par votre ID d'espace de travail.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
    }
}

Une fois la configuration enregistrée, ouvrez un nouveau terminal et exécutez claude "hello". Une réponse du modèle confirme le bon fonctionnement de la configuration. Pour une vérification plus poussée, exécutez /status dans Claude Code et assurez-vous que ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN pointent vers l'adresse de Model Studio.

Configurer la taille de la fenêtre de contexte

Par défaut, Claude Code utilise une fenêtre de contexte de 200K. Pour traiter des bases de code volumineuses ou de longues conversations, vous pouvez étendre cette fenêtre à 1M (1 000 000 tokens), si le modèle prend en charge cette longueur de contexte. Deux méthodes de configuration sont disponibles :

Ajoutez CLAUDE_CODE_MAX_CONTEXT_TOKENS au champ env dans ~/.claude/settings.json :

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}

Ajoutez le suffixe [1m] au nom du modèle. Cette méthode fonctionne avec les modèles Model Studio qui prennent en charge une fenêtre de contexte de 1M :

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}

Après modification de la configuration, ouvrez une nouvelle fenêtre de terminal pour redémarrer Claude Code afin que les changements prennent effet. Pour plus de détails sur les variables d'environnement, consultez la documentation officielle des variables d'environnement de Claude Code.

Utiliser CC Switch

CC Switch est une interface graphique de bureau open source communautaire permettant de gérer plusieurs clés API ou plans de facturation. Basculez entre les fournisseurs en un clic, sans modifier manuellement le fichier settings.json.

Installer CC Switch

• macOS : exécutez brew tap farion1231/ccswitch && brew install --cask cc-switch, ou téléchargez le fichier .dmg depuis la page Releases.
• Windows : téléchargez l'installateur .msi ou l'archive portable .zip depuis la page Releases.
• Linux : sous Arch, exécutez paru -S cc-switch-bin ; pour les autres distributions, téléchargez le paquet .deb / .rpm / .AppImage depuis la page Releases.

Ajouter un fournisseur

1. Dans l'interface principale de CC Switch, sélectionnez Claude Code dans la barre d'icônes supérieure (icône d'étoile orange), puis cliquez sur + dans le coin supérieur droit pour ouvrir Add New Provider. Remplissez les champs selon le tableau ci-dessous, puis cliquez sur Add.

   Plan de facturation	Configuration
   Token Plan Personal Edition	Nom du fournisseur : Bailian-Token Plan Personal Edition Clé API : obtenir depuis la console Endpoint : https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Token Plan Team Edition	Nom du fournisseur : Bailian-Token Plan Team Edition Clé API : obtenir depuis la console Endpoint : https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	Nom du fournisseur : Bailian-Coding Plan Clé API : obtenir depuis la console Endpoint : https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   Paiement à l'utilisation	Nom du fournisseur : Bailian-Paiement à l'utilisation Clé API : Clé API Model Studio Endpoint : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. Développez Advanced Options pour configurer le mappage des modèles. Définissez le modèle principal ainsi que les modèles par défaut Haiku, Sonnet et Opus sur les modèles pris en charge pour votre plan. Exemple de mappage :

   • Modèle principal : qwen3.7-max (non pris en charge par le Coding Plan)
   • Modèle par défaut Haiku : qwen3.6-flash (non pris en charge par le Coding Plan)
   • Modèle par défaut Sonnet : qwen3.7-max (non pris en charge par le Coding Plan)
   • Modèle par défaut Opus : qwen3.7-max (non pris en charge par le Coding Plan)

3. Retournez à l'interface principale, cliquez sur Enable en regard du fournisseur, puis démarrez une nouvelle session Claude Code pour appliquer la configuration.

Connecter Claude Code Desktop

Claude Code Desktop (Claude Desktop) et le CLI Claude Code constituent deux points d'entrée distincts, affichés dans CC Switch respectivement sous les panneaux Claude Code et Claude Desktop. L'application de bureau accède à Model Studio via la passerelle locale de CC Switch. Ce dernier écrit automatiquement l'adresse de la passerelle et le jeton d'authentification dans la configuration de l'application de bureau. Par conséquent, ne saisissez pas votre clé API Model Studio dans l'application de bureau. La clé API Model Studio se configure uniquement dans les paramètres du fournisseur CC Switch et s'injecte automatiquement lorsque le routeur local transfère la requête.

1. Installez Claude Code Desktop depuis la page de téléchargement de Claude.
2. Dans CC Switch, basculez vers le panneau Claude Desktop depuis le sélecteur d'applications situé à gauche. Si cette entrée n'apparaît pas, accédez à Settings > General et assurez-vous que Claude Desktop n'est pas masqué dans les paramètres de visibilité des applications.
3. Ajoutez le fournisseur Model Studio : si vous avez déjà configuré un fournisseur Model Studio dans le panneau Claude Code, cliquez sur Import existing providers from Claude Code pour le réutiliser ; sinon, cliquez sur + dans le coin supérieur droit pour en ajouter un. Les ID de modèle Model Studio (tels que qwen3.7-max) ne correspondant pas aux trois ID de rôle reconnus par Claude Desktop (claude-sonnet-* / claude-opus-* / claude-haiku-*), activez Needs model mapping et mappez les rôles Sonnet, Opus et Haiku aux modèles Model Studio réels à solliciter (par exemple, Sonnet > qwen3.7-max).
4. Activez le routage local : accédez à Settings > Routing > Local Routing et activez Show Routing Toggle on Main Page ; retournez ensuite au panneau Claude Desktop et activez le commutateur Claude Desktop local routing. L'adresse d'écoute par défaut est 127.0.0.1:15721.
5. Cliquez sur Enable sur la carte du fournisseur. CC Switch écrit alors automatiquement la configuration d'inférence tierce dans Claude Code Desktop.
6. Maintenez CC Switch en cours d'exécution, puis quittez complètement et redémarrez Claude Code Desktop pour appliquer les modifications. Sélectionnez le modèle configuré dans le menu des modèles pour commencer à l'utiliser.

Plugins IDE pour Claude Code

Une fois la configuration CLI ci-dessus terminée, installez le plugin Claude Code dans votre IDE. Le plugin réutilise directement la configuration présente dans settings.json.

VS Code

1. Recherchez Claude Code for VS Code sur le marketplace des extensions et installez-le.
2. Redémarrez VS Code et cliquez sur l'icône située dans le coin supérieur droit pour ouvrir Claude Code.
3. Saisissez / dans la boîte de dialogue, sélectionnez General config, puis définissez le modèle dans Selected Model.

JetBrains

1. Recherchez Claude Code sur le marketplace des extensions et installez-le.
2. Redémarrez l'IDE et cliquez sur l'icône située dans le coin supérieur droit pour commencer à l'utiliser.

FAQ

Codes d'erreur

Si vous rencontrez des erreurs lors de la configuration, consultez la documentation FAQ correspondant à votre plan de facturation :

• Paiement à l'utilisation : API compatible Anthropic - Codes d'erreur
• Coding Plan : FAQ Coding Plan
• Token Plan Personal Edition : FAQ Token Plan
• Token Plan Team Edition : FAQ Token Plan Team Edition

Après le démarrage de Claude Code, l'interface affiche « Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST »

Claude Code tente de se connecter au service officiel d'Anthropic au lieu d'Alibaba Cloud Model Studio. Cela indique généralement que les variables d'environnement sont manquantes ou n'ont pas pris effet. Suivez ces étapes :

1. Vérifiez la configuration. Exécutez la commande /status après avoir démarré Claude Code. Assurez-vous que ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN pointent vers l'adresse de Model Studio. Si la sortie est vide ou affiche une adresse autre que celle de Model Studio, vérifiez la configuration dans settings.json.
2. Vérifiez hasCompletedOnboarding. Confirmez que hasCompletedOnboarding est défini sur true dans ~/.claude.json. Sans cela, Claude Code tente de se connecter au service officiel d'Anthropic pour la vérification de connexion lors du démarrage.
3. Ouvrez un nouveau terminal. Après avoir modifié le fichier de configuration, ouvrez une nouvelle fenêtre de terminal et exécutez claude pour appliquer les changements.
4. Mettez à jour Claude Code. Si le problème persiste après toutes les étapes ci-dessus, la version de Claude Code est peut-être obsolète. Exécutez npm install -g @anthropic-ai/claude-code@latest pour mettre à jour vers la dernière version, puis réessayez.

CC Switch signale « No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port » lors de l'ajout d'un fournisseur

Ce message provient du test de connectivité effectué par CC Switch lors de l'enregistrement d'un fournisseur : il interroge un endpoint de liste de modèles (tel que /v1/models) sur l'URL de requête configurée. L'endpoint compatible Anthropic de Model Studio (se terminant par /apps/anthropic) fournit uniquement l'endpoint de messages /v1/messages et n'expose pas d'endpoint de liste de modèles. La sonde reçoit donc une erreur 404 et CC Switch signale « No available model list endpoint found ».

Ce message n'affecte pas l'utilisation normale de Claude Code et peut être ignoré. Claude Code transmet les conversations via /v1/messages, et les modèles utilisés sont spécifiés directement par le mappage de modèles dans les Advanced options de CC Switch, sans dépendre de la découverte automatique via un endpoint de liste de modèles. Lorsque l'URL de requête et la clé API sont correctement configurées, cliquez simplement sur Enable et démarrez une nouvelle session Claude Code pour discuter normalement.

Si vous ne parvenez toujours pas à discuter, vérifiez que l'URL de requête se termine bien par /apps/anthropic sans /v1 supplémentaire, et que vous avez renseigné les modèles pris en charge par votre plan dans le mappage de modèles sous Advanced options.