Skip to main content
すでに CC Switch または Cherry Studio をインストールしている場合は、DimiLinks コンソールから現在のキーをローカルクライアントへワンクリックで送信できます。base URL やモデルを手動で入力する必要はありません。

​
ワンクリックインポートの手順

  1. DimiLinks コンソールの「API キー」ページを開きます。
  2. 対象キーの右側にある「CC Switch にインポート」または「Cherry Studio にインポート」をクリックします。CC Switch にインポートする前に、「CC Switch の設定先」で書き込み先ツール（Claude Code / Codex / Gemini CLI）を選択できます。デフォルトでは、キーのモデルに基づいて自動的に推奨されます。
  3. ブラウザにシステムレベルの遷移確認が表示され、対応するクライアントが deep link を処理して base URL、キー、モデルを自動的に設定します。
コンソールは、キーの「モデル制限」とグループに基づいて対象 provider を自動的に推奨します。 すべてのリクエストは api-direct.dimilinks.com を使用します。ワンクリックインポートでは、対象クライアントが API パスを自動追加するかどうかに応じて、/v1 を含む形式または含まない形式を正しく設定します。 インポートに失敗する場合は、次の原因が考えられます。
  • クライアントがインストールされていないか、deep link プロトコル（ccswitch:// / cherrystudio://）が登録されていません。
  • ブラウザが scheme の遷移をブロックしています。アドレスバーで一度 Enter キーを押してから再試行してください。
  • OS がそのプロトコルを初めて検出した場合、ローカルアプリを開くか確認されます。許可してください。
  • インポートには成功したものの CC Switch で見つからない場合、provider はインポート時に選択したツールのリストにのみ表示されます（Claude Code / Codex / Gemini はそれぞれ独立しています）。対応するツールのタブに切り替えて確認するか、コンソールに戻って対象を選び直し、再度インポートしてください。
  • Claude Code で使用する場合は、Claude グループのキーを選択してください。汎用グループのキーでは Claude シリーズのモデルを呼び出せません。
コンソールが生成するリンクは次の形式です。
data は URL-safe base64 文字列で、デコードすると次の JSON になります。
type の値は Cherry Studio 内の provider タイプに対応します：openai / anthropic / gemini。 ワンクリックインポートを使用しない場合は、クライアント内で provider を手動作成することもできます。 設定後は、まず「接続テスト」を実行するか、最も簡単なメッセージを 1 件送信して、接続できることを確認してください。