Claude Desktop

機能概要

Claude Desktop パネルでは、Olenro 上で Claude Desktop のプロバイダー設定を管理できます。

有効にすると、次のことができます。

• Claude Desktop でサードパーティの Anthropic 互換プロバイダーを使う
• DeepSeek、Kimi、DouBao、OpenAI、Gemini などの非 Claude モデルにモデルマッピングを設定する
• Copilot / Codex OAuth のアカウント型プロバイダーを再利用する
• Claude Desktop 公式モードとサードパーティプロバイダーを切り替える

Claude Desktop と Claude Code は別々のアプリ入口です。Claude Code は ~/.claude/settings.json を使い、Claude Desktop は専用の 3P profile 設定を使います。Olenro 上でも「Claude」と「Claude Desktop」として別々に表示され、アイコン右下の小さなバッジで区別できます。

対応範囲

クイックスタート

ステップ 1：Claude Desktop パネルへ切り替える

左側のアプリ切り替えから Claude Desktop を選択します。

この入口が見つからない場合は、次を確認してください。

設定 → 一般 → ホームページ表示

Claude Desktop が非表示になっていないことを確認します。

ステップ 2：プロバイダーをインポートまたは追加する

推奨：Claude Code から一括インポート

多くのユーザーはまず Claude Code 側でプロバイダーを設定し、その同じプロバイダー群を Claude Desktop に持ち込みたいはずです。Olenro の初回起動時、または Claude Desktop パネルを初めて開いたときにプロバイダーがまだない場合は、Claude Code の既存プロバイダーをインポート をクリックします。

Claude Code 側に多くのプロバイダーがすでにある場合、この機能で Claude Desktop パネルへ一括インポートできます。エンドポイント URL、API Key、デフォルトモデルを一つずつ入力し直す必要がありません。

インポートルール：

• 同じ ID のプロバイダーがすでにある場合は上書きしません
• 直接接続でき、モデル名が安全な Claude Code プロバイダーは直結モードとしてインポートされます
• モデル変換が必要なプロバイダーは、可能な場合モデルマッピングモードとしてインポートされます
• ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL は Desktop の Sonnet / Opus / Haiku マッピングに変換されます
• 旧形式の [1M] サフィックスは Claude Desktop profile の supports1m フラグに変換されます
• モデルマッピングを判断できないプロバイダーはスキップされます

インポート後は、各プロバイダーのモデルマッピングが実際のアップストリームモデルと合っているか確認してください。Kimi、DeepSeek、GLM、DouBao などの非 Claude モデルは通常、モデルマッピングモードが必要です。

すでに Claude Code でプロバイダーを設定している場合は、まず Claude Code の既存プロバイダーをインポート を使ってください。Claude Desktop へ移行する最も簡単な方法です。

インポートできる設定がない場合、または Claude Desktop 専用にプロバイダーを追加したい場合は、右上の + ボタンをクリックします。

選べる方法：

• プリセットプロバイダー：内蔵の Claude Desktop プリセットから選び、API Key だけ入力する
• カスタム設定：名前、エンドポイント URL、API Key、モデル設定を手動入力する
• Claude Desktop Official：Claude Desktop の公式サインインモードへ戻す

通常の Anthropic Messages API 互換プロバイダーでは、基本的に次の手順だけで十分です。

1. プリセットまたはカスタムプロバイダーを選ぶ
2. API Key を入力する
3. API エンドポイント を確認する
4. モデルマッピングが必要 をオフのままにする
5. 追加 をクリックする

ステップ 3：切り替えて Claude Desktop を再起動する

プロバイダーカードで 有効化 をクリックします。

切り替え後：

• 直結プロバイダー：Claude Desktop を再起動すると反映されます
• ルーティングが必要なプロバイダー：Olenro を起動したまま、Claude Desktop ローカルルーティングをオンにし、Claude Desktop を再起動します

注意：Claude Desktop は Claude Code のように設定をホットリロードしません。プロバイダーを切り替えるたびに、Claude Desktop を完全に終了して再度開く必要があります。

2 つの動作モード

直結モード

直結モードは、プロバイダー自身が Anthropic Messages API を提供しており、Claude Desktop から直接アクセスできる場合に適しています。

直結モードでは、Olenro が Claude Desktop の 3P profile をプロバイダーのエンドポイントへ向けます。

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://api.example.com",
  "inferenceGatewayAuthScheme": "bearer",
  "inferenceGatewayApiKey": "your API key"
}

適したケース：

• プロバイダーがネイティブの Anthropic Messages API を公開している
• モデル ID が claude-* または anthropic/claude-*
• 形式変換が不要
• 使用中に Olenro のローカルルーティングを起動し続ける必要がない

直結モードの「Claude Desktop モデルを手動指定」は高度な任意設定です。多くのネイティブ Claude モデルプロバイダーでは不要で、Claude Desktop が /v1/models を自動取得します。

プロバイダーの /v1/models が使えない、または返されるモデル名を Claude Desktop が認識できない場合だけ手動で追加してください。

モデルマッピングモード

モデルマッピングモードは、DeepSeek や Kimi など Claude 系列ではないモデルを提供するプロバイダー、または Olenro による API 形式変換が必要な場合に適しています。

モデルマッピングが必要 をオンにすると、Claude Desktop は Olenro のローカルゲートウェイへ接続します。

http://127.0.0.1:15721/claude-desktop

Olenro は次を担当します。

1. Claude Desktop に安全な Claude モデルルートを公開する
2. Desktop で選択したモデル役割を実際のアップストリームモデルへマッピングする
3. プロバイダーに合わせて Anthropic / OpenAI / Gemini のリクエスト形式を変換する
4. Olenro に保存されたプロバイダー認証情報でアップストリームへアクセスする

対応 API 形式：

モデルマッピングモードでは、Claude Desktop から見えるのは claude-* 形式のモデルだけです。実際のアップストリームモデル名は Claude Desktop profile に直接書き込まれません。

モデルマッピングを設定する

フィールド説明

推奨設定

Kimi を使う場合：

DeepSeek を使う場合：

理由は、現在の Claude Desktop が非 claude-* モデルを拒否するためです。そのため Olenro のルーティング機能で一度モデルマッピングを行います。

複数役割のマッピング

Sonnet、Opus、Haiku の 3 つを同時に設定できます。

プロバイダーにモデルが 1 つしかない場合は、1 つの役割だけでも構いません。モデルマッピングモードでは少なくとも 1 件の有効なマッピングが必要です。

ローカルルーティング切り替え

モデルマッピングモードでは、リクエスト変換のために Olenro ローカルルーティングが必要です。ローカルルーティングは強力ですが少し複雑な機能でもあるため、ルーティングを必要としないユーザーの誤操作を避けるために、メインページのルーティング切り替えはデフォルトで非表示です。必要なときだけ手動で表示してください。

開き方：

設定 → ルーティング → ローカルルーティング → メインページにルーティング切り替えを表示 をオン

表示スイッチをオンにしたら Claude Desktop パネルへ戻ります。メインページ右上に Claude Desktop ローカルルーティング切り替えが表示されます。

状態説明：

モデルマッピングが必要 なプロバイダーだけがローカルルーティングに依存します。直結プロバイダーではこの切り替えは不要です。

他のアプリがプロキシ接管を使用している場合、ローカルルーティングの停止がブロックされることがあります。先にルーティングサービス設定で該当アプリの接管をオフにしてから、ローカルルーティングを停止してください。

公式 Claude Desktop に戻す

Claude Desktop の公式サインインへ戻す場合：

1. Claude Desktop Official を選択する
2. 有効化 をクリックする
3. Claude Desktop を再起動する

Olenro は Claude Desktop の公式 1P モードを復元し、Olenro が管理する 3P profile を削除します。

公式モードでは API Key もローカルルーティングも不要です。

Claude Code からプロバイダーをインポートするとき、Olenro は自動的に Claude Desktop Official も追加します。

設定ファイルの場所

Olenro は Claude Desktop の 3P 設定ディレクトリに書き込みます。

macOS

~/Library/Application Support/Claude/claude_desktop_config.json
~/Library/Application Support/Claude-3p/claude_desktop_config.json
~/Library/Application Support/Claude-3p/configLibrary/_meta.json
~/Library/Application Support/Claude-3p/configLibrary/00000000-0000-4000-8000-000000157210.json

Windows

%LOCALAPPDATA%\Claude\claude_desktop_config.json
%LOCALAPPDATA%\Claude-3p\claude_desktop_config.json
%LOCALAPPDATA%\Claude-3p\configLibrary\_meta.json
%LOCALAPPDATA%\Claude-3p\configLibrary\00000000-0000-4000-8000-000000157210.json

これらのファイルは Olenro が自動管理します。手動編集はおすすめしません。設定の不整合が起きた場合は、現在のプロバイダーを再度有効化すると通常は修復できます。

ステータス表示と対処

Claude Desktop パネル上部に「Claude Desktop 設定の確認が必要です」と表示されることがあります。

よくある質問

切り替え成功と表示されたのに Claude Desktop が変わらない？

Claude Desktop を完全に終了して再起動してください。Claude Desktop は通常、起動時に 3P profile を読み込み、切り替え後に自動でホットリロードしません。

モデルマッピングプロバイダーのリクエストが失敗する？

次を確認してください。

• Olenro が起動したままになっている
• Claude Desktop ローカルルーティングがオンになっている
• プロバイダーの API Key とエンドポイント URL が正しい
• モデルマッピングにリクエストモデルが入力されている
• プロバイダー切り替え後に Claude Desktop を再起動した

Claude Desktop のモデルメニューにブランド名が表示されない？

プロバイダーを編集し、モデルマッピングの メニュー表示名 を入力してください。その後、プロバイダーを再度有効化し、Claude Desktop を再起動します。

直結モードでエラーになるのはなぜ？

直結モードでは、プロバイダーがネイティブの Anthropic Messages API を提供し、Claude Desktop が使う Claude 安全モデル名を受け入れる必要があります。プロバイダーが OpenAI、Gemini、または非 Claude モデル ID を使う場合は モデルマッピングが必要 をオンにしてください。

Olenro を閉じてもよい？

モードによります。

• 直結モード：Claude Desktop が再起動して設定を読み込んだ後は、ローカルルーティングを起動し続ける必要はありません
• モデルマッピングモード：Olenro を起動したままにし、Claude Desktop ローカルルーティングもオンにしておく必要があります

実際のアップストリームモデル名は Claude Desktop に書き込まれる？

モデルマッピングモードでは書き込まれません。Claude Desktop profile には安全な claude-* ルートと表示名だけが保存されます。実際のアップストリームモデル名は Olenro のプロバイダー設定に保存され、ローカルゲートウェイを通るリクエスト時にマッピングされます。

次のステップ

• プロバイダーの追加
• プロバイダーの切り替え
• プロキシサービス
• アプリケーション接管