---
title: "Intégration de l'API Claude avec OpenCode"
description: "Tutoriel de configuration de l'adresse, de la clé et des modèles de l'API Claude de relais 1折AI dans OpenCode, incluant le choix du protocole, des exemples de configuration, des étapes de vérification et des erreurs courantes."
headingIds: {"Configuration d’OpenCode v1":"section-1","Configuration d’OpenCode v2":"section-2","Vérification de l’intégration et dépannage":"section-3","Coûts et autres méthodes d’intégration":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

</aside>
Utilisez la fonctionnalité de fournisseur personnalisé d'OpenCode pour vous connecter à 1折AI. D'abord, [créez une clé API](/fr/docs/api-keys/) et vérifiez les [modèles actuellement disponibles](/fr/docs/models/) ; les ID de modèles ci-dessous sont des exemples, veuillez les ajuster en fonction des autorisations de votre clé.

<Note>
Date de vérification de la configuration officielle : 2026-10-15. La configuration suivante est basée sur la documentation officielle ; la vérification de bout en bout sur ce site n'est pas encore terminée ; veuillez d'abord effectuer une courte vérification par questions-réponses et un appel d'outil avant de l'utiliser pour de longues tâches. Les modèles OpenAI / GPT sont en ligne, la liste des modèles et les prix sont disponibles dans la [description des modèles](/fr/docs/models/).
</Note>

## Configuration d’OpenCode v1

Selon les [Providers officiels v1](https://opencode.ai/docs/providers/) : exécutez `/connect`, sélectionnez Other, entrez l'ID du fournisseur `onezhe`, et renseignez la clé API de ce site. Fusionnez dans le projet `opencode.json` :

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onezhe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "1折AI",
      "options": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

Ensuite, `/models` sélectionnez le modèle de ce fournisseur. `/connect` ne sauvegarde que les identifiants, il ne remplace pas la configuration du fournisseur. Sélectionnez ici explicitement le SDK de Chat Completions ; ne le remplacez pas par erreur par `@ai-sdk/openai` utilisé pour Responses. L'officiel permet également de référencer des variables d'environnement via `options.apiKey: "{env:ONEZHE_API_KEY}"`.

## Configuration d’OpenCode v2

Selon les [Providers officiels v2](https://opencode.ai/v2/docs/providers), utilisez les champs natifs v2, ne les mélangez pas avec le v1 ci-dessus. Fusionnez dans le projet `opencode.jsonc` :

```json
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "onezhe": {
      "name": "1折AI",
      "env": ["ONEZHE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

Fournissez `ONEZHE_API_KEY` dans l'environnement du processus lançant OpenCode, puis `/models` sélectionnez `onezhe/claude-sonnet-4-6`. Les principales différences de v2 sont `providers`, `package`, `settings`, et non `provider`, `npm`, `options` comme en v1. Veuillez d'abord confirmer la version majeure utilisée avec `opencode --version`.

Si vous souhaitez utiliser Anthropic natif, le v1 officiel permet de remplacer `provider.anthropic.options.baseURL`, l'exemple inclut `/v1` ; le v2 liste `@opencode/ai/providers/anthropic-compatible`. Ce tutoriel suit une configuration compatible OpenAI explicite ; ne changez pas de protocole en fonction du nom du modèle et ne promettez pas que la mise en cache et les appels d'outils sont déjà vérifiés.

## Vérification de l’intégration et dépannage

1. Enregistrez et rechargez la configuration, vérifiez que le fournisseur `onezhe` ou le modèle personnalisé que vous avez ajouté est actuellement sélectionné.
2. Envoyez une question courte, vérifiez qu'une réponse est retournée ; puis essayez une petite tâche réversible, vérifiez séparément l'appel d'outil et la conversation multi-tours.
3. Ouvrez les [journaux d'appels](/fr/docs/usage-logs/), vérifiez l'heure de la requête, le modèle, le statut et l'utilisation. Une réponse textuelle réussie ne signifie pas que toutes les capacités des agents sont compatibles.
4. En cas de 404, vérifiez que l'adresse et le protocole de cet article sont assortis ; en cas de 401, vérifiez l'origine de la clé et si le processus a lu les variables d'environnement ; en cas de 429, consultez les informations de limitation de débit avant de réessayer. Pour plus de cas, voir les [codes d'erreur et le dépannage](/fr/docs/troubleshooting/).

Les clés ne sont sauvegardées que dans l'environnement local ou le stockage d'identifiants de l'outil ; ne les soumettez pas à un dépôt de code, ne les capturez pas en capture d'écran et ne les publiez pas dans des journaux. Les services d'arrière-plan peuvent ne pas hériter des variables d'environnement du terminal ; les modèles auxiliaires, la recherche et d'autres outils peuvent également avoir des paramètres de fournisseur indépendants, à vérifier séparément.

## Coûts et autres méthodes d’intégration

Consultez les [prix en temps réel de l'API Claude](https://1zheai.com/en/pricing/) et les [règles de facturation](/fr/docs/pricing-explained/). Pour d'autres clients, retournez au [catalogue d'intégration des outils](/fr/docs/integrations/) ; pour écrire votre propre programme, utilisez le [SDK et le guide de développement](/fr/docs/guides/).