Lovely Routerドキュメント
キーを取得
連携

Claude Code

Lovely Router の API キーで Claude Code を使う方法。ベース URL とキーを設定し、Claude のモデルを選びます。プロンプトキャッシュもそのまま機能します。

Claude Code はターミナルで動くコーディングエージェントです。Anthropic Messages API を使い、Lovely Router はこの API をネイティブに提供しているため、変更する設定はベース URL とキーの 2 つだけで、それ以外はそのままです。まず API キーを用意してください。

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

API キーページで ツールで使う → Claude Code を開きます。ダイアログには以下の設定がキー入りで表示され、CC Switch でインポート を使うと、CC Switch デスクトップアプリに Lovely Router がプロバイダーとして追加され、モデルも設定済みの状態になります。CC Switch のインストールが必要です。

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

ベース URL とキーを設定する#

ベース URL とキーを設定し、いつもどおり Claude Code を起動します。

Shell
export ANTHROPIC_BASE_URL=https://lovelyrouter.com
export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claude

セッションをまたいで設定を保持するには、代わりに ~/.claude/settings.json に完全なキーとともに記述します。

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://lovelyrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "lr-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

モデルを選ぶ#

ANTHROPIC_MODEL はメインのモデル、ANTHROPIC_DEFAULT_HAIKU_MODEL はバックグラウンドの軽いタスクを担当するモデルです。GET /v1/models にある Claude のモデル ID ならどれでも使えます(例:claude-opus-5.5)。すべての ID はモデル一覧で確認できます。

プロンプトキャッシュ#

Claude Code のプロンプトキャッシュは Lovely Router 経由でも機能します。各セッションはキャッシュを持つチャネルに固定されます。プロンプトキャッシュを参照してください。

MCP でデータツールを追加する#

https://lovelyrouter.com/mcp の MCP サーバーを使うと、Claude Code からデータツールとブラウザエージェントを利用でき、料金は同じ残高から差し引かれます。認証には同じキーを使います。

Shell
claude mcp add --transport http lovely https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

このコマンドは現在のプロジェクトにだけ追加します。すべてのプロジェクトで使うには --scope user を付けてください。接続できているかは claude mcp list で確認できます。.mcp.json でチームと共有する方法や、ツールの一覧は MCP サーバーを参照してください。

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

症状対処法
401 と Missing API keyClaude Code がキーを送っていません。claude を起動するシェルで ANTHROPIC_AUTH_TOKEN を export しているか、~/.claude/settings.json に設定しているかを確認してください。
401 と Invalid or revoked API keyキーの入力ミス、途中での欠け、または失効が考えられます。貼り付け直すか、新しいキーを作成してください。
404 と Model '...' is not availableそのモデル ID は存在しません。GET /v1/models またはモデル一覧から Claude のモデル ID をコピーしてください。
パスに /v1/v1/ を含む 404ANTHROPIC_BASE_URL が /v1 で終わっていますが、Claude Code は /v1 を自動で付け足します。https://lovelyrouter.com を指定してください。
402残高が 0 になったか、キーが利用上限に達しています。クレジットと請求を参照してください。

その他のステータスについてはエラーを参照してください。