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 を起動します。
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 に完全なキーとともに記述します。
{
"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 からデータツールとブラウザエージェントを利用でき、料金は同じ残高から差し引かれます。認証には同じキーを使います。
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 key | Claude 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/ を含む 404 | ANTHROPIC_BASE_URL が /v1 で終わっていますが、Claude Code は /v1 を自動で付け足します。https://lovelyrouter.com を指定してください。 |
402 | 残高が 0 になったか、キーが利用上限に達しています。クレジットと請求を参照してください。 |
その他のステータスについてはエラーを参照してください。