はじめに

お使いのツールで使う

Claude Code、Codex CLI、Gemini CLI、デスクトップのチャットアプリ、公式 SDK を、1 つの API キーで Lovely Router に接続します。

API のベース URL を変更できるツールなら、どれでも Lovely Router で使えます。変更する設定はベース URL とキーの 2 つだけで、それ以外はそのままです。まず API キーを用意してください。

ワンクリックで設定する#

API キーページでは、各キーに ツールで使う ボタンがあり、作成したばかりのキーの横には ツールで使う… ボタンが表示されます。開いたダイアログには、以下の各クライアント向けの設定がキー入りで表示され、ワンクリックでインポートできるリンクも用意されています。

Claude Code、Codex CLI、Gemini CLI：CC Switch でインポート を使うと、CC Switch デスクトップアプリに Lovely Router がプロバイダーとして追加され、モデルも設定済みの状態になります。CC Switch のインストールが必要です。
Cherry Studio、DeepChat、AionUI：（アプリ名）で開く を使うと、そのアプリに Lovely Router がプロバイダーとして追加されます。アプリのインストールが必要です。

キーを作成した直後は、ダイアログにそのキーがすでに入っています。既存のキーを使う場合は、完全なキーをダイアログに貼り付けてください。Lovely Router はハッシュしか保存しないため、キーを再表示できません。

クライアントを設定する#

各ガイドに、クライアントごとの完全な設定手順があります。コマンドと設定ファイル、選ぶべきモデル、よくあるエラーの対処法をまとめています。

Claude Code

Anthropic Messages API。2 つの環境変数または settings.json で設定し、プロンプトキャッシュも機能します。

Codex CLI

GPT のモデルで OpenAI Responses API を使います。config.toml にモデルプロバイダーを 1 つ追加します。

Gemini CLI

Gemini API。2 つの環境変数で設定します。

Cherry Studio

デスクトップのチャットアプリ。OpenAI 互換プロバイダーとして、ワンクリックでインポートできます。

DeepChat

デスクトップのチャットアプリ。OpenAI 互換プロバイダーとして、ワンクリックでインポートできます。

AionUI

モデルとエージェントのためのデスクトップアプリ。OpenAI 互換プロバイダーとして、ワンクリックでインポートできます。

OpenAI 互換アプリ

カスタムの OpenAI エンドポイントを設定できるアプリ、エージェントフレームワーク、ライブラリ。

SDK

公式の OpenAI、Anthropic、Google Gen AI SDK。Python と Node.js の例があります。

API 形式ごとのベース URL#

ベース URL は、モデルではなくクライアントが使う API によって決まります。

API 形式	クライアント	ベース URL
Anthropic Messages	Claude Code、Anthropic SDK	`https://lovelyrouter.com`
OpenAI Chat Completions と Responses	Codex CLI、OpenAI SDK、OpenAI 互換アプリ	`https://lovelyrouter.com/v1`
Gemini	Gemini CLI、Google Gen AI SDK	`https://lovelyrouter.com`
OpenAI 互換の「API ホスト」	Cherry Studio、DeepChat、AionUI	`https://lovelyrouter.com`（`/v1` はアプリが付け足します）

MCP でエージェントにデータツールを使わせる#

https://lovelyrouter.com/mcp の MCP サーバーを使うと、あらゆる MCP クライアントからデータツールとブラウザエージェントを利用でき、料金は同じ残高から差し引かれます。認証には同じキーを使います。Claude Code、Codex CLI、Gemini CLI の各ガイドに、追加用のコマンドがあります。その他のクライアントや MCP ツールの一覧は、MCP サーバーを参照してください。

トラブルシューティング#

症状	対処法
`401` と `Missing API key`	ツールがキーを送っていません。変数名と、ツールを起動するシェルでその変数を export しているかを確認してください。
`401` と `Invalid or revoked API key`	キーの入力ミス、途中での欠け、または失効が考えられます。貼り付け直すか、新しいキーを作成してください。
`404` と `Model '...' is not available`	そのモデル ID は存在しません。`GET /v1/models` またはモデル一覧から ID をコピーしてください。
`404` と `Unknown endpoint`	ツールが Lovely Router の提供していない API（embeddings や audio など）を呼び出しています。Chat Completions、Responses API、または Anthropic か Gemini の形式に切り替えてください。
パスに `/v1/v1/` を含む `404`	アプリが自動で `/v1` を付け足しています。ホストには `https://lovelyrouter.com` を指定してください。
`402`	残高が 0 になったか、キーが利用上限に達しています。クレジットと請求を参照してください。

クライアント固有のエラーは各クライアントのガイドに記載しています。その他のステータスについてはエラーを参照してください。