キー管理

キー管理（Key Management）は、アカウントが提供できる「実行時キー」を一元表示するための機能です。通常の Token、OpenRouter ネイティブキー、SharedChat サービスキーでは、利用できる機能や画面が異なる場合があります。ボタンは現在のアカウントの能力に応じて表示または非表示になります。

活用シーン

複数の中継サイトで作成した大量の Token を、各管理画面にログインせず、名前で検索して一元表示または一括エクスポートしたい。
作成時に一度だけ完全なキーが表示されるサイトで、作成後すぐに保存したい。
アカウントのキーがまだ利用可能か、CLI ツールと互換性があるかを確認したい。
アカウントのキーを API 認証情報ライブラリに保存したり、よく使う AI ツールへエクスポートしたりしたい。

機能の概要

一元リスト：アカウント別にグループ化するか、すべてのアカウントのキーを表示します。キーは既定でマスクされます。
名前で検索：検索対象はキー名だけで、キーの内容は検索しません。
追加、編集、削除：通常の Token では、名前、クォータ、有効期限、グループ、モデル制限、IP / サブネット制限を設定できます。利用できる項目はサイト能力によって異なります。
表示とコピー：サーバーが完全なキーを返す場合、またはローカルに保存された API 認証情報と正確に一致する場合にのみ、完全な値を利用できます。一度だけ表示されるキーは、後から復元できない可能性があるため、すぐに保存してください。
キーチェック（修復）：保存済みアカウントに利用可能なキーがあるか確認し、対応している場合は不足分を自動作成し、その他の問題を一覧表示します。
検証とエクスポート：完全なキーを利用でき、アカウント能力が対応している場合、API や CLI 互換性の検証、API 認証情報ライブラリへの保存、AI ツールへのエクスポート、セルフホスト型サイトへの送信ができます。

アクセス方法

拡張機能のポップアップで、鍵アイコンの キー管理 をクリックします。
フルページ表示では、左側の インターフェース カテゴリから キー管理 を開きます。
アカウント管理でアカウントの操作メニューを開き、キー管理 をクリックすると、そのアカウントに移動します。

ヒント

キー管理 と API 認証情報ライブラリ は別のページです。キー管理は追加済みサイトアカウント向けで、API 認証情報ライブラリはサイトアカウントがなく Base URL + API Key だけを保存する場合に使います。

データソースと能力の違い

ページで利用できる機能は、アカウント種別、サイト、権限によって変わります。主なデータソースは次の 3 種類です。

データソース	説明
従来型 Token（New API 系など）	表示、追加、編集、削除が可能。名前で検索し、キーは既定でマスク表示。
OpenRouter ネイティブキー	Management API を使用。ワークスペース、クォータ、有効期限、無効状態などを扱えます。完全なキーは作成時に一度だけ表示される場合があります。ローカル認証情報に関連付けられていない過去の項目は、メタデータだけを管理できます。
SharedChat サービスキー	アカウント単位のサービスキーで、通常は 1 件だけです。対応している場合は「リセット」でき、通常の Token の追加・編集・削除とは異なります。

実際に利用できる機能は、現在のアカウント画面に表示されるボタンを基準にしてください。ここで説明しているのは一般的な能力であり、すべてのサイトが全操作に対応するわけではありません。

主な操作

1. アカウントの選択と更新

ページ上部で すべてのアカウント または 1 つのアカウントを選択します。
キー一覧を更新 でアカウントのキーと状態を再取得します。上限や有効期限などはサイトが提供する情報です。管理サイトの状態はインポート済みかを示し、展開して対応チャネルの確認や再確認ができます。キー自体の有効性を示すものではありません。

2. 検索

検索欄にキー名を入力して絞り込みます。検索は名前だけに一致し、キーの内容は検索しません。

3. 表示、完全表示、コピー

キーは既定で sk-***... のようにマスク表示されます。
完全なキーを復元できる場合、キーを表示 / キーを隠す で一時的に完全な値を表示し、コピー でクリップボードにコピーできます。
マスクは表示を保護するだけで、暗号化保存を意味しません。完全なキーが利用できる場合にのみ、コピー、検証、エクスポート、バックアップ、リモート送信などの操作が表示され、完全な値が使われます。
AIHubMix や OpenRouter の一部のように、作成時に一度だけ表示されるキーはすぐに保存してください。ローカルの API 認証情報と正確に一致しない OpenRouter の過去項目にはマスクまたはハッシュしかなく、完全なキーの復元、コピー、検証、エクスポートはできません。

4. キーの追加

ページ右上の API キーを追加 をクリックします。
サイトが対応している項目を入力します。
- キー名：識別用の必須項目です。
- クォータ設定：無制限クォータ または USD 金額の制限クォータを選択します。
- 有効期限：空欄の場合は無期限です。
- グループ：サイトが対応している場合に選択します。
- モデル制限：モデルを選択 で利用可能なモデルを制限します。
- IP / サブネット制限：必要に応じて許可する送信元アドレスを制限します。
キーを作成 をクリックします。

作成時に一度だけキーを表示するサイトでは、成功後に 完全なキーを今すぐ保存 ダイアログが表示されます。閉じる前にコピーまたは保存してください。

5. キーの編集

キーを編集 をクリックすると、名前、クォータ、有効期限、グループ、モデル制限などの対応項目を変更できます。編集してもキーの値自体は変わりません。 サイトが更新に対応していない場合は、その理由が表示されます。

6. キーの削除

キーを削除 をクリックし、確認内容を確認します。
現在の管理サイトの関連チャネルも整理する場合は、該当項目を選択します。複数キーのチャネルではほかのキーを保持し、キーが残らない場合のみチャネル全体を削除します。
削除を確定し、結果を確認します。不明な場合は先に一覧を更新し、チャネルの整理が未完了の場合は案内に沿って再試行してください。

一括削除、一括有効化 / 無効化には現在対応していません。

7. キーチェック（修復）

上部の キーチェック をクリックします。

アカウントキーをチェック ダイアログで チェックして不足分を補完 をクリックします。
拡張機能が保存済みアカウントに利用可能なキーがあるか確認します。自動作成に対応するアカウントではキーを新規作成する場合があり、その他の問題は理由付きで一覧表示されます。
AIHubMix の一度だけ表示されるキーや、自動作成に対応していないサイトなど、自動処理できないアカウントには手動対応の案内が表示されます。

キーチェックは、データソース、権限、キーの復元能力が許す範囲で不足を補います。すべてのキーを復元できるとは限りません。リモートでキーを作成する可能性がある操作では、対象サイトに新しいキーが作成される場合があることを明示します。

8. API と CLI 互換性の検証

キーの操作エリアには API を検証 と CLI 互換性を検証 があります。

検証は 1 回のプローブで、現在のキーとエンドポイントが利用でき、応答が期待どおりかを確認します。
CLI 互換性の検証は、CLI ツールに適しているかを評価します。外部 CLI を実際に起動したり、完全に実行したりはしません。
結果はその時点のプローブ結果です。長期的な利用可能性や永続的な失敗を保証するものではありません。

9. 一括操作

現在の絞り込み結果を全選択、アカウントグループ別に選択、または選択解除して複数のキーを選ぶと、次の操作を使用できます。

API 認証情報ライブラリに保存：選択したキーを API 認証情報ライブラリに保存します。
セルフホスト型 AI ゲートウェイ（Managed Site）へ一括取り込み：確認、事前入力、プレビュー後に送信します。入口をクリックしただけではリモートに書き込まれません。

一括操作に対応するキーだけが対象です。一括削除、一括有効化 / 無効化、プレーンテキストの一括コピー、CSV エクスポートには現在対応していません。

10. 他のツールへのエクスポート

Token の操作エリアには、対象に応じて異なる入口があります。

チャットクライアント：Cherry Studio、Kelivo
コーディングエージェント：CC Switch、Kilo Code / Roo Code、Cursor++
ゲートウェイとルーティングツール：Claude Code Router
セルフホスト型 Managed Site：現在の Managed Site アイコンが直接表示されます。クリックすると事前入力されたチャネル新規作成フローが開きます。同じチャネルが検出されても重複リスクの警告だけが表示され、既存チャネルの更新や上書きは行いません。

Kilo Code / Roo Code へのエクスポート

エクスポートと連携の詳細は、対応エクスポートツールと連携先を参照してください。

管理機能との連携

キー管理で アカウントのモデルを見る をクリックすると、そのアカウントのモデル一覧を開けます。
モデル一覧から、そのアカウントのキー管理へ戻ることもできます。
よく使うキーにメモやタグを追加するには、**API 認証情報ライブラリに保存して関連付け**をクリックし、URL + Key を API 認証情報ライブラリに保存します。

セキュリティ

マスクは暗号化ではありません：マスクは表示だけを保護します。完全なキーがある場合、コピー、検証、エクスポート、バックアップ、リモート送信には完全な値が使われます。マスクまたはハッシュしかない項目では、これらの操作を利用できません。
API 認証情報ライブラリに保存すると、完全な Base URL + キー が拡張機能内にローカル保存され、画面では既定でマスクされます。ローカルプロファイルを削除しても、リモートキーは取り消しまたは変更されません。
保存時の暗号化はデータソースによって異なり、既定のアプリケーション層暗号化は確認されていません。ローカル環境でキーを適切に保護してください。
一度だけ表示されるキーは作成後すぐに保存してください。

よくある質問

質問	回答
完全なキーが表示されないのはなぜですか？	サイトがキーの再表示を無効にしているか、作成時に一度だけ表示されるキーです。ローカル API 認証情報に関連付けられていない OpenRouter の過去項目は完全な値を復元できず、キーチェックでも復元を保証できません。
キーの安全性はどうなっていますか？	キーは既定でマスクされますが、マスクは表示だけを保護します。完全なキーがある場合、コピー、検証、エクスポート、リモート送信にはその値が使われます。保存時の暗号化はデータソースによって異なるため、既定で暗号化されると想定しないでください。
目的のキーを検索できないのはなぜですか？	検索はキー名だけに一致し、キーの内容は検索しません。
アカウントごとにボタンが違うのはなぜですか？	キー管理はアカウント能力に応じて操作を表示します。サイトごとに Token、ネイティブキー、サービスキーへの対応が異なります。