# Claude Desktop 接続設定

[Claude Desktop](https://claude.com/download)は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](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms)（サンドボックス + Skills + MCP + ファイル操作）が、QCode 接続後は**Pro 契約なしで利用可能**——詳細は下記 Claude Cowork セクション
- **クォータ統合**：Claude DesktopとClaude Code、Codex CLI、Gemini CLIで同一のQCode API Keyを共用
- **充実したモデル群**：QCode.ccゲートウェイはAnthropic（Opus 5 / 4.7、Sonnet 5 / 4.6、Haiku 4.5）、OpenAI、Google Geminiの3社合計25以上のモデルを提供
- **チーム一括展開**：設定パネルからExportで設定JSONを書き出し、Jamf / Intune / Group Policyを通じてチームメンバーに配布可能

## 前提条件

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

## 設定手順

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

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

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

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

![Developer Modeの有効化](/static/images/claude-desktop/1-help-menu.png)

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

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

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

![サードパーティ推論設定への遷移](/static/images/claude-desktop/2-dev-menu.png)

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

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

![Gateway認証情報の入力](/static/images/claude-desktop/3-config.png)

| フィールド | 値 |
|------|-----|
| 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形式](/docs/getting-started/endpoints-and-api-paths)を参照してください。

## モデル一覧について

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

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

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

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

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

## チーム展開（MDM）

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

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

詳細なMDM統合ガイドは[Anthropic公式ドキュメント](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms)を参照してください。

## クォータ共有

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

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

[Claude Cowork](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms) は Claude Desktop の協調サンドボックスモードで、隔離された Linux 環境内で Claude が Skills を実行し、MCP を呼び出し、ローカルファイルを読み書きし、シェルコマンドを実行できます——PPT / Excel / PDF 処理、ファイル一括整理、コードサンドボックス系のワークフローに最適です。Cowork はこれまで主に Pro / Team プラン向けの機能でした。

> Anthropic は [Cowork とサードパーティ推論ゲートウェイの組み合わせ](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms) を公式にサポートしています。つまり本ガイドの設定が完了すれば、QCode.cc ユーザーは**Pro 契約なしで Cowork サンドボックスを利用可能**です。

### QCode 接続後にできること

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

### 境界と推奨

- **一部の connectors は Anthropic アカウントが必要**：Google Drive、Notion など上位の connector は Anthropic アカウントでのログイン設定が引き続き必要な場合があります。詳細は [公式サポートドキュメント](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms) を参照
- **モデル選択**：Cowork タスク内では `claude-opus-5` または `claude-sonnet-5` を手動選択することを推奨（`claude-opus-4-7` は販売中）。既定モデルへのフォールバックを避ける
- **初回起動**：Cowork サンドボックスは初回 runtime（数百 MB）をダウンロードしますので、起動完了までしばらくお待ちください

## 制限と差異

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

## よくある質問

### モデル選択ドロップダウンが空になる

1. base URLの末尾に`/`が**付いていない**ことを確認
2. API Keyが完全で`cr_`で始まっていることを確認
3. それでも空の場合は「モデル一覧について」の手順で`inferenceModels`をJSONに手動記述

### 401 Unauthorizedエラー

1. API Keyは`cr_`で始まり、前後に空白がないこと
2. [qcode.cc/dashboard](https://qcode.cc/dashboard)でキーが有効であることを確認
3. Gateway auth schemeはデフォルトの`bearer`のままにし、`x-api-key`に変更しないこと

### "Apply locally" と "Export" の違い

- **Apply locally**：ローカルの設定ファイルに書き込み、現在のユーザーに即時反映
- **Export**：JSONとして書き出し、チームのMDM一括配布やバックアップ用に使用

### デスクトップ版とCLIを同時に使えますか

はい、可能です。Claude DesktopとClaude Code / Codex CLIはそれぞれ独立した設定ファイルを参照します（デスクトップ版は自身のJSONを、CLIは`~/.claude/settings.json`または`~/.codex/config.toml`を読み込み）。同じQCode API Keyとクォータを共有し、互いに干渉しません。

### CC Switchとの関係は

[CC Switch](/docs/ide/cc-switch)はCLIツール（Claude Code、Codexなど）のbase URLと認証情報の切り替えを管理するもので、Claude Desktopは独自のDeveloper Modeで個別に設定します。両者は異なる形態のクライアントを対象としており、それぞれ独立して動作します。

## 次のステップ

- [接続点とAPI形式](/docs/getting-started/endpoints-and-api-paths) — QCode.ccの3プロトコル4接続ドメイン全表
- [Claude Code 完全チュートリアル](/docs/getting-started/claude-code-tutorial) — CLI側の完全な使い方
- [CC Switch 設定](/docs/ide/cc-switch) — 複数CLIのbase URLを同時に管理
- [請求について](/docs/reference/billing) — プランとクォータのルール