Configuration des Coding Agents

Configuration d’OpenHands CLI : API Key, Base URL et modèles

Installez OpenHands CLI avec uv, configurez votre BetterToken API Key et Base URL, puis testez une requête sans interface via les variables d’environnement.

Connectez OpenHands CLI à BetterToken à l’aide de variables d’environnement. Lors d’un test sur macOS avec un modèle GPT, OpenHands CLI 1.16.0 a traité des requêtes texte sans interface et des appels d’outils de lecture de fichiers via /v1/responses.

Paramètres clés

Élément	Valeur
API Key	BetterToken API Key définie dans `LLM_API_KEY`
Base URL	`https://bettertoken.ai/v1` définie dans `LLM_BASE_URL`
Modèle	`openai/YOUR_MODEL_ID` défini dans `LLM_MODEL`
Surcharge de configuration	`--override-with-envs`

Prérequis

uv et Python 3.12 ou version ultérieure
Une BetterToken API Key : inscrivez-vous pour en obtenir une
Un Model ID copié depuis le model plaza

Installation

Utilisez le nom du paquet et la commande du guide d’installation officiel :

uv tool install openhands --python 3.12
openhands --version

Configuration manuelle

Remplacez YOUR_API_KEY et YOUR_MODEL_ID. Conservez le préfixe openai/ dans LLM_MODEL :

export LLM_MODEL="openai/YOUR_MODEL_ID"
export LLM_API_KEY="YOUR_API_KEY"
export LLM_BASE_URL="https://bettertoken.ai/v1"

Ajoutez --override-with-envs au lancement d’OpenHands pour remplacer les paramètres enregistrés par ces variables. La surcharge ne s’applique qu’à cette exécution et n’enregistre pas les valeurs dans la configuration.

Vérifier la connexion

openhands --headless --json --override-with-envs -t "Reply with only: OK"

Dans la sortie JSONL, vérifiez que la réponse finale contient OK. Pour tester séparément l’accès aux fichiers, lancez OpenHands depuis votre projet et demandez-lui de lire un fichier connu ; vérifiez le résultat de l’outil et la réponse finale.

Changer de modèle

Définissez LLM_MODEL sur openai/ suivi d’un autre Model ID exact. Relancez avec --override-with-envs.

Erreurs fréquentes

Symptôme	Vérification
Les variables d’environnement ne sont pas appliquées	Ajoutez `--override-with-envs` à la commande.
Échec de l’authentification	Vérifiez `LLM_API_KEY` dans le terminal qui exécute OpenHands.
Point de terminaison incorrect	Utilisez `https://bettertoken.ai/v1` comme `LLM_BASE_URL`, sans `/responses` ni `/chat/completions`.
Modèle introuvable	Conservez le préfixe `openai/` et copiez le reste de `LLM_MODEL` exactement depuis le model plaza.

Pages associées

Détails techniques

OpenHands CLI 1.16.0 a envoyé les requêtes texte et de lecture de fichiers testées vers /v1/responses. Gardez la Base URL sur /v1 ; le client ajoute le chemin de la requête.