Configura i tuoi strumenti di codifica

npx uberllm init

Il comando trova gli strumenti di codifica sulla tua macchina e configura ciascuno di essi per usare UberLLM. Hai bisogno di Node.js 18 o versioni successive. Nient'altro viene installato.

Cosa succede quando lo esegui:

1. Elenca gli strumenti che ha trovato.
2. Il tuo browser si apre. Accedi (o crea un account) e premi Connetti. Questo crea una API key per questa macchina.
3. La chiave viene salvata in ~/.uberllm/key, un file che solo tu puoi leggere.
4. Il file di configurazione di ogni strumento viene modificato per usare UberLLM. Una copia di ogni file viene salvata prima.
5. Verifica che la chiave funzioni e ti dice cosa riavviare.

Eseguirlo di nuovo non cambia nulla se tutto è già configurato.

Vedi prima le modifiche

npx uberllm init --dry-run

Questo stampa ogni file che modificherebbe e le righe che aggiungerebbe. Non apre il browser e non scrive nulla.

Cosa ottiene ogni strumento

Kilo Code e Goose leggono una chiave solo dall'ambiente. Per questi, una riga viene aggiunta al tuo profilo shell (~/.zshrc, ~/.bashrc o fish). Quella riga legge il file della chiave; la chiave stessa non viene scritta nel profilo. Su Windows, il comando stampa quel passaggio da fare invece.

Claude Code continua a chiedere i suoi modelli Claude. Gli altri strumenti ottengono un modello predefinito: il primo modello di codifica sull'elenco dei modelli che accetta richieste quando esegui il comando. Per sceglierlo tu stesso:

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

Strumenti configurati all'interno dell'app

Cursor, Cline e Roo Code mantengono queste impostazioni all'interno dell'editor, non in un file che un comando può modificare. Per questi, il comando stampa i tre passaggi da seguire, con l'indirizzo e l'ID del modello già compilati. Vedi Cursor, Cline e Roo Code.

Gemini CLI comunica solo con server che parlano l'API Gemini di Google, che UberLLM non serve. Per usare i modelli Gemini tramite UberLLM, configura OpenCode o Codex con un ID modello Gemini: npx uberllm init --tool opencode --model <id>.

Opzioni

Quale key viene usata: --key se la passi, poi la key già salvata in ~/.uberllm, poi UBERLLM_API_KEY dall'ambiente, poi il browser.

Un solo progetto

cd my-project
npx uberllm init --project

Solo quella cartella viene eseguita su UberLLM; i tuoi altri progetti rimangono invariati. Questo funziona per gli strumenti che hanno una configurazione per progetto: Claude Code (.claude/settings.local.json), OpenCode (opencode.json) e Aider (.aider.conf.yml). Nessuna chiave viene scritta nella cartella del progetto. Codex CLI, Kilo Code, Goose e Continue sono configurati per macchina, quindi vengono saltati qui.

Su Windows, Claude Code non è configurato per progetto, perché ciò metterebbe la chiave nella cartella del progetto. Esegui il comando senza --project lì.

Annulla

npx uberllm init --undo

• Un file che non hai più toccato viene ripristinato esattamente come era. Un file creato dal comando viene rimosso.
• Un file che hai modificato da allora mantiene le tue modifiche. Viene rimosso solo ciò che il comando ha aggiunto, e le impostazioni che ha sostituito vengono ripristinate. La copia precedente all'esecuzione del comando rimane in ~/.uberllm/backups/.
• Il file chiave salvato viene rimosso se questo comando lo ha creato e nessun tool che ha configurato lo utilizza ancora. Un file chiave dall'installer di Claude Code viene lasciato al suo posto. Per disattivare anche la chiave, cancellala sulla tua pagina delle chiavi.

Annulla un tool con --undo --tool codex, o un progetto con --undo --project. Kilo Code e Goose condividono la riga nel tuo profilo shell, quindi rimane finché entrambi non vengono annullati.

Dove sono conservate le cose

La chiave viene inviata a api.uberllm.dev e in nessun altro luogo. Non viene mai stampata.

Quando un file viene lasciato in pace

Il comando non riscrive un file che potrebbe danneggiare. Ti informa e stampa i passaggi da eseguire a mano. Questo accade quando:

• una configurazione JSON ha commenti (opencode.jsonc, kilo.jsonc), perché una riscrittura li farebbe perdere;
• una configurazione JSON non può essere letta;
• il models: di Continue è scritto su una sola riga;
• con --project, un file di configurazione è un link a un file esterno al progetto.

Lo strumento viene quindi elencato come "non ancora configurato" alla fine dell'esecuzione.

Risoluzione dei problemi