设置你的编码工具

npx uberllm init

该命令会查找你机器上的编码工具，并将其配置为使用 UberLLM。你需要 Node.js 18 或更高版本。不会安装其他任何东西。

运行它时会发生什么：

1. 它会列出找到的工具。
2. 你的浏览器会打开。登录（或创建账户）并点击 连接。这会为这台机器生成一个 API key。
3. 该 key 会保存到 ~/.uberllm/key，一个只有你能读取的文件。
4. 每个工具的配置文件都会被修改以使用 UberLLM。每个文件的副本都会先保存一份。
5. 它会检查 key 是否有效，并告诉你需要重启什么。

如果一切都已设置好，再次运行它不会改变任何东西。

先查看更改

npx uberllm init --dry-run

这会打印它将更改的每个文件以及它将添加的行。它不会打开浏览器，也不会写入任何内容。

每个工具获得什么

Kilo Code 和 Goose 只从环境中读取密钥。对于它们，您的 shell 配置文件（~/.zshrc、~/.bashrc 或 fish）中会添加一行。该行读取密钥文件；密钥本身不会写入配置文件。在 Windows 上，命令会打印出您需要执行的这一步。

Claude Code 会一直请求它自己的 Claude 模型。其他工具会获得一个默认模型：模型列表 上第一个在您运行命令时正在接收请求的编码模型。要自行选择：

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

在应用内设置的工具

Cursor、Cline 和 Roo Code 将这些设置保存在编辑器内部，而不是命令可以更改的文件中。对于它们，命令会打印出要遵循的三个步骤，并已填入地址和模型 ID。请参阅 Cursor、Cline 和 Roo Code。

Gemini CLI 只与支持 Google Gemini API 的服务器通信，而 UberLLM 不提供此服务。要通过 UberLLM 使用 Gemini 模型，请使用 Gemini 模型 ID 设置 OpenCode 或 Codex：npx uberllm init --tool opencode --model <id>。

选项

使用的 key 是：如果您传入 --key，则使用它；然后是已保存在 ~/.uberllm 中的 key；然后是来自环境的 UBERLLM_API_KEY；最后是浏览器。

仅限一个项目

cd my-project
npx uberllm init --project

只有该文件夹在 UberLLM 上运行；您的其他项目保持不变。这适用于那些具有项目级配置的工具：Claude Code (.claude/settings.local.json)、OpenCode (opencode.json) 和 Aider (.aider.conf.yml)。没有密钥被写入到项目文件夹中。Codex CLI、Kilo Code、Goose 和 Continue 是按机器配置的，因此在此处跳过它们。

在 Windows 上，Claude Code 不会按项目配置，因为那样会将密钥放入项目文件夹中。在那里运行命令时，不带 --project。

撤销

npx uberllm init --undo

• 您此后未曾修改过的文件会被精确地恢复到原样。该命令创建的文件会被移除。
• 您此后已编辑过的文件会保留您的编辑。只有该命令添加的内容会被移除，并且它替换的设置会被恢复。命令运行前的副本会保留在 ~/.uberllm/backups/ 中。
• 如果此命令创建了已保存的密钥文件，并且它设置的工具不再使用它，则该文件会被移除。来自 Claude Code 安装程序的密钥文件会保留在原位。要同时关闭该密钥，请在您的 密钥页面 上删除它。

使用 --undo --tool codex 撤销一个工具，或使用 --undo --project 撤销一个项目。Kilo Code 和 Goose 在您的 shell 配置文件中共享同一行，因此它会保留，直到两者都被撤销。

文件存放位置

密钥仅发送到 api.uberllm.dev，不会发送到其他任何地方。它绝不会被打印出来。

当文件未被修改时

该命令不会重写可能损坏的文件。它会提示你，并打印出需要手动完成的步骤。出现以下情况时：

• JSON 配置文件包含注释 (opencode.jsonc, kilo.jsonc)，因为重写会导致注释丢失；
• JSON 配置文件无法读取；
• Continue 的 models: 写在单行上；
• 当使用 --project 时，配置文件是项目外部文件的链接。

在运行结束时，该工具会被列为“尚未设置”。

故障排除