tidemeet

Installer et utiliser OpenCode : CLI, TUI, clé API, première tâche dépôt

Installer OpenCode CLI/TUI, brancher une clé, puis terminer une première tâche dans un vrai dépôt.

Il vous faut un agent open source dans le terminal qui lit un dépôt et modifie des fichiers — sans autre chat navigateur.

Ce parcours couvre comment installer et utiliser OpenCode : installer le CLI/TUI, se connecter ou coller une clé API avec /connect ou opencode auth login, puis terminer une première tâche dans un vrai dépôt. Étapes d’après Intro, Providers et CLI sur opencode.ai/docs.

Installer le CLI Connexion ou clé API Première tâche dépôt

À qui ça s’adresse

OpenCode est un agent terminal open source : opencode sans argument lance le TUI ; le CLI existe aussi. Bureau et IDE sont dans la doc ; cet article reste au terminal. Un premier run a besoin d’un émulateur moderne et d’une clé de modèle qui répond.

01

Partir d’un vrai dépôt

cd dans un projet que vous maintenez vraiment. Trois puces ou un test — pas une réécriture du dépôt.

02

Les clés vivent dans auth, pas le prompt

Stockage officiel : ~/.local/share/opencode/auth.json. TUI : /connect, CLI : opencode auth login. Ne pas les coller dans le chat.

03

Initialiser avant les gros edits

/init analyse le projet et écrit AGENTS.md ; la doc dit de le committer. Petites éditions en Build. Plus large : Tab vers Plan d’abord.

Installer, authentifier, première tâche

  1. 1

    Installer le CLI et ouvrir le TUI

    Sur macOS/Linux/WSL : curl -fsSL https://opencode.ai/install | bash, npm install -g opencode-ai, ou brew install anomalyco/tap/opencode (le tap anomalyco est la formule plus à jour documentée). Windows natif : Chocolatey, Scoop ou npm ; compatibilité complète documentée via WSL. Vérifier avec opencode --version, lancer opencode.

  2. 2

    Se connecter ou ajouter une clé API

    Dans le TUI, /connect. Les nouveaux peuvent choisir OpenCode Zen, se connecter sur opencode.ai/auth, ajouter la facturation et coller la clé — ou OpenAI, Anthropic, un autre fournisseur. CLI : opencode auth login. Vérifier : opencode auth list. Aussi l’environnement ou un .env projet.

  3. 3

    Première tâche dans le dépôt

    cd dans le projet, opencode, puis /init pour AGENTS.md. Premier prompt : « Explique la structure en trois puces et propose un petit test. » Petite édition : un commentaire d’une ligne, même comportement. Lire le diff. /undo possible. Scripts : opencode run.

1
Install CLI
2
Chemins d’auth
/init
Écrit AGENTS.md
curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai
# or: brew install anomalyco/tap/opencode

opencode --version

# Auth (pick one):
# In the TUI:  /connect   → provider or OpenCode Zen → paste API key
# CLI:         opencode auth login
# Check:       opencode auth list
# Keys live in ~/.local/share/opencode/auth.json  (do not commit)

cd /path/to/your/repo
opencode
# In the TUI:  /init     → writes AGENTS.md (ok to commit)
# First task:  Explain the repo layout in three bullets and name one small test I can add
# Small edit:  Add a one-line comment to the main entry file; do not change behavior
# Undo:        /undo

# Non-interactive alternative:
# opencode run "Explain README.md in three bullets and suggest one small test"

Ce qui bloque souvent le premier run

MéthodeFacturationMieux pour
Script / npm / brewOutil open sourcePremière install CLI locale
Zen ou clé API fournisseurFacture Zen ou tarifs PlatformLecture et édition cloud
Variables d’env / .env projetMême facturation fournisseurCI ou éviter auth.json
TUI cassé ou raccourcis morts
La doc demande un émulateur moderne : WezTerm, Alacritty, Ghostty, Kitty. Mauvais rendu du terminal système : changer d’abord.
Traiter auth.json comme un carnet de mots de passe
Chemin par défaut : ~/.local/share/opencode/auth.json. Ne pas le copier dans un dépôt public. Clé déjà dans Git : la faire tourner dans la console.
Windows incomplet
Le chemin officiel pour la compatibilité complète est WSL. Chocolatey / Scoop / npm installent un binaire natif. Lire la section Windows.

Rappel officiel : API aux tarifs fournisseur ou Zen. Apprendre /init et /undo sur un modèle bon marché, puis celui que vous voulez vraiment payer.

Quand le diff doit se discuter

Il manque souvent une image. Espace court sur tidemeet ou créer un espace. Canevas : tableau partagé. Autres guides : Aider, Codex CLI.

Questions

Faut-il utiliser OpenCode Zen ?

Non. Zen est la liste documentée pour les débutants. /connect peut choisir un autre fournisseur, ou opencode auth login. Page Providers.

Faut-il committer AGENTS.md ?

La doc dit oui, pour garder structure et habitudes. Pas de clés dans ce fichier.

Activer le mode Plan tout de suite ?

Petites éditions en Build. Fonction plus large : Tab vers Plan (n’écrit pas les fichiers), puis retour à Build.

Quel rapport avec un outil de réunion temporaire ?

Aucun lien produit. Pour parler d’un diff : outils de réunion temporaires.

Créer un espace gratuit