Claude Desktop 接続設定

Claude DesktopのDeveloper Modeで、QCode.ccをサードパーティ推論ゲートウェイとして設定し、同一のQCodeクォータを共有する

title: "Claude Desktop 接続設定" description: "Claude DesktopのDeveloper Modeで、QCode.ccをサードパーティ推論ゲートウェイとして設定し、同一のQCodeクォータを共有する"

Claude Desktop 接続設定 ¶

Claude DesktopはAnthropic公式のデスクトップアプリ（Windows / macOS / Linux）で、claude.aiのウェブ版に代わってPPT、Excel、ドキュメント、MCPワークフローなどのタスクをローカルで処理できます。最近、デスクトップ版にConfigure Third-Party Inference（サードパーティ推論）の入口が追加され、Anthropicアカウントにログインしなくても、任意のAnthropic互換ゲートウェイを推論バックエンドとして設定できるようになりました。本ガイドでは、Claude DesktopでQCode.ccを接続する方法を紹介し、Proサブスクリプションの消費を抑え、同一のQCodeクォータを共有する手順を説明します。

サードパーティAPIを使う理由 ¶

Proサブスクリプション消費の削減：デスクトップ版のPPT/Excel/MCPワークフローでQCodeプランのクォータを共有でき、Proを別途契約する必要がない
Coworkのアンロック：本来 Pro / Team プラン向けだった Claude Cowork（サンドボックス + Skills + MCP + ファイル操作）が、QCode 接続後はPro 契約なしで利用可能——詳細は下記 Claude Cowork セクション
クォータ統合：Claude DesktopとClaude Code、Codex CLI、Gemini CLIで同一のQCode API Keyを共用
充実したモデル群：QCode.ccゲートウェイはAnthropic（Opus 4.7、Sonnet 4.6、Haiku 4.5）、OpenAI、Google Geminiの3社合計25以上のモデルを提供
チーム一括展開：設定パネルからExportで設定JSONを書き出し、Jamf / Intune / Group Policyを通じてチームメンバーに配布可能

前提条件 ¶

Claude Desktopがインストール済み（公式ダウンロード、Windows / macOS / Linux）
QCode.cc API Key（cr_で始まる）を保有、ダッシュボードで取得
Windows 10/11ユーザー：初回インストール時にVirtual Machine Platformの有効化と再起動を求められる場合あり（一度きりの操作）

設定手順 ¶

ステップ1：初回起動時はログインしない ¶

ヒント：未ログイン状態では左上のメニューボタンをクリックしても反応しないことがあります。マウスでメールアドレス入力欄をクリックしてフォーカスを取得し、キーボードのTabでメニューボタンに移動してEnterで展開してください。

ステップ2：Developer Modeを有効化 ¶

メニュー → Help → Troubleshooting → Enable Developer Modeの順にクリックします。

有効化すると、上部メニューにDeveloper項目が追加されます。

ステップ3：サードパーティ推論設定を開く ¶

メニュー → Developer → Configure Third-Party Inference...の順にクリックします。

ステップ4：Gateway認証情報を入力 ¶

ConnectionセクションでGateway（Anthropic-compatible）モードを選択し、下表のとおり入力します：

Gateway認証情報の入力

フィールド	値
Gateway base URL	`https://asia.qcode.cc/api`
Gateway API key	あなたのQCode.cc API Key（`cr_`で始まる）
Gateway auth scheme	デフォルトの`bearer`のまま（QCode.ccゲートウェイはbearerとx-api-keyの両方を受け付けるため、変更不要）
Gateway extra headers	空欄のまま

base URLの末尾に/を付けないでください。Claude Desktopが自動的に/v1/messages、/v1/modelsなどのパスを連結します。

ステップ5：設定を適用 ¶

右下のApply locallyボタンをクリックします——設定がローカルに書き込まれて有効になり、モデル選択ドロップダウンにはQCode.ccが提供する25以上のモデル一覧が自動的に取得されます。メイン画面で新しい会話を開始すれば、すぐに使い始められます。

Gateway base URL の選択 ¶

注意：お住まいの地域に応じてエンドポイントを選択してください：

利用地域	Gateway base URL
中国本土（推奨）	`https://asia.qcode.cc/api`
中国本土（バックアップ）	`https://api.qcode.cc/api`
海外ユーザー	`https://api.qcode.cc/api`

完全なエンドポイント説明、プロトコルパス、地理ルーティングのルールについては接続点とAPI形式を参照してください。

モデル一覧について ¶

通常、Claude Desktopは/v1/modelsを呼び出してモデル一覧を自動取得し、ドロップダウンに完全なオプションが直接表示されます。追加の操作は不要です。

ドロップダウンが空になる場合（ごく稀な環境で発生）、手動で補完できます：

設定パネル右下のExport ▾ → ファイルマネージャーで開くをクリックし、Claude Desktopの設定JSONファイルを特定
JSONにinferenceModels配列を追加：

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://asia.qcode.cc/api",
  "inferenceGatewayApiKey": "cr_xxxxxxxx",
  "inferenceModels": [
    "claude-opus-4-7",
    "claude-sonnet-4-6",
    "claude-haiku-4-5"
  ]
}

保存後、Claude Desktopを完全に終了して再起動してください（単にウィンドウを閉じるだけでは不十分）

チーム展開（MDM）¶

設定パネル右下のExport ▾から現在の設定をJSONとしてエクスポートでき、企業MDMツールと組み合わせて一括配布することで、メンバー一人ひとりが手動で設定する手間を省けます：

macOS：Jamf / Mosyleでユーザー単位の構成プロファイルを配布
Windows：Intune / Group Policyで%APPDATA%\Claude\配下に設定をプッシュ
Linux：Ansible / Puppetで~/.config/Claude/に書き込み

詳細なMDM統合ガイドはAnthropic公式ドキュメントを参照してください。

クォータ共有 ¶

Claude DesktopはClaude Code CLI、Codex CLI、Gemini CLIと同じQCode.cc API Keyを使用し、同じプランのクォータを共有します。複数のクライアントにログインしても重複請求は発生しません。具体的な課金ルールについては請求についてを参照してください。

Claude Cowork（コラボレーションモード）¶

Claude Cowork は Claude Desktop の協調サンドボックスモードで、隔離された Linux 環境内で Claude が Skills を実行し、MCP を呼び出し、ローカルファイルを読み書きし、シェルコマンドを実行できます——PPT / Excel / PDF 処理、ファイル一括整理、コードサンドボックス系のワークフローに最適です。Cowork はこれまで主に Pro / Team プラン向けの機能でした。

Anthropic は Cowork とサードパーティ推論ゲートウェイの組み合わせを公式にサポートしています。つまり本ガイドの設定が完了すれば、QCode.cc ユーザーはPro 契約なしで Cowork サンドボックスを利用可能です。

QCode 接続後にできること ¶

Skills の実行：公式 Skills ライブラリ（PowerPoint 作成、Excel 加工、PDF 解析、画像処理など）を Cowork サンドボックスで実行、内部モデルは QCode 経由の Opus 4.7 / Sonnet 4.6
MCP ワークフロー：MCP サーバー（ローカルファイル、GitHub、カスタムツール）を Cowork に読み込み、QCode モデルと協働
ファイル / ターミナル操作：Claude がサンドボックス内でファイルの読み書きや shell コマンドの実行——テキストの整理、一括リネーム、スクリプトの実行に便利
クォータの共有：Cowork の推論は QCode プランの残量を消費し、Claude Code / Codex / Gemini CLI と同一の残高を共有

境界と推奨 ¶

一部の connectors は Anthropic アカウントが必要：Google Drive、Notion など上位の connector は Anthropic アカウントでのログイン設定が引き続き必要な場合があります。詳細は公式サポートドキュメントを参照
モデル選択：Cowork タスク内では claude-opus-4-7 または claude-sonnet-4-6 を手動選択し、既定モデルへのフォールバックを避けることを推奨
初回起動：Cowork サンドボックスは初回 runtime（数百 MB）をダウンロードしますので、起動完了までしばらくお待ちください

制限と差異 ¶

claude.aiのウェブ版は非対応：サードパーティAPIはDesktop固有の機能であり、ブラウザ版は引き続きAnthropic公式アカウントを使用します
Windowsでの初回有効化：Virtual Machine Platformの有効化と再起動を求められる場合があります（一度きり）