Configure suas ferramentas de codificação

npx uberllm init

O comando encontra as ferramentas de codificação na sua máquina e configura cada uma delas para usar o UberLLM. Você precisa do Node.js 18 ou posterior. Nada mais é instalado.

O que acontece quando você o executa:

1. Ele lista as ferramentas que encontrou.
2. Seu navegador abre. Faça login (ou crie uma conta) e pressione Conectar. Isso cria uma API key para esta máquina.
3. A key é salva em ~/.uberllm/key, um arquivo que só você pode ler.
4. O arquivo de configuração de cada ferramenta é alterado para usar o UberLLM. Uma cópia de cada arquivo é salva primeiro.
5. Ele verifica se a key funciona e informa o que reiniciar.

Executá-lo novamente não muda nada se tudo já estiver configurado.

Veja as mudanças primeiro

npx uberllm init --dry-run

Isto imprime cada arquivo que ele mudaria e as linhas que ele adicionaria. Ele não abre o navegador e não escreve nada.

O que cada ferramenta recebe

Kilo Code e Goose apenas leem uma chave do ambiente. Para eles, uma linha é adicionada ao seu perfil de shell (~/.zshrc, ~/.bashrc ou fish). Essa linha lê o arquivo da chave; a chave em si não é escrita no perfil. No Windows, o comando imprime esse único passo para você fazer em vez disso.

Claude Code continua pedindo por seus próprios modelos Claude. As outras ferramentas obtêm um modelo padrão: o primeiro modelo de codificação na lista de modelos que está aceitando requisições quando você executa o comando. Para escolhê-lo você mesmo:

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

Ferramentas configuradas dentro do aplicativo

Cursor, Cline e Roo Code mantêm essas configurações dentro do editor, não em um arquivo que um comando possa alterar. Para eles, o comando imprime os três passos a seguir, com o endereço e o ID do modelo preenchidos. Veja Cursor, Cline e Roo Code.

Gemini CLI apenas se comunica com servidores que falam a API Gemini do Google, a qual o UberLLM não atende. Para usar modelos Gemini através do UberLLM, configure o OpenCode ou o Codex com um ID de modelo Gemini: npx uberllm init --tool opencode --model <id>.

Opções

Qual chave é usada: --key se você a passar, depois a chave já salva em ~/.uberllm, depois UBERLLM_API_KEY do ambiente, depois o navegador.

Apenas um projeto

cd my-project
npx uberllm init --project

Apenas aquela pasta roda no UberLLM; seus outros projetos não são alterados. Isso funciona para as ferramentas que têm uma configuração por projeto: Claude Code (.claude/settings.local.json), OpenCode (opencode.json) e Aider (.aider.conf.yml). Nenhuma chave é escrita na pasta do projeto. Codex CLI, Kilo Code, Goose e Continue são configurados por máquina, então são ignorados aqui.

No Windows, o Claude Code não é configurado por projeto, porque isso colocaria a chave na pasta do projeto. Execute o comando sem --project lá.

Desfazer

npx uberllm init --undo

• Um arquivo que você não tocou desde então é restaurado exatamente como estava. Um arquivo que o comando criou é removido.
• Um arquivo que você editou desde então mantém suas edições. Apenas o que o comando adicionou é removido, e as configurações que ele substituiu são restauradas. A cópia de antes da execução do comando permanece em ~/.uberllm/backups/.
• O arquivo de chave salvo é removido se este comando o criou e nenhuma ferramenta que ele configurou ainda o usa. Um arquivo de chave do instalador do Claude Code é mantido no lugar. Para desativar a chave também, exclua-a na sua página de chaves.

Desfaça uma ferramenta com --undo --tool codex, ou um projeto com --undo --project. Kilo Code e Goose compartilham a linha no seu perfil de shell, então ela permanece até que ambos sejam desfeitos.

Onde as coisas são guardadas

A chave é enviada para api.uberllm.dev e para nenhum outro lugar. Ela nunca é impressa.

Quando um arquivo é deixado intocado

O comando não reescreve um arquivo que poderia danificar. Ele informa e imprime os passos para fazer manualmente. Isso acontece quando:

• uma configuração JSON tem comentários (opencode.jsonc, kilo.jsonc), porque uma reescrita os perderia;
• uma configuração JSON não pode ser lida;
• o models: do Continue está escrito em uma linha;
• com --project, um arquivo de configuração é um link para um arquivo fora do projeto.

A ferramenta é então listada como "ainda não configurada" no final da execução.

Solução de Problemas