Configuration d'un point de fin API personnalisé pour Claude Code avec un passerelle de modèles open-source chinois

Claude Code peut être configuré pour communiquer avec un point de fin compatible avec Anthropic au lieu d'utiliser directement un point de fin de fournisseur. Cela permet de tester un flux de travail géré par une passerelle avec des identifiants de modèle exposés par la passerelle, y compris les modèles open-source chinois disponibles dans le catalogue actuel de modèles d'ECAIX.

Ce guide concerne un processus de compatibilité spécifique au fournisseur, compatible avec des passerelles tierces. La documentation officielle de la passerelle Claude Code d'Anthropic explique que Anthropic ne supporte pas le routage de Claude Code vers des modèles non-Claude via une passerelle. ECAIX ne revendique pas que ce processus soit officiellement soutenu par Anthropic, et un modèle non-Claude peut ne pas offrir toutes les capacités de Claude Code.

Démarrage rapide

Si vous comprenez déjà les limites de compatibilité, suivez cette courte procédure :

1. Ouvrez le catalogue actuel des modèles d'ECAIX et choisissez un identifiant de modèle actif.
2. Créez une clé API d'ECAIX et conservez-la hors de contrôle source.
3. Configurez la variable d'environnement ANTHROPIC_BASE_URL avec https://ecaix.com/api/ai/v1/anthropic.
4. Exécutez la requête de diagnostic ci-dessous et enregistrez le code HTTP.
5. Testez Claude Code dans un projet de test en lecture seule avec claude -p.
6. Testez les outils, le flux en temps réel, les limites de contexte et les autorisations séparément.

Statut de validation à la publication

Cette table est intentionnelle : un exemple de configuration n'est pas le même qu'un résultat de compatibilité mesuré.

Ce que change cette configuration

La configuration comporte quatre parties distinctes :

1. Claude Code est le client qui crée des tâches de codage et envoie des requêtes.
2. La passerelle compatible avec Anthropic reçoit les requêtes via un point de fin style Anthropic.
3. L'identifiant de modèle sélectionne le modèle en amont exposé par la passerelle.
4. La clé API authentifie la requête et détermine le compte, les quotas et les autorisations.

Changer le point de fin ne transforme pas un modèle non-Claude en Claude. Il ne fait que changer quelle surface API compatible reçoit la requête. L'utilisation des outils, la gestion du contexte, les alias de modèles, le comportement du flux en temps réel et les flux d'autorisation peuvent varier selon la version du client et la mise en œuvre de la passerelle.

Avant de commencer

Vous avez besoin de :

• Une installation de Claude Code qui supporte la configuration du point de fin via des variables d'environnement ou des paramètres.
• Une clé API d'ECAIX.
• Un identifiant de modèle actuellement présent dans le catalogue des modèles d'ECAIX.
• Un terminal où vous pouvez exécuter une petite requête de test sans exposer la clé API dans le contrôle source.

Le catalogue évolue avec le temps. Avant de copier un identifiant de modèle dans un fichier de configuration, ouvrez le répertoire des modèles d'ECAIX et confirmez que le modèle est actif et disponible pour le style d'API que vous prévoyez d'utiliser.

Configurer le point de fin de la passerelle

Claude Code stocke les paramètres dans ~/.claude/settings.json sur de nombreuses installations. Le schéma exact des paramètres peut changer, donc traitez le modèle suivant comme un point de départ et comparez-le avec la documentation de votre version installée.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

Ne commitez pas ce fichier dans un dépôt public s'il contient une clé API réelle. Préférez une variable d'environnement locale, un gestionnaire de secrets ou le mécanisme de crédentiels recommandé par votre installation de Claude Code.

Vous pouvez également configurer le point de fin dans une session shell pendant le test :

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

Les noms de variables et les paramètres supportés par une version particulière de Claude Code peuvent changer. Si le client ignore ANTHROPIC_MODEL, utilisez le champ de modèle ou le mécanisme d'alias de modèle documenté par votre version. La passerelle doit toujours reconnaître l'identifiant de modèle final.

Vérifier le point de fin compatible avec Anthropic

Avant de commencer une session de codage interactive, envoyez une petite requête. Cela sépare les problèmes liés au point de fin, à l'authentification et à l'identifiant de modèle des comportements spécifiques à Claude Code.

La commande ci-dessous sauvegarde séparément les en-têtes de réponse et le corps de la réponse, puis affiche le code HTTP. Utilisez une clé autorisée uniquement dans votre shell locale ; ne copiez jamais celle-ci dans un article, un ticket ou un historique de shell partagé.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Interprétation attendue :

• 200 : vérifiez la forme de la réponse et confirmez les champs de modèle ou d'utilisation retournés.
• 401 ou 403 : vérifiez la clé, les en-têtes, le compte et l'étendue des autorisations avant de modifier la demande.
• 404 : vérifiez l'URL de base, le suffixe /messages et la mise en ligne du point de fin.
• 400 : réduisez la requête au corps le plus petit possible et vérifiez les champs spécifiques au modèle.
• 5xx ou timeout : enregistrez le temps de demande et le corps de la réponse, puis séparez ensuite le comportement de la passerelle, celui du fournisseur en amont et celui du timeout du client.

Une réponse réussie confirme que la clé, le point de fin, la structure de la requête et l'identifiant de modèle ont fonctionné ensemble pour cette requête. Cela ne prouve pas que toutes les fonctionnalités de Claude Code fonctionneront.

Choisir un identifiant de modèle

Le catalogue d'ECAIX contient des familles de modèles de fournisseurs chinois. Le bon modèle de départ dépend de la tâche, et non seulement du nom du modèle.

Développement de code et développement général

Commencez par un modèle DeepSeek, Qwen, GLM ou Seed capable de coder et actuellement visible dans le catalogue. Par exemple, un catalogue peut exposer des identifiants tels que deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 ou seed-2.0-code. La disponibilité et les capacités peuvent changer, donc vérifiez toujours la page du modèle actuel avant de publier une configuration.

Travaux de long contexte et de gestion de dépôt

Pour de grands dépôts ou de longs documents techniques, comparez la longueur de contexte affichée dans la page du modèle. Une fenêtre de contexte plus grande ne signifie pas automatiquement de meilleurs résultats pour les dépôts : la structure des prompts, le soutien aux outils, les limites de sortie et les limites de la passerelle sur les requêtes comptent également.

Appels d'outils et flux de travail d'agent

Si le flux de travail nécessite des appels de fonction ou des outils, vérifiez la documentation du modèle et de la passerelle. Certains fournisseurs exposent les appels d'outils via des APIs compatibles OpenAI, tandis que d'autres exposent des noms de champs différents ou ne supportent qu'une partie des comportements des outils. Commencez par un test d'appel d'outil simple avant de donner accès au modèle à un dépôt réel ou à un système externe.

Développement de code en chinois

Les modèles open-source chinois peuvent être utiles lorsque le codebase, la documentation, le suivi des bugs ou le flux de travail de l'équipe contient des matériaux en chinois. Évaluez le modèle avec vos propres prompts et échantillons de dépôt plutôt que de vous fier uniquement aux classements généraux.

Tester Claude Code après que la requête API fonctionne

Une fois que la requête directe réussit, commencez par une commande en lecture seule ou à faible risque :

claude -p "Explain what this repository does without editing files."

Puis testez une tâche étroitement ciblée. Par exemple :

claude -p "List the likely entry points for the web application. Do not modify files."

Utilisez des tests de plus en plus exigeants :

1. Réponse textuelle pure.
2. Explication courte de code.
3. Navigation dans le dépôt.
4. Une édition contrôlée dans une branche temporaire.
5. Utilisation d'outils ou tâche multi-étapes.
6. Comportement en flux continu et long contexte.

Ne supposez pas qu'une réponse textuelle réussie prouve que les prompts d'autorisation, les appels d'outils, le flux en temps réel, les limites de contexte ou l'édition de fichiers se comportent de la même manière qu'une session basée sur Claude.

Choisir le bon chemin API

Claude Code n'est qu'un seul flux de travail client. Le bon chemin API dépend du client et de l'ensemble des fonctionnalités que vous souhaitez utiliser :

Pour ECAIX, utilisez la documentation des Messages d'Anthropic pour le chemin style Anthropic et la documentation des Completions de Chat pour les clients compatibles avec OpenAI. Utilisez le répertoire des modèles pour confirmer le modèle actuel et la page des prix pour les prix affichés actuels.

Matrice de compatibilité

La matrice suivante est une limite de preuve à la date de publication, et non une déclaration selon laquelle toutes les fonctionnalités sont soutenues :

Cette distinction empêche une requête minimale réussie d'être présentée comme une certification complète de compatibilité de Claude Code.

Pages détaillées des modèles et identifiants actuels

Utilisez les pages détaillées des modèles plutôt que de copier un ancien nom de modèle d'un article de blog :

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

Ces