Configurer vos outils de codage

npx uberllm init

La commande trouve les outils de codage sur votre machine et configure chacun d'eux pour utiliser UberLLM. Vous avez besoin de Node.js 18 ou version ultérieure. Rien d'autre n'est installé.

Voici ce qui se passe lorsque vous l'exécutez :

1. Il liste les outils qu'il a trouvés.
2. Votre navigateur s'ouvre. Connectez-vous (ou créez un compte) et appuyez sur Connecter. Cela crée une clé API pour cette machine.
3. La clé est enregistrée dans ~/.uberllm/key, un fichier que vous seul pouvez lire.
4. Le fichier de configuration de chaque outil est modifié pour utiliser UberLLM. Une copie de chaque fichier est d'abord sauvegardée.
5. Il vérifie que la clé fonctionne et vous indique ce qu'il faut redémarrer.

L'exécuter à nouveau ne change rien si tout est déjà configuré.

Voir les changements d'abord

npx uberllm init --dry-run

Cela affiche chaque fichier qu'il modifierait et les lignes qu'il ajouterait. Il n'ouvre pas le navigateur et n'écrit rien.

Ce que chaque outil obtient

Kilo Code et Goose ne lisent une clé qu'à partir de l'environnement. Pour eux, une ligne est ajoutée à votre profil shell (~/.zshrc, ~/.bashrc ou fish). Cette ligne lit le fichier de clé ; la clé elle-même n'est pas écrite dans le profil. Sous Windows, la commande affiche cette étape à suivre à la place.

Claude Code continue de demander ses propres modèles Claude. Les autres outils obtiennent un modèle par défaut : le premier modèle de codage sur la liste des modèles qui accepte les requêtes lorsque vous exécutez la commande. Pour le choisir vous-même :

npx uberllm init --model deepseek/deepseek-v4.1-flash

Outils configurés à l'intérieur de l'application

Cursor, Cline et Roo Code conservent ces paramètres à l'intérieur de l'éditeur, et non dans un fichier qu'une commande peut modifier. Pour eux, la commande affiche les trois étapes à suivre, avec l'adresse et l'ID du modèle pré-remplis. Voir Cursor, Cline et Roo Code.

Gemini CLI ne communique qu'avec des serveurs qui utilisent l'API Gemini de Google, ce qu'UberLLM ne prend pas en charge. Pour utiliser les modèles Gemini via UberLLM, configurez OpenCode ou Codex avec un ID de modèle Gemini : npx uberllm init --tool opencode --model <id>.

Options

Quelle API key est utilisée : --key si vous la passez, puis l'API key déjà enregistrée dans ~/.uberllm, puis UBERLLM_API_KEY de l'environnement, puis le navigateur.

Un seul projet

cd my-project
npx uberllm init --project

Seul ce dossier s'exécute sur UberLLM ; vos autres projets restent inchangés. Cela fonctionne pour les outils qui ont une configuration par projet : Claude Code (.claude/settings.local.json), OpenCode (opencode.json) et Aider (.aider.conf.yml). Aucune clé n'est écrite dans le dossier du projet. Codex CLI, Kilo Code, Goose et Continue sont configurés par machine, ils sont donc ignorés ici.

Sous Windows, Claude Code n'est pas configuré par projet, car cela placerait la clé dans le dossier du projet. Exécutez la commande sans --project là.

Annuler

npx uberllm init --undo

• Un fichier que vous n'avez pas touché depuis est remis exactement tel quel. Un fichier créé par la commande est supprimé.
• Un fichier que vous avez modifié depuis conserve vos modifications. Seul ce que la commande a ajouté est retiré, et les paramètres qu'elle a remplacés sont remis en place. La copie d'avant l'exécution de la commande reste dans ~/.uberllm/backups/.
• Le fichier de clé enregistré est supprimé si cette commande l'a créé et qu'aucun outil qu'elle a configuré ne l'utilise encore. Un fichier de clé de l'installateur Claude Code est laissé en place. Pour désactiver également la clé, supprimez-la sur votre page des clés.

Annulez un outil avec --undo --tool codex, ou un projet avec --undo --project. Kilo Code et Goose partagent la ligne dans votre profil shell, elle reste donc jusqu'à ce que les deux soient annulés.

Où sont stockées les informations

La clé est envoyée à api.uberllm.dev et nulle part ailleurs. Elle n'est jamais imprimée.

Lorsqu'un fichier est laissé tel quel

La commande ne réécrit pas un fichier qu'elle pourrait endommager. Elle vous informe et affiche les étapes à suivre manuellement. Cela se produit lorsque :

• une configuration JSON contient des commentaires (opencode.jsonc, kilo.jsonc), car une réécriture les ferait disparaître ;
• une configuration JSON ne peut pas être lue ;
• le models: de Continue est écrit sur une seule ligne ;
• avec --project, un fichier de configuration est un lien vers un fichier extérieur au projet.

L'outil est alors répertorié comme "pas encore configuré" à la fin de l'exécution.

Dépannage