Aller au contenu
OpenCode
app.header.homeapp.header.docs

Introduction

Commencez avec OpenCode.

OpenCode est un agent de codage d’IA open source. Il est disponible sous forme d’interface basée sur un terminal, d’application de bureau ou d’extension IDE.

OpenCode TUI avec le thème opencode

Commençons.

Conditions préalables

Pour utiliser OpenCode dans votre terminal, vous aurez besoin de :

  1. Un émulateur de terminal moderne comme :

  2. Clés API pour les fournisseurs LLM que vous souhaitez utiliser.

Installer

Le moyen le plus simple d’installer OpenCode consiste à utiliser le script d’installation.

Fenêtre de terminal
curl -fsSL https://opencode.ai/install | bash

Vous pouvez également l’installer avec les commandes suivantes :

  • En utilisant Node.js

    Fenêtre de terminal
    npm install -g opencode-ai

  • Utilisation de Homebrew sur macOS et Linux

    Fenêtre de terminal
    brew install anomalyco/tap/opencode

    Nous vous recommandons d’utiliser le tap OpenCode pour les versions les plus récentes. La formule officielle brew install opencode est maintenue par l’équipe Homebrew et est mise à jour moins fréquemment.

  • Utilisation de Paru sur Arch Linux

    Fenêtre de terminal
    paru -S opencode-bin

Windows

  • Utiliser Chocolatey

    Fenêtre de terminal
    choco install opencode

  • Utilisation de Scoop

    Fenêtre de terminal
    scoop install opencode

  • En utilisant NPM

    Fenêtre de terminal
    npm install -g opencode-ai

  • Utiliser Mise

    Fenêtre de terminal
    mise use -g github:anomalyco/opencode

  • En utilisant Docker

    Fenêtre de terminal
    docker run -it --rm ghcr.io/anomalyco/opencode

La prise en charge de l’installation de OpenCode sur Windows à l’aide de Bun est actuellement en cours.

Vous pouvez également récupérer le binaire dans le fichier Releases.

Configurer

Avec OpenCode, vous pouvez utiliser n’importe quel fournisseur LLM en configurant ses clés API.

Si vous débutez avec les fournisseurs LLM, nous vous recommandons d’utiliser OpenCode Zen. Il s’agit d’une liste organisée de modèles qui ont été testés et vérifiés par le OpenCode équipe.

  1. Exécutez la commande /connect dans le TUI, sélectionnez opencode et dirigez-vous vers opencode.ai/auth.

    /connect

  2. Connectez-vous, ajoutez vos informations de facturation et copiez votre clé API.

  3. Collez votre clé API.

    ┌ API key
    │
    │
    └ enter

Vous pouvez également sélectionner l’un des autres fournisseurs. En savoir plus.

Initialiser

Maintenant que vous avez configuré un fournisseur, vous pouvez accéder à un projet qui vous voulez travailler.

Fenêtre de terminal
cd /path/to/project

Et exécutez OpenCode.

Fenêtre de terminal
opencode

Ensuite, initialisez OpenCode pour le projet en exécutant la commande suivante.

/init

Cela permettra à OpenCode d’analyser votre projet et de créer un fichier AGENTS.md dans la racine du projet.

Cela aide OpenCode à comprendre la structure du projet et les modèles de codage utilisé.

Usage

Vous êtes maintenant prêt à utiliser OpenCode pour travailler sur votre projet. N’hésitez pas à le demander rien!

Si vous débutez dans l’utilisation d’un agent de codage IA, voici quelques exemples qui pourraient aide.

Posez des questions

Vous pouvez demander à OpenCode de vous expliquer la base de code.

How is authentication handled in @packages/functions/src/api/index.ts

Ceci est utile s’il y a une partie de la base de code sur laquelle vous n’avez pas travaillé.

Ajouter des fonctionnalités

Vous pouvez demander à OpenCode d’ajouter de nouvelles fonctionnalités à votre projet. Cependant, nous recommandons d’abord de lui demander de créer un plan.

  1. Créer un plan

OpenCode dispose d’un Mode Plan qui désactive sa capacité à apporter des modifications et suggérez plutôt comment il implémentera la fonctionnalité.

Accédez-y à l’aide de la touche Tab. Vous verrez un indicateur à cet effet dans le coin inférieur droit.

   <TAB>

Décrivons maintenant ce que nous voulons qu’il fasse.

   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.
   From this screen, the user can undelete a note or permanently delete it.

Vous souhaitez donner à OpenCode suffisamment de détails pour comprendre ce que vous voulez. Ça aide pour lui parler comme si vous parliez à un développeur junior de votre équipe.

  1. Itérer sur le plan

Une fois qu’il vous donne un plan, vous pouvez lui faire part de vos commentaires ou ajouter plus de détails.

   We'd like to design this new screen using a design I've used before.
   [Image #1] Take a look at this image and use it as a reference.

OpenCode peut numériser toutes les images que vous lui donnez et les ajouter à l’invite. Tu peux faites-le en faisant glisser et en déposant une image dans le terminal.

  1. Créez la fonctionnalité

Une fois que vous vous sentez à l’aise avec le plan, revenez au Mode Build en appuyer à nouveau sur la touche Tab.

   <TAB>

Et lui demander d’apporter les modifications.

   Sounds good! Go ahead and make the changes.

Apporter des modifications

Pour des modifications plus simples, vous pouvez demander à OpenCode de le construire directement sans avoir à revoir le plan au préalable.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Vous voulez vous assurer de fournir une bonne quantité de détails afin que OpenCode fasse le bon choix. changements.

Annuler les modifications

Disons que vous demandez à OpenCode d’apporter quelques modifications.

Can you refactor the function in @packages/functions/src/api/index.ts?

Mais vous réalisez que ce n’est pas ce que vous vouliez. Vous pouvez annuler les modifications à l’aide de la commande /undo.

/undo

OpenCode annulera désormais les modifications que vous avez apportées et affichera votre message d’origine encore.

Can you refactor the function in @packages/functions/src/api/index.ts?

À partir de là, vous pouvez modifier l’invite et demander à OpenCode de réessayer.

Ou vous pouvez refaire les modifications à l’aide de la commande /redo.

/redo

Partager

Les conversations que vous avez avec OpenCode peuvent être partagées avec votre équipe.

/share

Cela créera un lien vers la conversation en cours et le copiera dans votre presse-papiers.

Voici un exemple de conversation avec OpenCode.

Personnaliser

Et c’est tout ! Vous êtes désormais un pro de l’utilisation de OpenCode.

Pour vous l’approprier, nous vous recommandons de choisir un thème, de personnaliser les raccourcis clavier, de configurer les formateurs de code, de créer des commandes personnalisées ou de jouer avec la OpenCode Config.