Skip to main content

Claude Code

Utilisez les modèles Alibaba Cloud Model Studio dans Claude Code.

Démarrage rapide

Choisissez votre client et finalisez la configuration.
  • CLI
  • CC Switch
  • IDE plugin
  • Desktop
  1. 1

    Configure the model

    • Token Plan
    • Pay-as-you-go
    • Coding Plan
    Remplacez YOUR_API_KEY par votre clé d'API Token Plan :
    export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
    export ANTHROPIC_BASE_URL="https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic"
    export ANTHROPIC_MODEL="auto"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
    export CLAUDE_CODE_SUBAGENT_MODEL="auto"
    export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
    
    Lors de l'utilisation de qwen4-max-preview, définissez CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 si la sortie longue est tronquée.
    Pour utiliser qwen4-max, définissez ANTHROPIC_DEFAULT_OPUS_MODEL sur qwen4-max et conservez CLAUDE_CODE_MAX_CONTEXT_TOKENS à 983616. Si la sortie longue est tronquée, définissez CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072. qwen4-max dispose d'un contexte de 1 M de tokens. La sortie maximale est de 131 072 tokens en mode sans réflexion et de 262 144 tokens pour la réflexion et la réponse finale combinées. Les valeurs par défaut sont reasoning_effort=high et thinking_budget=131072.
    Ces variables d'environnement s'appliquent uniquement au terminal actuel. Pour une configuration persistante, utilisez Configurer avec un fichier de configuration.
  2. 2

    Verify

    Exécutez la commande suivante pour vérifier :
    claude -p "Hello"
    

Configurer avec un fichier de configuration

En plus des options ci-dessus, vous pouvez également vous connecter à l’aide d’un fichier de configuration.
  1. 1

    Ouvrez ou créez le fichier de configuration

    • macOS / Linux: ~/.claude/settings.json
    • Windows: C:\Users\<username>\.claude\settings.json
  2. 2

    Add the configuration

    • Token Plan
    • Pay-as-you-go
    • Coding Plan
    Remplacez YOUR_API_KEY par votre clé d'API Token Plan :
    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "auto",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen4-max-preview",
            "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
            "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
        }
    }
    
  3. 3

    Verify

    Après l'enregistrement, exécutez la commande suivante pour vérifier :
    claude -p "Hello"
    

Configurer la taille de la fenêtre de contexte

Claude Code utilise par défaut une fenêtre de contexte de 200K. Si le modèle prend en charge 1M, étendez-la à 1M (1 000 000 tokens). Méthode 1 : Définir via une variable d’environnement Ajoutez CLAUDE_CODE_MAX_CONTEXT_TOKENS dans le champ env de ~/.claude/settings.json :
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}
Méthode 2 : Utiliser un suffixe de nom de modèle Ajoutez [1m] au nom du modèle. Cela 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}.ap-southeast-1.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 modifications prennent effet.

Modes d’autorisation

Claude Code fournit les modes d’autorisation suivants :
  • default : demande une confirmation avant chaque opération.
  • acceptEdits : approuve automatiquement les modifications de fichiers. Les autres opérations demandent toujours une confirmation.
  • plan : mode de planification en lecture seule. Aucune modification n’est exécutée.
  • auto : un classificateur décide si une opération peut s’exécuter, ce qui réduit les demandes de confirmation. Dans les sessions de terminal interactif et de VS Code, Claude Code v2.1.283 et versions ultérieures utilise ce mode par défaut.
  • dontAsk : ne demande pas de confirmation. Une opération qui nécessiterait une confirmation est directement rejetée.
  • bypassPermissions : contourne toutes les vérifications d’autorisation.
  • delegate : mode délégué.
Lorsque vous utilisez le mode auto avec le point de terminaison Token Plan, il est possible que la vérification du classificateur ne renvoie aucun résultat. Certains modèles affichent Not run · auto mode's check had no usable answer et l’opération n’est pas exécutée.Si cela se produit, définissez permissions.defaultMode sur default ou acceptEdits, ou ajustez le modèle utilisé par le classificateur (ANTHROPIC_DEFAULT_SONNET_MODEL ; Claude Code v2.1.302 et versions ultérieures prend également en charge CLAUDE_CODE_AUTO_MODE_MODEL), puis redémarrez la session.
Méthode 1 : Option de ligne de commande Utilisez --permission-mode pour définir le mode d’autorisation par défaut d’une session :
claude --permission-mode plan
claude --permission-mode acceptEdits
Méthode 2 : Commande interactive Saisissez /permissions dans une session pour gérer les règles d’approbation préalable et de refus préalable des outils bash, edit et MCP. Méthode 3 : Configuration de settings.json Configurez le champ permissions dans ~/.claude/settings.json :
{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

Intégrer Bailian CLI

  1. 1

    Installer Bailian CLI

    Please install the Alibaba Cloud Bailian CLI globally: npm install -g bailian-cli
    
  2. 2

    Configurer la clé API

    Accédez à la console Bailian pour obtenir une clé API, puis indiquez à Claude Code :
    My API Key is: sk-xxxxxxxxxxxxx
    
  3. 3

    Premiers pas

    Décrivez votre tâche en langage naturel, par exemple :
    Generate 6 Amazon e-commerce hero images for a white wireless Bluetooth headset.
    Generate a 30-second product demo video for a white wireless Bluetooth headset.
    

Codes d’erreur

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

FAQ

La configuration du paiement à l'usage reste la même : utilisez la clé API générale Model Studio et l'URL de base. Après l'achat d'un plan d'économie, il prend effet automatiquement et l'utilisation éligible est déduite automatiquement. Consultez Plans d'économie.

Comment ignorer la vérification de connexion officielle d’Anthropic ?

Modifiez ou créez ~/.claude.json (chemin Windows : C:\Users\<username>\.claude.json), puis définissez hasCompletedOnboarding sur true pour ignorer la vérification de connexion officielle d’Anthropic.
{
  "hasCompletedOnboarding": true
}
Le type de clé API ne correspond pas à ANTHROPIC_BASE_URL. Model Studio propose trois méthodes d’accès, et chaque méthode d’accès utilise une URL de base différente et une clé API dédiée.

Méthode d’accès

URL de base

Clé API

Token Plan

https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Clé API Token Plan

Pay-as-you-go

https://dashscope-intl.aliyuncs.com/apps/anthropic

Clé API Model Studio (commence par sk-)

Coding Plan

https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

Clé API dédiée Coding Plan

Étapes de dépannage :
  1. Vérifiez l’URL de la requête. Vérifiez ANTHROPIC_BASE_URL dans ~/.claude/settings.json.
  2. Confirmez le type de clé API. À l’aide du tableau ci-dessus, vérifiez que le type de votre clé API correspond à l’URL de base.
  3. Corrigez la configuration. Lorsque vous utilisez une clé API Model Studio Pay-as-you-go, définissez ANTHROPIC_BASE_URL sur https://dashscope-intl.aliyuncs.com/apps/anthropic.
Claude Code se connecte au service officiel d’Anthropic au lieu d’Alibaba Cloud Model Studio. Cela signifie 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. Vérifiez 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 Model Studio, vérifiez la configuration de 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 effectuer la vérification de connexion au 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 que les modifications prennent effet.
  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 installer la dernière version, puis réessayez.
L’interface compatible héritée https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy prend uniquement en charge les modèles dépréciés. Le fait de spécifier d’autres modèles n’a aucun effet. Pour utiliser les modèles disponibles, migrez vers la nouvelle interface en suivant la configuration décrite dans ce document.
Ce message provient du test de connectivité que CC Switch exécute lors de l’enregistrement d’un fournisseur : il interroge un point de terminaison de liste de modèles (tel que /v1/models) sur l’URL de requête configurée. Le point de terminaison compatible Anthropic de Model Studio (se terminant par /apps/anthropic) fournit uniquement le point de terminaison de messages /v1/messages et ne fournit pas de point de terminaison de liste de modèles. Le test renvoie donc 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 envoie les conversations via /v1/messages, et les modèles qu’il utilise 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 à partir d’un point de terminaison de liste de modèles. Lorsque l’URL de requête et la clé API sont correctement configurées, cliquez simplement sur Enable, puis 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 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.
Si les appels de modèle dans Claude Code échouent avec une erreur AccessDenied (HTTP 403, code : access_denied) après avoir configuré le mappage de modèles, vérifiez si le modèle est marqué comme Upcoming deprecation dans la console Model Studio > Model Gallery. Les modèles marqués comme bientôt dépréciés apparaissent toujours dans la liste, mais les appels API renvoient 403 AccessDenied. Suivez ces étapes :
  1. Vérifiez si le modèle est marqué pour dépréciation. Dans la console Model Studio > Model Gallery, recherchez le modèle que vous utilisez et vérifiez son libellé de statut.
  2. Passez au dernier modèle disponible. Remplacez le modèle hérité (tel que qwen-coder-turbo-0919) dans le mappage de modèles par le dernier modèle disponible (tel que qwen3.8-max).
  3. Reconfigurez le mappage de modèles et testez. Mettez à jour le mappage de modèles dans les Advanced options de CC Switch, cliquez sur Enable, puis démarrez une nouvelle session Claude Code pour vérifier.
Prêtez attention au cycle de vie des modèles. Les modèles marqués comme bientôt dépréciés dans la console Model Studio > Model Gallery peuvent devenir indisponibles à tout moment. Vous pouvez vérifier le statut de disponibilité d’un modèle à cet endroit.