Siapkan alat coding Anda
npx uberllm init
Perintah ini menemukan alat coding di mesin Anda dan mengaturnya masing-masing untuk menggunakan UberLLM. Anda memerlukan Node.js 18 atau yang lebih baru. Tidak ada hal lain yang diinstal.
Apa yang terjadi saat Anda menjalankannya:
- Ini mencantumkan alat yang ditemukannya.
- Browser Anda terbuka. Masuk (atau buat akun) dan tekan Hubungkan. Ini membuat API key untuk mesin ini.
- Key tersebut disimpan ke
~/.uberllm/key, sebuah file yang hanya bisa Anda baca. - File config masing-masing alat diubah untuk menggunakan UberLLM. Salinan setiap file disimpan terlebih dahulu.
- Ini memeriksa bahwa key berfungsi dan memberi tahu Anda apa yang perlu di-restart.
Menjalankannya lagi tidak mengubah apa pun jika semuanya sudah diatur.
Lihat perubahannya dulu
npx uberllm init --dry-run
Ini mencetak setiap berkas yang akan diubah dan baris-baris yang akan ditambahkan. Ini tidak membuka peramban dan tidak menulis apa pun.
Apa yang didapatkan setiap alat
| Alat | Berkas yang diubah | Bagaimana alat membaca kunci Anda |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
apiKeyHelper membaca ~/.uberllm/key |
| Codex CLI | ~/.codex/config.toml |
perintah auth penyedia membaca ~/.uberllm/key |
| OpenCode | ~/.config/opencode/opencode.json |
{file:~/.uberllm/key} |
| Kilo Code | ~/.config/kilo/kilo.jsonc |
variabel UBERLLM_API_KEY |
| Goose | ~/.config/goose/custom_providers/uberllm.json |
variabel UBERLLM_API_KEY |
| Aider | ~/.aider.conf.yml, ~/.aider.model.settings.yml |
berkas env pribadi di ~/.uberllm |
| Continue | ~/.continue/config.yaml |
~/.continue/.env (berkas rahasia milik Continue) |
Kilo Code dan Goose hanya membaca kunci dari environment. Untuk itu, satu baris ditambahkan ke profil shell Anda (~/.zshrc, ~/.bashrc atau fish). Baris tersebut membaca berkas kunci; kunci itu sendiri tidak ditulis ke dalam profil. Di Windows, perintah akan mencetak satu langkah yang harus Anda lakukan sebagai gantinya.
Claude Code terus meminta model Claude-nya sendiri. Alat-alat lain mendapatkan model default: model coding pertama di daftar model yang menerima permintaan saat Anda menjalankan perintah. Untuk memilihnya sendiri:
npx uberllm init --model deepseek/deepseek-v4.1-flash
Alat yang diatur di dalam aplikasi
Cursor, Cline, dan Roo Code menyimpan pengaturan ini di dalam editor, bukan di berkas yang dapat diubah oleh perintah. Untuk itu, perintah mencetak tiga langkah yang harus diikuti, dengan alamat dan ID model yang sudah terisi. Lihat Cursor, Cline dan Roo Code.
Gemini CLI hanya berkomunikasi dengan server yang menggunakan Gemini API Google, yang tidak dilayani oleh UberLLM. Untuk menggunakan model Gemini melalui UberLLM, atur OpenCode atau Codex dengan ID model Gemini: npx uberllm init --tool opencode --model <id>.
Opsi
| Opsi | Apa fungsinya |
|---|---|
--tool <names> |
Hanya alat-alat ini, dipisahkan koma: claude-code, codex, opencode, kilo-code, goose, aider, continue, cursor, cline, roo-code, gemini-cli. Juga menyiapkan alat yang tidak ditemukan. |
--project [dir] |
Hanya proyek ini (default: folder saat ini). |
--model <id> |
Model default yang akan diatur. |
--key <key> |
Gunakan kunci ini dan lewati browser. |
--relink |
Dapatkan kunci baru di browser, meskipun ada yang sudah tersimpan atau diatur. |
--dry-run |
Tunjukkan apa yang akan berubah. Jangan ubah apa pun. |
--undo |
Kembalikan semuanya seperti semula. |
Kunci mana yang digunakan: --key jika Anda meneruskannya, kemudian kunci yang sudah tersimpan di
~/.uberllm, kemudian UBERLLM_API_KEY dari environment, kemudian browser.
Satu proyek saja
cd my-project
npx uberllm init --project
Hanya folder itu yang berjalan di UberLLM; proyek Anda yang lain tidak berubah. Ini berfungsi untuk alat yang memiliki konfigurasi per-proyek: Claude Code (.claude/settings.local.json), OpenCode (opencode.json) dan Aider (.aider.conf.yml). Tidak ada key yang ditulis ke dalam folder proyek. Codex CLI, Kilo Code, Goose, dan Continue diatur per mesin, jadi mereka dilewati di sini.
Di Windows, Claude Code tidak diatur per proyek, karena itu akan menempatkan key di folder proyek. Jalankan perintah tanpa --project di sana.
Urungkan
npx uberllm init --undo
- Berkas yang belum Anda sentuh sejak itu dikembalikan persis seperti semula. Berkas yang dibuat oleh perintah tersebut dihapus.
- Berkas yang telah Anda edit sejak itu tetap menyimpan perubahan Anda. Hanya apa yang ditambahkan oleh perintah tersebut yang dihapus, dan pengaturan yang digantinya dikembalikan. Salinan dari sebelum perintah dijalankan tetap ada di
~/.uberllm/backups/. - Berkas key yang disimpan akan dihapus jika perintah ini yang membuatnya dan tidak ada alat yang diatur olehnya masih menggunakannya. Berkas key dari installer Claude Code dibiarkan tetap ada. Untuk mematikan key juga, hapuslah di halaman key Anda.
Urungkan satu alat dengan --undo --tool codex, atau satu proyek dengan
--undo --project. Kilo Code dan Goose berbagi baris di profil shell Anda, jadi
baris tersebut tetap ada sampai keduanya diurungkan.
Tempat penyimpanan
| Jalur | Deskripsi |
|---|---|
~/.uberllm/key |
Kunci Anda. Hanya Anda yang bisa membacanya (mode 600). |
~/.uberllm/backups/ |
Salinan setiap file dari sebelum diubah. |
~/.uberllm/init.json |
Daftar file yang diubah oleh perintah, digunakan oleh --undo. |
Kunci dikirim ke api.uberllm.dev dan tidak ke tempat lain. Tidak pernah dicetak.
Ketika sebuah berkas dibiarkan
Perintah ini tidak menimpa ulang berkas yang bisa merusaknya. Ini memberi tahu Anda dan mencetak langkah-langkah untuk dilakukan secara manual. Ini terjadi ketika:
- konfigurasi JSON memiliki komentar (
opencode.jsonc,kilo.jsonc), karena penulisan ulang akan menghilangkannya; - konfigurasi JSON tidak dapat dibaca;
models:milik Continue ditulis dalam satu baris;- dengan
--project, berkas konfigurasi adalah tautan ke berkas di luar proyek.
Alat ini kemudian dicantumkan sebagai "belum disiapkan" di akhir eksekusi.
Penyelesaian Masalah
| Apa yang Anda lihat | Apa yang harus dilakukan |
|---|---|
No supported coding tool was found |
Instal alatnya terlebih dahulu, atau beri nama: npx uberllm init --tool codex. |
The gateway did not accept the key |
Jalankan npx uberllm init --relink untuk mendapatkan kunci baru. |
| Sebuah alat masih menggunakan penyedia lamanya | Mulai ulang. Untuk Kilo Code dan Goose, buka terminal baru terlebih dahulu agar variabel baru dimuat. |
ANTHROPIC_API_KEY is set in your shell |
Claude Code menggunakan variabel itu sebelum kunci yang tersimpan. Hapus dari profil shell Anda. |
402 saat alat mengirim permintaan |
Tambahkan kredit di halaman kredit. |