Thiết lập công cụ lập trình của bạn

npx uberllm init

Lệnh này tìm các công cụ lập trình trên máy của bạn và thiết lập từng công cụ để sử dụng UberLLM. Bạn cần Node.js 18] trở lên. Không có gì khác được cài đặt.

Điều gì xảy ra khi bạn chạy lệnh này:

Nó liệt kê các công cụ nó tìm thấy.
Trình duyệt của bạn mở ra. Đăng nhập (hoặc tạo tài khoản) và nhấn Connect. Điều này tạo ra một API key cho máy này.
Key được lưu vào ~/.uberllm/key, một tệp mà chỉ bạn mới có thể đọc.
Tệp cấu hình riêng của mỗi công cụ được thay đổi để sử dụng UberLLM. Một bản sao của mỗi tệp được lưu trước.
Nó kiểm tra xem key có hoạt động không và cho bạn biết cần khởi động lại những gì.

Chạy lại lệnh này không thay đổi gì nếu mọi thứ đã được thiết lập sẵn.

Xem trước các thay đổi

npx uberllm init --dry-run

Điều này in ra từng tệp mà nó sẽ thay đổi và các dòng mà nó sẽ thêm vào. Nó không mở trình duyệt và không ghi bất cứ điều gì.

Mỗi công cụ nhận được gì

Công cụ	Tệp nó thay đổi	Cách công cụ đọc khóa của bạn
Claude Code	`~/.claude/settings.json`	`apiKeyHelper` đọc `~/.uberllm/key`
Codex CLI	`~/.codex/config.toml`	lệnh `auth` của nhà cung cấp đọc `~/.uberllm/key`
OpenCode	`~/.config/opencode/opencode.json`	`{file:~/.uberllm/key}`
Kilo Code	`~/.config/kilo/kilo.jsonc`	biến `UBERLLM_API_KEY`
Goose	`~/.config/goose/custom_providers/uberllm.json`	biến `UBERLLM_API_KEY`
Aider	`~/.aider.conf.yml`, `~/.aider.model.settings.yml`	một tệp env riêng tư trong `~/.uberllm`
Continue	`~/.continue/config.yaml`	`~/.continue/.env` (tệp bí mật riêng của Continue)

Kilo Code và Goose chỉ đọc khóa từ môi trường. Đối với chúng, một dòng được thêm vào hồ sơ shell của bạn (~/.zshrc, ~/.bashrc hoặc fish). Dòng đó đọc tệp khóa; bản thân khóa không được ghi vào hồ sơ. Trên Windows, lệnh sẽ in ra bước đó để bạn thực hiện thay thế.

Claude Code tiếp tục yêu cầu các mô hình Claude riêng của nó. Các công cụ khác nhận được một mô hình mặc định: mô hình mã hóa đầu tiên trên danh sách mô hình đang nhận yêu cầu khi bạn chạy lệnh. Để tự chọn:

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

Các công cụ được thiết lập bên trong ứng dụng

Cursor, Cline và Roo Code giữ các cài đặt này bên trong trình chỉnh sửa, không phải trong một tệp mà lệnh có thể thay đổi. Đối với chúng, lệnh sẽ in ra ba bước cần thực hiện, với địa chỉ và ID mô hình đã được điền sẵn. Xem Cursor, Cline và Roo Code.

Gemini CLI chỉ giao tiếp với các máy chủ nói API Gemini của Google, mà UberLLM không phục vụ. Để sử dụng các mô hình Gemini thông qua UberLLM, hãy thiết lập OpenCode hoặc Codex với ID mô hình Gemini: npx uberllm init --tool opencode --model <id>.

Tùy Chọn

Tùy Chọn	Chức năng
`--tool <names>`	Chỉ các công cụ này, phân tách bằng dấu phẩy: `claude-code`, `codex`, `opencode`, `kilo-code`, `goose`, `aider`, `continue`, `cursor`, `cline`, `roo-code`, `gemini-cli`. Cũng thiết lập một công cụ không tìm thấy.
`--project [dir]`	Chỉ dự án này (mặc định: thư mục hiện tại).
`--model <id>`	Mô hình mặc định để thiết lập.
`--key <key>`	Sử dụng khóa này và bỏ qua trình duyệt.
`--relink`	Lấy khóa mới trong trình duyệt, ngay cả khi đã có khóa được lưu hoặc thiết lập.
`--dry-run`	Hiển thị những gì sẽ thay đổi. Không thay đổi gì cả.
`--undo`	Khôi phục mọi thứ.

Khóa nào được sử dụng: --key nếu bạn truyền vào, sau đó là khóa đã lưu trong ~/.uberllm, sau đó là UBERLLM_API_KEY từ môi trường, sau đó là trình duyệt.

Chỉ một dự án

cd my-project
npx uberllm init --project

Chỉ thư mục đó chạy trên UberLLM; các dự án khác của bạn không thay đổi. Điều này hoạt động với các công cụ có cấu hình theo từng dự án: Claude Code (.claude/settings.local.json), OpenCode (opencode.json) và Aider (.aider.conf.yml). Không có key nào được ghi vào thư mục dự án. Codex CLI, Kilo Code, Goose và Continue được thiết lập cho từng máy, nên chúng được bỏ qua ở đây.

Trên Windows, Claude Code không được thiết lập theo từng dự án, vì điều đó sẽ đặt key vào thư mục dự án. Chạy lệnh mà không có --project ở đó.

Hoàn tác

npx uberllm init --undo

Một tệp bạn chưa chạm vào kể từ đó sẽ được đặt lại chính xác như ban đầu. Một tệp mà lệnh đã tạo sẽ bị xóa.
Một tệp bạn đã chỉnh sửa kể từ đó sẽ giữ nguyên các chỉnh sửa của bạn. Chỉ những gì lệnh đã thêm vào sẽ bị loại bỏ, và các cài đặt mà nó đã thay thế sẽ được đặt lại. Bản sao từ trước khi lệnh chạy vẫn còn trong ~/.uberllm/backups/.
Tệp khóa đã lưu sẽ bị xóa nếu lệnh này đã tạo ra nó và không có công cụ nào mà nó đã thiết lập vẫn sử dụng nó. Một tệp khóa từ trình cài đặt Claude Code sẽ được giữ nguyên. Để tắt khóa đó luôn, hãy xóa nó trên trang khóa của bạn.

Hoàn tác một công cụ bằng --undo --tool codex, hoặc một dự án bằng --undo --project. Kilo Code và Goose chia sẻ dòng trong hồ sơ shell của bạn, vì vậy nó sẽ giữ nguyên cho đến khi cả hai được hoàn tác.

Nơi mọi thứ được lưu trữ

Đường dẫn	Mô tả
`~/.uberllm/key`	Khóa của bạn. Chỉ bạn mới có thể đọc nó (chế độ 600).
`~/.uberllm/backups/`	Một bản sao của mỗi tệp từ trước khi nó được thay đổi.
`~/.uberllm/init.json`	Danh sách các tệp mà lệnh đã thay đổi, được sử dụng bởi `--undo`.

Khóa được gửi đến api.uberllm.dev và không nơi nào khác. Nó không bao giờ được in ra.

Khi một tệp bị bỏ qua

Lệnh không ghi đè lên một tệp mà nó có thể làm hỏng. Nó sẽ thông báo cho bạn và in ra các bước cần thực hiện thủ công. Điều này xảy ra khi:

một cấu hình JSON có chứa bình luận (opencode.jsonc, kilo.jsonc), vì việc ghi đè sẽ làm mất chúng;
một cấu hình JSON không thể đọc được;
models: của Continue được viết trên một dòng;
với --project, một tệp cấu hình là một liên kết đến một tệp bên ngoài dự án.

Công cụ sau đó được liệt kê là "chưa được thiết lập" khi kết thúc quá trình chạy.

Khắc phục sự cố

Bạn thấy gì	Bạn cần làm gì
`No supported coding tool was found`	Cài đặt công cụ trước, hoặc đặt tên cho nó: `npx uberllm init --tool codex`.
`The gateway did not accept the key`	Chạy `npx uberllm init --relink` để lấy khóa mới.
Một công cụ vẫn dùng nhà cung cấp cũ của nó	Khởi động lại nó. Đối với Kilo Code và Goose, hãy mở một terminal mới trước để biến mới được tải.
`ANTHROPIC_API_KEY is set in your shell`	Claude Code sử dụng biến đó trước khóa đã lưu. Xóa nó khỏi hồ sơ shell của bạn.
`402` khi một công cụ gửi yêu cầu	Thêm tín dụng trên trang tín dụng.