# OpenCode

Source: https://docs.aicentos.com/fr/clients/opencode

Language: fr

> Utiliser aicentos dans OpenCode : connexion d'un provider personnalisé via le fichier de configuration

OpenCode prend en charge les providers personnalisés et permet de connecter le service Codex Proxy via un fichier de configuration.

## Prérequis

Le site d'OpenCode propose un script d'installation officiel, ainsi que des installations via npm, bun, brew, etc.

* Si vous utilisez directement le script d'installation officiel, configurer npm au préalable est en principe inutile
* Si vous passez par npm, installez d'abord Node.js et npm
* Si vous passez par bun, installez d'abord bun

### Installation de Node.js (méthode npm)

La page officielle de téléchargement de Node.js : [https://nodejs.org/en/download](https://nodejs.org/en/download)

* macOS / Windows : téléchargez et installez la version LTS
* Linux : installez selon la méthode propre à votre distribution, indiquée sur cette page

Sous macOS avec Homebrew déjà installé, vous pouvez aussi exécuter directement :

```bash
brew install node
```

Cela installe Node.js et npm en même temps.

Vérifiez que les commandes correspondant à votre méthode d'installation sont disponibles. Pour la méthode npm, contrôlez par exemple :

```bash
node -v
npm -v
```

**Remarque :** si vous utilisez un environnement en ligne de commande sous Windows, l'éditeur recommande pour l'instant de passer par WSL.

## Installation

Utilisez de préférence la commande d'installation fournie sur le site d'OpenCode :

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

Le site d'OpenCode propose également des installations via npm, bun, brew, etc.

## Définition de la clé API

Passez par le mécanisme de connexion ou d'authentification propre à OpenCode :

```bash
opencode auth login
```

Ou exécutez /connect dans l'interface interactive pour enregistrer ce service comme provider personnalisé.

Si vous préférez les variables d'environnement, faites lire à opencode.json le nom de variable officiel standard, par exemple :

```bash
export OPENAI_API_KEY="your_api_key_here"
```

## Configuration de opencode.json

Créez un fichier opencode.json à la racine du projet ou dans le répertoire de configuration global :

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  },
  "model": "aicentos/gpt-4o"
}
```

## Test

Après le démarrage d'OpenCode, exécutez :

```
/models
```

Les modèles sous aicentos doivent apparaître.

## Remarques

* Ordre recommandé : d'abord le fichier de configuration à la main (opencode.json), puis les variables d'environnement, et seulement en dernier l'outil cc-switch ([https://github.com/farion1231/cc-switch/releases](https://github.com/farion1231/cc-switch/releases))
* Si vous utilisez /v1/responses, la documentation officielle d'OpenCode recommande @ai-sdk/openai
* Ne passez à @ai-sdk/openai-compatible que si votre connexion ne prend en charge que /v1/chat/completions
* Inutile de définir des variables propres au projet comme CODEX\_PROXY\_API\_KEY

## Liens utiles

* Site officiel : [https://opencode.ai/](https://opencode.ai/)