Intégration de l'API Claude avec OpenCode

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.

Utilisez la fonctionnalité de fournisseur personnalisé d’OpenCode pour vous connecter à 1折AI. D’abord, créez une clé API et vérifiez les modèles actuellement disponibles ; les ID de modèles ci-dessous sont des exemples, veuillez les ajuster en fonction des autorisations de votre clé.

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.

Configuration d’OpenCode v1

Selon les Providers officiels v1 : 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 :

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "onezhe": {
5
      "npm": "@ai-sdk/openai-compatible",
6
      "name": "1折AI",
7
      "options": { "baseURL": "https://1zheai.com/v1" },
8
      "models": {
9
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
10
      }
11
    }
12
  }
13
}

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, utilisez les champs natifs v2, ne les mélangez pas avec le v1 ci-dessus. Fusionnez dans le projet opencode.jsonc :

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "providers": {
4
    "onezhe": {
5
      "name": "1折AI",
6
      "env": ["ONEZHE_API_KEY"],
7
      "package": "@opencode/ai/providers/openai-compatible",
8
      "settings": { "baseURL": "https://1zheai.com/v1" },
9
      "models": {
10
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
11
      }
12
    }
13
  }
14
}

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

Enregistrez et rechargez la configuration, vérifiez que le fournisseur onezhe ou le modèle personnalisé que vous avez ajouté est actuellement sélectionné.
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.
Ouvrez les journaux d’appels, 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.
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.

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 et les règles de facturation. Pour d’autres clients, retournez au catalogue d’intégration des outils ; pour écrire votre propre programme, utilisez le SDK et le guide de développement.