Configura tus herramientas de codificación
npx uberllm init
El comando encuentra las herramientas de codificación en tu máquina y configura cada una para usar UberLLM. Necesitas Node.js 18 o posterior. No se instala nada más.
Qué sucede cuando lo ejecutas:
- Enumera las herramientas que encontró.
- Se abre tu navegador. Inicia sesión (o crea una cuenta) y pulsa Conectar. Esto crea una API key para esta máquina.
- La clave se guarda en
~/.uberllm/key, un archivo que solo tú puedes leer. - El archivo de configuración de cada herramienta se modifica para usar UberLLM. Primero se guarda una copia de cada archivo.
- Comprueba que la clave funciona y te dice qué reiniciar.
Ejecutarlo de nuevo no cambia nada si todo ya está configurado.
Ver los cambios primero
npx uberllm init --dry-run
Esto imprime cada archivo que cambiaría y las líneas que añadiría. No abre el navegador y no escribe nada.
Qué obtiene cada herramienta
| Herramienta | Archivo que modifica | Cómo la herramienta lee tu clave |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
apiKeyHelper lee ~/.uberllm/key |
| Codex CLI | ~/.codex/config.toml |
el comando auth del proveedor lee ~/.uberllm/key |
| OpenCode | ~/.config/opencode/opencode.json |
{file:~/.uberllm/key} |
| Kilo Code | ~/.config/kilo/kilo.jsonc |
la variable UBERLLM_API_KEY |
| Goose | ~/.config/goose/custom_providers/uberllm.json |
la variable UBERLLM_API_KEY |
| Aider | ~/.aider.conf.yml, ~/.aider.model.settings.yml |
un archivo env privado en ~/.uberllm |
| Continue | ~/.continue/config.yaml |
~/.continue/.env (archivo de secretos propio de Continue) |
Kilo Code y Goose solo leen una clave del entorno. Para ellos, se añade una línea a tu perfil de shell (~/.zshrc, ~/.bashrc o fish). Esa línea lee el archivo de la clave; la clave en sí no se escribe en el perfil. En Windows, el comando imprime ese paso para que lo hagas tú en su lugar.
Claude Code sigue pidiendo sus propios modelos Claude. Las otras herramientas obtienen un modelo predeterminado: el primer modelo de codificación en la lista de modelos que está aceptando solicitudes cuando ejecutas el comando. Para elegirlo tú mismo:
npx uberllm init --model deepseek/deepseek-v4.1-flash
Herramientas que se configuran dentro de la aplicación
Cursor, Cline y Roo Code mantienen estas configuraciones dentro del editor, no en un archivo que un comando pueda cambiar. Para ellos, el comando imprime los tres pasos a seguir, con la dirección y el ID del modelo ya completados. Consulta Cursor, Cline y Roo Code.
Gemini CLI solo se comunica con servidores que hablan la API de Gemini de Google, que UberLLM no sirve. Para usar modelos Gemini a través de UberLLM, configura OpenCode o Codex con un ID de modelo Gemini: npx uberllm init --tool opencode --model <id>.
Opciones
| Opción | Qué hace |
|---|---|
--tool <names> |
Solo estas herramientas, separadas por comas: claude-code, codex, opencode, kilo-code, goose, aider, continue, cursor, cline, roo-code, gemini-cli. También configura una herramienta que no se encontró. |
--project [dir] |
Solo este proyecto (predeterminado: la carpeta actual). |
--model <id> |
El modelo predeterminado a establecer. |
--key <key> |
Usar esta clave y omitir el navegador. |
--relink |
Obtener una nueva clave en el navegador, incluso si ya hay una guardada o establecida. |
--dry-run |
Mostrar qué cambiaría. No cambiar nada. |
--undo |
Restaurar todo. |
Qué clave se usa: --key si la pasas, luego la clave ya guardada en
~/.uberllm, luego UBERLLM_API_KEY del entorno, luego el navegador.
Un solo proyecto
cd my-project
npx uberllm init --project
Solo esa carpeta se ejecuta en UberLLM; tus otros proyectos no se modifican. Esto funciona para las herramientas que tienen una configuración por proyecto: Claude Code (.claude/settings.local.json), OpenCode (opencode.json) y Aider (.aider.conf.yml). No se escribe ninguna clave en la carpeta del proyecto. Codex CLI, Kilo Code, Goose y Continue se configuran por máquina, por lo que se omiten aquí.
En Windows, Claude Code no se configura por proyecto, porque eso pondría la clave en la carpeta del proyecto. Ejecuta el comando sin --project allí.
Deshacer
npx uberllm init --undo
- Un archivo que no has tocado desde entonces se restaura exactamente como estaba. Un archivo que el comando creó se elimina.
- Un archivo que has editado desde entonces conserva tus ediciones. Solo se elimina lo que el comando añadió, y se restauran las configuraciones que reemplazó. La copia de antes de que se ejecutara el comando permanece en
~/.uberllm/backups/. - El archivo de clave guardado se elimina si este comando lo creó y ninguna herramienta que configuró lo sigue usando. Un archivo de clave del instalador de Claude Code se deja en su lugar. Para desactivar la clave también, elimínala en tu página de claves.
Deshaz una herramienta con --undo --tool codex, o un proyecto con
--undo --project. Kilo Code y Goose comparten la línea en tu perfil de shell, por lo
que permanece hasta que ambos se deshagan.
Dónde se guardan las cosas
| Ruta | Qué es |
|---|---|
~/.uberllm/key |
Tu clave. Solo tú puedes leerla (modo 600). |
~/.uberllm/backups/ |
Una copia de cada archivo de antes de ser modificado. |
~/.uberllm/init.json |
La lista de archivos que el comando cambió, usada por --undo. |
La clave se envía a api.uberllm.dev y a ningún otro lugar. Nunca se imprime.
Cuando un archivo se deja intacto
El comando no reescribe un archivo que podría dañar. Te informa e imprime los pasos para hacerlo a mano. Esto ocurre cuando:
- una configuración JSON tiene comentarios (
opencode.jsonc,kilo.jsonc), porque una reescritura los perdería; - una configuración JSON no se puede leer;
- el
models:de Continue está escrito en una sola línea; - con
--project, un archivo de configuración es un enlace a un archivo fuera del proyecto.
La herramienta aparece entonces como "aún no configurada" al final de la ejecución.
Solución de problemas
| Lo que ves | Qué hacer |
|---|---|
No supported coding tool was found |
Instala la herramienta primero, o nómbrala: npx uberllm init --tool codex. |
The gateway did not accept the key |
Ejecuta npx uberllm init --relink para obtener una nueva key. |
| Una herramienta sigue usando su proveedor antiguo | Reiníciala. Para Kilo Code y Goose, abre una nueva terminal primero para que la nueva variable se cargue. |
ANTHROPIC_API_KEY is set in your shell |
Claude Code usa esa variable antes de la key guardada. Elimínala de tu perfil de shell. |
402 cuando una herramienta envía una solicitud |
Añade crédito en la [página de créditos]](https://uberllm.dev/dashboard/credits). |