コーディングツールをセットアップする

npx uberllm init

このコマンドは、お使いのマシン上のコーディングツールを検出し、それぞれをUberLLMを使用するようにセットアップします。Node.js 18]以降が必要です。他には何もインストールされません。

実行するとどうなるか：

1. 検出したツールを一覧表示します。
2. ブラウザが開きます。サインイン（またはアカウントを作成）し、Connectを押します。これにより、このマシン用のAPI keyが作成されます。
3. keyは~/.uberllm/keyに保存されます。これはあなただけが読み取れるファイルです。
4. 各ツールのconfigファイルは、UberLLMを使用するように変更されます。すべてのファイルのコピーが最初に保存されます。
5. keyが機能することを確認し、再起動すべきものを伝えます。

すべてがすでにセットアップされている場合、再度実行しても何も変更されません。

まず変更点を確認する

npx uberllm init --dry-run

これは、変更される各ファイルと追加される行を表示します。ブラウザを開いたり、何も書き込んだりすることはありません。

各ツールが受け取るもの

Kilo CodeとGooseは、環境からのみキーを読み取ります。これらのツールでは、シェルプロファイル（~/.zshrc、~/.bashrc、またはfish）に1行追加されます。その行がキーファイルを読み取ります。キー自体はプロファイルには書き込まれません。Windowsでは、代わりにその1ステップを実行するようコマンドが表示されます。

Claude Codeは、常に独自のClaudeモデルを要求します。他のツールはデフォルトモデルを取得します。それは、コマンド実行時にリクエストを受け付けているモデルリスト上の最初のコーディングモデルです。自分で選択するには：

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

アプリ内で設定されるツール

Cursor、Cline、Roo Codeは、これらの設定をエディター内に保持し、コマンドで変更できるファイルには保持しません。これらのツールでは、アドレスとモデルIDが入力された状態で、従うべき3つのステップがコマンドによって表示されます。Cursor、Cline、Roo Codeを参照してください。

Gemini CLIは、GoogleのGemini APIに対応するサーバーとのみ通信します。UberLLMはこれを提供していません。UberLLMを介してGeminiモデルを使用するには、OpenCodeまたはCodexをGeminiモデルID：npx uberllm init --tool opencode --model <id>で設定してください。

オプション

使用されるキー: 渡された場合は --key、次に ~/.uberllm に既に保存されているキー、次に環境変数からの 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で1つのツールを元に戻すか、--undo --projectで1つのプロジェクトを元に戻します。Kilo CodeとGooseはシェルプロファイルの行を共有しているため、両方が元に戻されるまで残ります。

保管場所

キーはapi.uberllm.devにのみ送信され、他の場所には送信されません。決して出力されることはありません。

ファイルが変更されない場合

コマンドは、破損させる可能性のあるファイルを書き換えません。手動で実行する手順を通知し、表示します。これは次の場合に発生します：

• JSON設定にコメントがある場合 (opencode.jsonc, kilo.jsonc)。書き換えるとそれらが失われるため；
• JSON設定を読み取れない場合；
• Continueの models: が1行で記述されている場合；
• --project を使用して、設定ファイルがプロジェクト外のファイルへのリンクである場合。

ツールはその後、実行の最後に「まだセットアップされていません」としてリストされます。

トラブルシューティング