OpenCode

Dernière mise à jour : 27 août 2026

OpenCode est un agent de codage ouvert avec des interfaces de terminal, de bureau et IDE. Logicc peut être configuré comme votre propre fournisseur. Pour les modèles GPT, nous recommandons le point de terminaison Responses. Les routes Claude et Gemini via Chat Completions sont considérés comme compatibles sous condition.

Bêta : OpenCode, la compatibilité du fournisseur de modèles et de la passerelle évolue indépendamment. Testez les appels d’outils, le streaming et le raisonnement avec la route de modèle concernée avant d'utiliser l'intégration de manière productive.

Démarrage rapide

1. Installez OpenCode.
2. Définissez LOGICC_API_KEY comme variable d'environnement.
3. Créez la configuration commune avec les deux fournisseurs Logicc.
4. Démarrez OpenCode et sélectionnez un modèle sous /models.
5. Exécutez une demande de test, puis vérifiez le quota.

Exigences

• Clé API Logicc active
• Au moins un modèle activé
• Version actuelle OpenCode
• Terminal sur macOS, Linux, Windows ou WSL

1. Installer OpenCode

macOS, Linux ou WSL :

curl -fsSL https://opencode.ai/install | bash

Alternativement avec npm :

npm install -g opencode-ai

opencode --version

2. Définir la clé API

macOS, Linux ou WSL :

export LOGICC_API_KEY="VOTRE_CLE_API_LOGICC"

Windows PowerShell :

$env:LOGICC_API_KEY = "VOTRE_CLE_API_LOGICC"

La clé est référencée dans la configuration exclusivement via la variable d'environnement. Ne l'enregistrez pas directement dans opencode.json ou Git.

3. Vérifier les modèles activés

curl "https://api.logicc.cloud/v1/models" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

4. Configurer les fournisseurs Logicc

Créez un fichier opencode.json dans le dossier du projet. L'exemple suivant contient les deux chemins d'accès pris en charge dans une configuration commune. Il n'est pas nécessaire de l'écraser avec un deuxième exemple.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "logicc-responses/gpt-5.6-terra",
  "provider": {
    "logicc-responses": {
      "npm": "@ai-sdk/openai",
      "name": "Logicc API, Responses",
      "options": {
        "baseURL": "https://api.logicc.cloud/v1",
        "apiKey": "{env:LOGICC_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra via Logicc"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna via Logicc"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol via Logicc"
        }
      }
    },
    "logicc-compatible": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Logicc API, Chat Completions",
      "options": {
        "baseURL": "https://api.logicc.cloud/v1",
        "apiKey": "{env:LOGICC_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5 via Logicc"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro via Logicc"
        }
      }
    }
  }
}

@ai-sdk/openai utilise /v1/responses et est recommandé pour les modèles GPT avec des appels d'outils et un raisonnement. @ai-sdk/openai-compatible utilise /v1/chat/completions et est utilisé pour d’autres routes de modèles compatibles.

Supprimez les modèles qui ne sont pas activés pour votre clé API. D'autres identifiants activés peuvent être ajoutés en utilisant la même structure sous models.

5. Vérifiez la configuration et démarrez

macOS, Linux ou WSL :

jq empty opencode.json
opencode

Sous Windows, le fichier JSON peut être vérifié à l'aide de PowerShell, par exemple :

Get-Content .\opencode.json -Raw | ConvertFrom-Json | Out-Null
opencode

Ouvrir la sélection de modèles :

/models

Un aperçu des données d'accès enregistrées montre :

opencode auth list

Cette commande n'est pas un contrôle de connexion complet. Une connexion n'est confirmée qu'après une demande de modèle réussie.

Compatibilité des modèles

Responses, recommandé

Chat Completions, compatibles sous condition

Pour Claude, un client Anthropic natif comme le Claude Code est généralement plus compatible. Avec GPT-5.6, les Function Tools peuvent être rejetés avec reasoning_effort via les achèvements de chat. Utilisez ensuite le fournisseur Responses ou définissez l'effort de raisonnement sur none.

Ne convient pas pour coder des modèles de chat

• gpt-4o-transcribe et gpt-4o-mini-transcribe
• text-embedding-3-small, text-embedding-3-large et gemini-embedding-001
• gemini-3.1-flash-image et gemini-2.5-flash-image

Bureau et IDE

Le même opencode.json peut être utilisé par les surfaces OpenCode prises en charge. Une variable d'environnement définie dans le terminal n'est pas automatiquement disponible pour un bureau ou un processus IDE démarré séparément. Assurez-vous que LOGICC_API_KEY est transmis au processus via la gestion des secrets de l'environnement spécifique.

Nous recommandons l'interface du terminal pour la configuration initiale et l'analyse des erreurs.

Coûts et quota

OpenCode peut exécuter automatiquement de nombreuses requêtes de modèle et étapes d'outil. La consommation et les coûts dépendent fortement du modèle, de la longueur du contexte et du nombre d'étapes de travail.

curl "https://api.logicc.cloud/api/governance/virtual-keys/quota" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Le budget, la consommation et le budget restant sont tenus en euros.

Protection des données

OpenCode fonctionne localement avec les fichiers partagés et les outils de terminal. Le traitement du modèle n'a pas lieu localement. Les invites et les extraits de fichiers ou de codes pertinents sont transférés au fournisseur de modèles configuré via l'API Logicc. Les plugins, les serveurs MCP et les fonctions Web peuvent créer des flux de données supplémentaires.

Dépannage

Assistance

Si vous avez des questions, écrivez à [email protected] avec le sujet API. Partagez la version OpenCode, le système d'exploitation, le fournisseur, l'ID de modèle, l'état HTTP, l'heure et le texte d'erreur sans inclure la clé API.

Documentation complémentaire :

• Centre d’aide Logicc : https://help.logicc.com/docs
• Installation d’OpenCode : https://opencode.ai/docs
• Fournisseurs OpenCode : https://opencode.ai/docs/providers